Get-UMIPGateway

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-UMIPGateway para retornar uma lista de propriedades e valores para um gateway IP de Unificação de Mensagens (UM) especificado ou uma lista de gateways IP do UM.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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

Description

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

Quando você estiver usando o cmdlet Get-UMIPGateway, não poderá inserir o endereço IP que está configurado no gateway IP de UM. Você deve usar o nome do gateway IP da UM. O nome especificado com o parâmetro Identity do cmdlet Get-UMIPGateway pode ser igual ou diferente do nome de host do gateway IP de UM, como Get-UMIPGatewayMyUMIPGateway.

Depois que essa tarefa for concluída, você pode ver a lista de propriedades e valores para um gateway IP de UM específico. Ou, se o parâmetro Identity não for usado, o cmdlet retornará uma lista de todos os gateways IP do UM na floresta.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-UMIPGateway | Format-List

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

Exemplo 2

Get-UMIPGateway -Identity MyUMIPGateway

Este exemplo mostra as propriedades de um gateway IP de UM MyUMIPGateway.

Exemplo 3

Get-UMIPGateway -IncludeSimulator $true

Este exemplo exibe todos os gateways de IP um, incluindo simuladores de gateway de IP na floresta do Active Directory.

Parâmetros

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Identity

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

Type:	UMIPGatewayIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-IncludeSimulator

A opção IncludeSimulator recupera o simulador do gateway IP de UM que está sendo exibido. Não é preciso especificar um valor com essa opção.

Um simulador permite que um cliente se conecte ao servidor de Caixa de Correio.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.