Set-UMIPGateway (RTM)

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-07-12

O cmdlet Set-UMIPGateway é usado para modificar as definições de configuração de um gateway IP do 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 do UM específico.

Sintaxe

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

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

Descrição detalhada

O cmdlet Set-UMIPGateway modifica as definições de configuração de um gateway IP do 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 do UM possam interromper a comunicação entre servidores de Unificação de Mensagens e o gateway IP IP PBX ou habilitado para SIP. As modificações em um objeto de Gateway IP do 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 do UM.

Para executar o cmdlet Set-UMIPGateway, você deve usar a conta à qual esteja delegado o seguinte:

Função 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 do UM que está sendo modificado. Esse parâmetro é o ID do objeto de diretório para o gateway IP do UM.
Endereço	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, central privada de comutação) habilitado para SIP (Protocolo de Início de Sessão).
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no cmdlet.
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 do UM. Esse nome para exibição é 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 do 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 do UM.

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 do UM chamado MyUMIPGateway.

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

O terceiro exemplo habilita um Gateway IP do UM para funcionar como um simulador IP/VoIP.

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