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