Set-UMService

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-UMService para modificar as propriedades do serviço de Unificação de Mensagens do Microsoft Exchange em servidores de Caixa de Correio do Exchange 2013 ou Exchange 2016.

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

Sintaxe

Default (Default)

Set-UMService
    [-Identity] <UMServerIdParameter>
    [-Confirm]
    [-DialPlans <MultiValuedProperty>]
    [-DomainController <Fqdn>]
    [-GrammarGenerationSchedule <ScheduleInterval[]>]
    [-IPAddressFamily <IPAddressFamily>]
    [-IPAddressFamilyConfigurable <Boolean>]
    [-IrmLogEnabled <Boolean>]
    [-IrmLogMaxAge <EnhancedTimeSpan>]
    [-IrmLogMaxDirectorySize <Unlimited>]
    [-IrmLogMaxFileSize <ByteQuantifiedSize>]
    [-IrmLogPath <LocalLongFullPath>]
    [-MaxCallsAllowed <Int32>]
    [-SIPAccessService <ProtocolConnectionSettings>]
    [-Status <ServerStatus>]
    [-UMStartupMode <UMStartupMode>]
    [-WhatIf]
    [<CommonParameters>]

Description

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-UMService -Identity MyUMServer -IPAddressFamily Any -UMStartupMode Dual

Este procedimento realiza as seguintes ações:

  • Habilita o serviço de Unificação de Mensagens do Microsoft Exchange no servidor de Acesso para Cliente, para aceitar pacotes de dados IPv4 e IPv6.
  • Habilita o serviço de Unificação de Mensagens do Microsoft Exchange no servidor de Caixa de Correio chamado MyUMServer a se iniciar usando os modos TCP e TLS.

Exemplo 2

Set-UMService -Identity MyUMServer -DialPlans $null

Este exemplo remove o servidor de Caixa de Correio MyUMServer de todos os planos de discagem de UM.

Exemplo 3

Set-UMService -Identity MyUMServer -DialPlans MySIPDialPlan -MaxCallsAllowed 50 -SipAccessService northamerica.lyncpoolna.contoso.com:5061 -UMStartupMode TLS

Este procedimento realiza as seguintes ações:

  • Adiciona o servidor de Caixa de Correio MyUMServer ao plano de discagem de UM MySIPDialPlan.
  • Define o número máximo de chamadas de entrada para 50.
  • Define northamerica.lyncpoolna.contoso.com:5061 como o FQDN e a porta para o serviço de acesso SIP usado pelo Microsoft Lync Server ou Skype for Business Server para chamadas de entrada e saída de clientes remotos do Lync ou Skype for Business.
  • Habilita o serviço de Unificação de Mensagens do Microsoft Exchange no servidor de Caixa de Correio chamado MyUMServer a se iniciar no modo TLS.

Parâmetros

-Confirm

Aplicável: Exchange Server 2013, Exchange Server 2016

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 2013, Exchange Server 2016

O parâmetro DialPlans especifica todos os planos de discagem para os quais o serviço de Unificação de Mensagens lida com chamadas de entrada.

Os servidores do Exchange 2016 e do Exchange 2013 não podem ser associados a um plano de discagem de UM TelExt ou E.164, mas podem ser associados ou adicionados a planos de discagem SIP. Se você estiver integrando a Unificação de Mensagens com o Lync Server 2010, o Lync Server 2013 ou o Skype for Business Server 2015, será necessário associar ou adicionar todos os servidores do Exchange 2016 e do Exchange 2013 aos planos de discagem SIP.

Você também pode usar esse parâmetro para associar servidores de Unificação de Mensagens do Exchange 2010 a um plano de discagem de UM.

Para inserir vários valores e substituir as entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

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 2013, Exchange Server 2016

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

-GrammarGenerationSchedule

Aplicável: Exchange Server 2013, Exchange Server 2016

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 2013, Exchange Server 2016

O parâmetro Identity especifica o servidor de Caixa de Correio que hospeda a configuração do serviço de Unificação de Mensagens que você deseja modificar. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • ExchangeLegacyDN
  • GUID

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

-IPAddressFamily

Aplicável: Exchange Server 2013, Exchange Server 2016

O parâmetro IPAddressFamily especifica a versão do protocolo IP (IP) a ser usada. Os valores válidos são:

  • IPv4Only: o gateway IP da UM usa apenas IPv4 para se comunicar.
  • IPv6Only: o gateway IP da UM usa somente IPv6.
  • Qualquer: o IPv6 é usado primeiro. Se o IPv6 não estiver disponível, o IPV4 será usado. Esse valor é o padrão.

Propriedades do parâmetro

Tipo:IPAddressFamily
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

-IPAddressFamilyConfigurable

Aplicável: Exchange Server 2013, Exchange Server 2016

O parâmetro IPAddressFamilyConfigurable especifica se você pode definir o parâmetro IPAddressFamily como IPv6Only ou Any. O padrão é $true.

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

-IrmLogEnabled

Aplicável: Exchange Server 2013, Exchange Server 2016

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 válidos são:

  • $true: Habilitar 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 2013, Exchange Server 2016

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 período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = 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 2013, Exchange Server 2016

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 normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

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 2013, Exchange Server 2016

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 normalmente são tratados como bytes, mas valores pequenos podem ser arredondados para cima para o kilobyte mais próximo.

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 2013, Exchange Server 2016

O parâmetro IrmLogPath especifica o local padrão do diretório do log do IRM. O local 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 2013, Exchange Server 2016

O parâmetro MaxCallsAllowed especifica o número máximo de chamadas de voz simultâneas permitidas pelo serviço da Unificação de Mensagens. O valor padrão é 100.

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 2013, Exchange Server 2016

O parâmetro SIPAccessService especifica as portas FQDN e TCP do local mais próximo do pool de Front-Ends 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 serviço de Unificação de Mensagens do Microsoft Exchange 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 instância do serviço de Unificação de Mensagens (cada servidor Exchange) para que o valor identifique o pool de Front-Ends do Lync Server ou o pool de Front-Ends 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

-Status

Aplicável: Exchange Server 2013, Exchange Server 2016

Esse parâmetro foi preterido e não é mais usado.

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 2013, Exchange Server 2016

O parâmetro UMStartupMode especifica o modo de inicialização do serviço de Unificação de Mensagens. Os valores válidos são:

  • TCP (valor padrão)
  • TLS
  • Dual: o serviço pode escutar nas portas 5060 e 5061 ao mesmo tempo. Se você adicionar o servidor Exchange a planos de discagem de UM com configurações de segurança diferentes, deverá usar esse valor.

Se você alterar o valor do parâmetro, será necessário reiniciar o serviço de Unificação de Mensagens.

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 2013, Exchange Server 2016

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.