Get-TransportServer
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-TransportServer para visualizar as informações de configuração de transporte para computadores em que a função de servidor Transporte de Hub ou a função de servidor Transporte de Borda esteja instalada.
Sintaxe
Get-TransportServer [-Identity <TransportServerIdParameter>] [-DomainController <Fqdn>]
Descrição detalhada
Use o cmdlet Get-TransportServer para exibir as informações de configuração para todos os parâmetros relacionados a transporte em um servidor de Transporte de Hub ou um servidor de Transporte de Borda.
Quando você executar esse cmdlet em um servidor de Transporte de Hub, poderá especificar o servidor do qual deseja recuperar informações de configuração de transporte especificando o nome do servidor no parâmetro Identity. Se você não especificar o parâmetro Identity quando executar esse cmdlet em um servidor de Transporte de Hub, as informações de configuração de todos os servidores de Transporte de Hub serão retornadas.
Quando você executar o cmdlet Get-TransportServer em servidor de Transporte de Borda, não poderá especificar o parâmetro Identity. Esse cmdlet retorna somente as informações de configuração para o servidor de Transporte de Borda no qual esse cmdlet é executado.
O atributo ExchangeVersion que é retornado é a versão mínima do Microsoft Exchange Server 2007 que você pode usar para gerenciar o objeto retornado. Esse atributo não é igual ao da versão do Microsoft Exchange que é exibida no Console de Gerenciamento do Exchange quando você seleciona Configuração do Servidor.
Para executar o cmdlet Get-TransportServer, você deve usar uma conta à qual esteja delegada a seguinte função:
- Função de Administradores Somente para Exibição do Exchange
Para executar o cmdlet Get-TransportServer 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 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 FQDN (nome de domínio totalmente qualificado) do controlador de domínio que recupera dados do 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 em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava e lê apenas na instância local do Active Directory Application Mode (ADAM). |
Identity |
Opcional |
Microsoft.Exchange.Configuration.Tasks.TransportServerIdParameter |
Quando você usar esse parâmetro em um servidor de Transporte de Hub, o parâmetro retornará a configuração de transporte do servidor especificado. Você não pode usar esse parâmetro quando executar o comando em um servidor de Transporte de Borda. Você pode omitir o rótulo do parâmetro Identity. |
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
Os seguintes exemplos de código mostram dois comandos que usam o cmdlet Get-TransportServer.
O primeiro exemplo mostra como recuperar uma lista que contém um resumo da configuração de transporte para todos os servidores de Transporte de Hub na organização ou, se o comando for executado em um servidor de Transporte de Borda, o resumo da configuração de transporte para o servidor local.
O segundo exemplo mostra como recuperar as informações de configuração de transporte detalhadas de um servidor de Transporte de Hub comunicando por pipe a saída do cmdlet Get-TransportServer para o cmdlet Format-List.
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-TransportServer
Get-TransportServer Hub1 | Format-List