Set-UMServer
Este cmdlet está disponível apenas no Exchange Server 2010.
Use o cmdlet Set-UMServer para modificar as configurações associadas à função de servidor de Unificação de Mensagens (UM).
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-UMServer
[-Identity] <UMServerIdParameter>
[-Confirm]
[-DialPlans <MultiValuedProperty>]
[-DomainController <Fqdn>]
[-ExternalServiceFqdn <UMSmartHost>]
[-GrammarGenerationSchedule <ScheduleInterval[]>]
[-IrmLogEnabled <Boolean>]
[-IrmLogMaxAge <EnhancedTimeSpan>]
[-IrmLogMaxDirectorySize <Unlimited>]
[-IrmLogMaxFileSize <ByteQuantifiedSize>]
[-IrmLogPath <LocalLongFullPath>]
[-MaxCallsAllowed <Int32>]
[-SIPAccessService <ProtocolConnectionSettings>]
[-SipTcpListeningPort <Int32>]
[-SipTlsListeningPort <Int32>]
[-Status <ServerStatus>]
[-UMStartupMode <UMStartupMode>]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Set-UMServer define propriedades específicas em um servidor de Unificação de Mensagens. Esse cmdlet pode ser usado para definir parâmetros individuais de Unificação de Mensagens para um servidor de Unificação de Mensagens especificado.
Depois que a tarefa for concluída, o cmdlet define os parâmetros e os valores especificados.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-UMServer -Identity MyUMServer -Status NoNewCalls
Este exemplo impede que o servidor de Unificação de Mensagens MyUMServer aceite novas chamadas.
Exemplo 2
Set-UMServer -Identity MyUMServer -DialPlans $null
Este exemplo remove o servidor de Unificação de Mensagens MyUMServer de todos os planos de discagem de UM.
Exemplo 3
Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50
Este exemplo adiciona o servidor de Unificação de Mensagens MyUMServer ao plano de discagem da UM MyUMDialPlanName e também define o número máximo de chamadas de voz de entrada como 50.
Exemplo 4
Set-UMServer -Identity MyUMServer -GrammarGenerationSchedule 0.02:30-1.03:00,1.02:30-1.03:00,2.02:30-2.03:00,3.02:30-3.03:00,4.02:30-4.03:00,5.02:30-5.03:00,6.02:30-6.03:00
Este exemplo altera a agenda de geração de gramática para 02:30-03:00 todos os dias no servidor de Unificação de Mensagens MyUMServer.
Parâmetros
-Confirm
Aplicável: Exchange Server 2010
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DialPlans
Aplicável: Exchange Server 2010
O parâmetro DialPlans especifica os planos de discagem para os quais o servidor lida com chamadas de UM. Vários valores, separados por vírgulas, podem ser especificados.
Se nenhum plano de discagem for especificado, o servidor de Unificação de Mensagens não manipulará chamadas de UM.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExternalServiceFqdn
Aplicável: Exchange Server 2010
O parâmetro ExternalServiceFqdn é o FQDN ou o nome do host de um balanceador de carga que atende servidores de Unificação de Mensagens. Esse parâmetro é útil quando você está migrando servidores de Unificação de Mensagens de dentro de sua organização para um ambiente hospedado do Microsoft Exchange Server 2010. O FQDN do host de serviço externo pode conter até 2.048 caracteres.
Propriedades do parâmetro
| Tipo: | UMSmartHost |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GrammarGenerationSchedule
Aplicável: Exchange Server 2010
O parâmetro GrammarGenerationSchedule especifica os horários agendados para iniciar a geração da gramática de fala. Esse parâmetro permite apenas uma hora de início por dia. O horário agendado por padrão para a geração da gramática é de 02:00 às 02:30, horário local, diariamente.
A sintaxe para esse parâmetro é: StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]. Você pode especificar vários agendamentos separados por vírgulas: "Schedule1","Schedule2",..."ScheduleN".
Você pode usar os seguintes valores para dias:
- Nome completo do dia.
- Nome abreviado do dia.
- Inteiro de 0 a 6, em que 0 = domingo.
Você pode inserir a hora no formato de 24 horas e omitir o valor AM/PM. Se você inserir a hora no formato 12 horas, inclua um espaço entre a hora e o valor AM/PM.
Você pode misturar e combinar formatos de data/hora.
Deve haver um intervalo de pelo menos 15 minutos entre a hora de início e a hora de término. Os minutos são arredondados para baixo para 0, 15, 30 ou 45. Se mais de um intervalo for especificado, deve haver pelo menos 15 minutos entre cada intervalo.
Aqui estão alguns exemplos:
- "Dom.11:30 PM-Seg.1:30 AM"
- "6.22:00-6.22:15" (Executado de sábado às 22:00 até sábado às 22:15.)
- "Dom.1:15 AM-Monday.23:00"
- "Segunda-feira.4:30-segunda-feira.5:30","Quarta-feira.4:30-quarta-feira.5:30" (Funciona nas manhãs de segunda e quarta-feira, das 4:30 às 5:30.)
Propriedades do parâmetro
| Tipo: | ScheduleInterval[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010
O parâmetro Identity especifica o servidor de Unificação de Mensagens que você deseja modificar. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- GUID
- DN (nome diferenciado)
- ExchangeLegacyDN
Propriedades do parâmetro
| Tipo: | UMServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IrmLogEnabled
Aplicável: Exchange Server 2010
O parâmetro IrmLogEnabled especifica se o log de transações do Gerenciamento de Direitos de Informação (IRM) deve ser habilitado. O registro em log do IRM está habilitado por padrão. Os valores incluem:
- $true Habilitar o registro em log IRM
- $false Desabilitar o registro em log IRM
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogMaxAge
Aplicável: Exchange Server 2010
O parâmetro IrmLogMaxAge especifica a idade máxima para o arquivo de log do IRM. Os arquivos de log mais antigos do que o valor especificado são excluídos. O valor padrão é de 30 dias. Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss, em que d = dias, h = horas, m = minutos e s = segundos. O intervalo de entrada válido para este parâmetro é de 00:00:00 a 24855.03:14:07. A definição do valor do parâmetro IrmLogMaxAge como 00:00:00 impede a remoção automática dos arquivos de log do IRM devido à idade.
Propriedades do parâmetro
| Tipo: | EnhancedTimeSpan |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogMaxDirectorySize
Aplicável: Exchange Server 2010
O parâmetro IrmLogMaxDirectorySize especifica o tamanho máximo de todos os logs do IRM no diretório do log de conectividade. Quando um diretório atingir o tamanho máximo de arquivo, o servidor excluirá primeiro os arquivos de log mais antigos. O valor padrão é 250 megabytes (MB). Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
Valores não qualificados são tratados como bytes. O valor do parâmetro IrmLogMaxFileSize deve ser inferior ou igual ao valor do parâmetro IrmLogMaxDirectorySize. O intervalo de entrada válido para qualquer parâmetro é de 1 a 9223372036854775807 bytes. Se o valor unlimited for inserido, não será imposto um limite de tamanho ao diretório do log de conectividade.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogMaxFileSize
Aplicável: Exchange Server 2010
O parâmetro IrmLogMaxFileSizeespecifica o tamanho máximo de cada arquivo de log do IRM. Quando o tamanho máximo do arquivo de log é atingido, um novo arquivo de log é criado. O valor padrão é 10 MB. Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).
- B (bytes)
- KB (quilobytes)
- MB (megabytes)
- GB (gigabytes)
- TB (terabytes)
Valores não qualificados são tratados como bytes. O valor do parâmetro IrmLogMaxFileSize deve ser inferior ou igual ao valor do parâmetro IrmLogMaxDirectorySize. O intervalo de entrada válido para qualquer parâmetro é de 1 a 9223372036854775807 bytes. Se o valor unlimited for inserido, não será imposto um limite de tamanho aos arquivos de log do IRM.
Propriedades do parâmetro
| Tipo: | ByteQuantifiedSize |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogPath
Aplicável: Exchange Server 2010
O parâmetro IrmLogPath especifica o local padrão do diretório do log do IRM. O valor padrão é %ExchangeInstallPath%IRMLogs.
Ao definir o valor desse parâmetro como $null, o log IRM é efetivamente desabilitado. No entanto, se o valor do parâmetro IrmLogEnabled for $true, o Exchange adicionará erros ao log de eventos do aplicativo. A melhor forma de desabilitar o registro em log do IRM é definir o parâmetro IrmLogEnabled como $false.
Propriedades do parâmetro
| Tipo: | LocalLongFullPath |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MaxCallsAllowed
Aplicável: Exchange Server 2010
O parâmetro MaxCallsAllowed especifica o número máximo de chamadas de voz simultâneas que o servidor de Unificação de Mensagens permite.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SIPAccessService
Aplicável: Exchange Server 2010
O parâmetro SIPAccessService especifica a porta FQDN e TCP do local mais próximo do pool de Borda do Lync Server ou do Skype for Business Server para chamadas de entrada e saída de usuários remotos do Lync ou do Skype for Business localizados fora da rede.
Recomendamos que você sempre use esse parâmetro no Lync Server ou em implantações de Skype for Business Server que abrangem várias regiões geográficas; caso contrário, o servidor de Unificação de Mensagens poderá selecionar um pool para tráfego de mídia RTP (Protocolo de Transporte de Real-Time) que não seja o mais próximo geograficamente do usuário remoto.
Você configura esse parâmetro para cada servidor de Unificação de Mensagens para que o valor identifique o pool de Borda do Lync Server ou o pool de Borda do Skype for Business Server mais próximo do servidor Exchange.
Propriedades do parâmetro
| Tipo: | ProtocolConnectionSettings |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SipTcpListeningPort
Aplicável: Exchange Server 2010
O parâmetro SipTcpListeningPort especifica a porta TCP usada pelo servidor de Unificação de Mensagens para receber chamadas de entrada. Essa porta TCP é usada por servidores de Unificação de Mensagens adicionados a um plano de discagem de UM que não está configurado para usar o modo SIP Protegido ou Seguro. O padrão é a porta 5060.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SipTlsListeningPort
Aplicável: Exchange Server 2010
O parâmetro SipTlsListeningPort especifica a porta TLS (Transport Layer Security) usada pelo servidor de Unificação de Mensagens para receber chamadas de entrada. Essa porta TLS é usada por servidores de Unificação de Mensagens adicionados a um plano de discagem de UM configurado para usar o modo SIP Seguro ou Seguro. O padrão é a porta 5061.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Status
Aplicável: Exchange Server 2010
O parâmetro Status especifica o status do servidor de Unificação de Mensagens. As opções disponíveis são Enabled, Disabled e NoNewCalls.
Propriedades do parâmetro
| Tipo: | ServerStatus |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UMStartupMode
Aplicável: Exchange Server 2010
O parâmetro UMStartupMode especifica o modo de inicialização para o serviço de Unificação de Mensagens do Microsoft Exchange em um servidor Exchange. Os valores válidos são:
- TCP
- TLS
- Dual: use esse valor para adicionar o servidor de Unificação de Mensagens aos planos de discagem da UM com configurações de segurança diferentes. O servidor de Unificação de Mensagens pode escutar nas portas 5060 e 5061 ao mesmo tempo.
Se você alterar o modo de inicialização, precisará reiniciar o serviço de Unificação de Mensagens do Microsoft Exchange.
Propriedades do parâmetro
| Tipo: | UMStartupMode |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.