Compartilhar via


Set-UMIPGateway

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-07-17

O cmdlet Set-UMIPGateway é usado para modificar as definições de configuração de um gateway IP de UM (Unificação de Mensagens) único ou para retornar uma lista de definições de configuração que possam ser modificadas em um gateway IP de UM específico.

Sintaxe

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-UMIPGateway modifica as definiçoes de configuraçao de um gateway IP de UM específico, por exemplo, o endereço IP para o gateway IP. Essas modificações incluem a permissão de chamadas de saída e o controle de comunicação com um gateway IP PBX ou IP habilitado para SIP.

Importante

É possível que essas modificações nas configurações de gateway IP de UM possam interromper a comunicação entre servidores de Unificação de Mensagens e o gateway IP ou IP/PBX habilitado para SIP. As modificações em um objeto de Gateway IP de UM devem apenas ser realizadas por um administrador que compreenda completamente as implicações de fazer alterações na configuração para o gateway IP de UM.

Para executar o cmdlet Set-UMIPGateway, você deve usar uma conta à qual esteja delegada a função de Administrador da Organização do Exchange.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Esse parâmetro especifica o identificador para o gateway de IP de UM que está sendo modificado. Esse parâmetro é o ID do objeto de diretório para o gateway IP de UM.

Address

Opcional

Microsoft.Exchange.Data.UMSmartHost

Esse parâmetro especifica o endereço IP que está configurado no gateway IP ou IP-PBX (Private Branch eXchange) habilitado para SIP.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é $true.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório Active Directory.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway

Este parâmetro especifica o parâmetro de entrada que representa um novo gateway IP.

Name

Opcional

System.String

Este parâmetro especifica o nome para exibição que será usado para o gateway IP de UM. Esse nome para exibiçao é limitado a 64 caracteres.

OutcallsAllowed

Opcional

System.Boolean

Este parâmetro especifica se este objeto de Gateway IP pode ser usado para chamadas de saída. Ele não controla transferências de chamada.

Port

Opcional

System.Int32

Esse parâmetro especifica a porta IP em que o gateway IP ou IP PBX está atendendo. Por padrão, é a porta 5060. O intervalo para esse parâmetro é de 0 a 65.535.

Simulator

Opcional

System.Boolean

Este parâmetro especifica o simulador que será usado para o gateway IP de UM que está sendo exibido. Um simulador permite que um cliente se conecte ao servidor de Unificação de Mensagens. Essa conexão geralmente é usada no aplicativo Telefone de Teste do Exchange.

Status

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus

Esse parâmetro especifica se deve habilitar ou desabilitar o gateway IP de UM.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar o parâmetro WhatIf, o administrador poderá visualizar quais alteraçoes ocorrerao sem precisar aplicar nenhuma dessas alteraçoes. O valor padrão é $true.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo de código altera o endereço IP de um gateway IP de UM chamado MyUMIPGateway.

O segundo exemplo de código impede que um gateway IP de UM aceite chamadas de entrada e impede chamadas de saída.

O terceiro exemplo habilita o gateway IP de UM a funcionar como um simulador do gateway IP e pode ser usado com o cmdlet Test-UMConnectivity ou o aplicativo Telefone de Teste de UM do Exchange.

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true