Compartilhar via


Get-UMIPGateway

 

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

Tópico modificado em: 2007-08-08

O cmdlet Get-UMIPGateway retorna uma lista de propriedades e valores para um gateway IP do UM especificado ou uma lista de gateways IP do UM.

Sintaxe

Get-UMIPGateway [-Identity <UMIPGatewayIdParameter>] [-DomainController <Fqdn>] [-IncludeSimulator <SwitchParameter>]

Descrição detalhada

O cmdlet Get-UMIPGateway exibe as propriedades e os valores para um gateway IP do UM especificado, como o nome para exibição, o endereço IP, o status e as configurações de chamada de saída. Se nenhum parâmetro for especificado, serão retornados todos os gateways IP do UM na floresta do Active Directory.

Para executar o cmdlet Get-UMIPGateway, você deve usar uma conta à qual esteja delegada a função Administrador Somente para Exibição do Exchange.

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

Parâmetros

Parâmetro Necessário Tipo Descriçã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.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

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

IncludeSimulator

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro recupera o simulador do 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 com o aplicativo Telefone de Teste do UM do Exchange.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo exibe uma lista formatada de todos os gateways IP do UM na floresta do Active Directory.

O segundo exemplo exibe as propriedades de um gateway IP do UM chamado MyUMIPGateway.

O terceiro exemplo exibe todos os gateways IP do UM, inclusive os simuladores de gateway IP da floresta do Active Directory.

Get-UMIPGateway |format-list

Get-UMIPGateway -Identity MyUMIPGateway

Get-UMIPGateway -IncludeSimulator $true