Set-UMIPGateway

Artigo
09/30/2014

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

Exceçõ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

Compartilhar via