Get-TransportAgent
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-06-28
Use o cmdlet Get-TransportAgent para exibir a configuração de um agente de transporte em um computador em que a função de servidor Transporte de Borda ou a função de servidor Transporte de Hub esteja instalada em uma organização do Microsoft Exchange Server 2007.
Sintaxe
Get-TransportAgent [-Identity <String>] [-DomainController <Fqdn>]
Descrição detalhada
O cmdlet Get-TransportAgent é usado para exibir a configuração de um agente de transporte em um servidor de Transporte de Borda ou servidor de Transporte de Hub.
Para executar o cmdlet Get-TransportAgent, você deve usar a conta à qual esteja delegado o seguinte:
- Função de Administrador Somente para Exibição do Exchange
Para executar o cmdlet Get-TransportAgent em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.
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 (FQDN) 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 comando. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda lê e grava apenas na instância local do ADAM. |
Identity |
Opcional |
System.String |
Esse parâmetro especifica o nome para exibição do agente de transporte a ser exibido. O tamanho do nome não pode exceder 64 caracteres. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
Exceções
| Exceções | Descrição |
|---|---|
Exemplo
O primeiro exemplo mostra como exibir uma lista resumida de todos os agentes de transporte instalados no servidor de Transporte de Borda ou servidor de Transporte de Hub.
O segundo exemplo mostra como exibir informações sobre um agente de transporte específico em formato de lista. O comando Get-TransportAgent é canalizado para o comando Format-List para exibir a configuração detalhada da regra de transporte especificada.
Para obter mais informações sobre pipeline, consulte Pipelining.
Para obter mais informações sobre como trabalhar com a saída de um comando, consulte Trabalhando com saída do comando.
Get-TransportAgent
Get-TransportAgent -Identity "Edge Rule Agent" | Format-List