Set-UmServer

Esse cmdlet só está disponível no Exchange Server 2010.

Use o cmdlet Set-UMServer para modificar as configurações associadas à função de servidor UM (Unified Messaging).

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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 Mensagens Unificadas. Esse cmdlet pode ser usado para definir parâmetros individuais de Mensagens Unificadas para um servidor de Mensagens Unificadas 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 tópico 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 mensagens unificadas MyUMServer aceite novas chamadas.

Exemplo 2

Set-UMServer -Identity MyUMServer -DialPlans $null

Este exemplo remove o servidor de mensagens unificadas MyUMServer de todos os planos de discagem um.

Exemplo 3

Set-UMServer -Identity MyUMServer -DialPlans MyUMDialPlanName -MaxCallsAllowed 50

Este exemplo adiciona o servidor de mensagens unificadas MyUMServer ao plano de discagem da UM MyUMDialPlanName e também define o número máximo de chamadas de voz de entrada para 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 Mensagens Unificadas MyUMServer.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-DialPlans

O parâmetro DialPlans especifica todos os planos de discagem para os quais esse servidor lidará com chamadas um. Se nenhum plano de discagem for definido, o servidor de Mensagens Unificadas não tratará chamadas de UM.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ExternalServiceFqdn

O parâmetro ExternalServiceFqdn é o nome FQDN ou host de um balanceador de carga que atende servidores de Mensagens Unificadas. Esse parâmetro é útil quando você está migrando servidores de Mensagens Unificadas de dentro de sua organização para um ambiente hospedado Microsoft Exchange Server 2010. O FQDN do host de serviço externo pode conter até 2.048 caracteres.

Type:UMSmartHost
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GrammarGenerationSchedule

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 deste 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 por dias:

  • Nome completo do dia.
  • Nome abreviado do dia.
  • Inteiro de 0 a 6, onde 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 de 12 horas, inclua um espaço entre a hora e o valor AM/PM.

Você pode misturar e corresponder 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 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" (Executar de sábado às 22:00 até sábado às 22:15.)
  • "Dom.1:15-Monday.23:00"
  • "Segunda-feira.4:30 am-monday.5:30","Quarta-feira.4:30 am-wednesday.5:30 AM" (Executar nas manhãs de segunda e quarta-feira das 4:30 até 5:30.)
Type:ScheduleInterval[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Identity

O parâmetro Identidade especifica o servidor de Mensagens Unificadas que você deseja modificar. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • GUID
  • DN (nome diferenciado)
  • ExchangeLegacyDN
Type:UMServerIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogEnabled

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 do IRM
  • $false Desabilitar o registro em log de IRM
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogMaxAge

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 valor 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.

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogMaxDirectorySize

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogMaxFileSize

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.

Type:ByteQuantifiedSize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogPath

O parâmetro IrmLogPath especifica o local padrão do diretório do log do IRM. O valor padrão é C:\Arquivos do Programa\Microsoft\Exchange Server\V14. Ao definir o valor do parâmetro IrmLogPath como $null, o log de conectividade é efetivamente desabilitado. No entanto, se você definir o valor do parâmetro IrmLogPath como $null quando o valor do atributo IrmLogEnabled for $true, o Exchange registrará erros no log de eventos do aplicativo. A maneira preferida de desabilitar o registro em log do IRM é definir o parâmetro IrmLogEnabled como $false.

Type:LocalLongFullPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MaxCallsAllowed

O parâmetro MaxCallsAllowed especifica o número máximo de chamadas de voz simultâneas que o servidor de Mensagens Unificadas permite.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SIPAccessService

O parâmetro SIPAccessService especifica a porta FQDN e TCP do pool mais próximo do Lync Server Edge ou Skype for Business Server local do pool do Edge para chamadas de entrada e saída do Lync remoto ou Skype for Business usuários localizados fora da rede.

Recomendamos que você sempre use esse parâmetro no Lync Server ou Skype for Business Server implantações que abrangem várias regiões geográficas; caso contrário, o servidor de Mensagens Unificadas pode selecionar um pool para o tráfego de mídia RTP (Protocolo de Transporte Real-Time) que não seja o mais próximo geograficamente do usuário remoto.

Você configura esse parâmetro para cada servidor de Mensagens Unificadas para que o valor identifique o pool mais próximo do Lync Server Edge ou Skype for Business Server pool do Edge para o servidor exchange.

Type:ProtocolConnectionSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SipTcpListeningPort

O parâmetro SipTcpListeningPort especifica a porta TCP usada pelo servidor de Mensagens Unificadas para receber chamadas recebidas. Essa porta TCP é usada por servidores de Mensagens Unificadas adicionados a um plano de discagem um que não está configurado para usar o modo SIP Protegido ou Protegido. O padrão é a porta 5060.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-SipTlsListeningPort

O parâmetro SipTlsListeningPort especifica a porta TLS (Transport Layer Security) usada pelo servidor de Mensagens Unificadas para receber chamadas recebidas. Essa porta TLS é usada por servidores de Mensagens Unificadas que são adicionados a um plano de discagem um configurado para usar o modo SIP Protegido ou Protegido. O padrão é a porta 5061.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Status

O parâmetro Status especifica o status do servidor de Mensagens Unificadas. As opções disponíveis são Habilitados, Desabilitados e NoNewCalls.

Type:ServerStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-UMStartupMode

O parâmetro UMStartupMode especifica se o serviço de Mensagens Unificadas do Exchange Microsoft em um servidor de Mensagens Unificadas será iniciado no modo TCP, TLS ou Dual. Se o servidor de Mensagens Unificadas estiver sendo adicionado aos planos de discagem um que têm configurações de segurança diferentes, você deverá escolher o modo Dual. No modo Dual, o servidor de Mensagens Unificadas pode escutar nas portas 5060 e 5061 ao mesmo tempo. Se o modo de inicialização for alterado, o serviço de Mensagens Unificadas do Exchange Microsoft deverá ser reiniciado.

Type:UMStartupMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

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.