Set-TransportAgent

 

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

Tópico modificado em: 2007-07-27

Use o cmdlet Set-TransportAgent para modificar um agente de transporte em um computador em que a função de servidor Transporte de Borda ou de Transporte de Hub esteja instalada, em uma organização do Microsoft Exchange Server 2007.

Sintaxe

Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Set-TransportAgent é usado para modificar um agente de transporte em um servidor de Transporte de Borda ou de Transporte de Hub.

Para executar o cmdlet Set-TransportAgent, você deve usar uma conta à qual esteja delegado o seguinte:

• Função Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para executar o cmdlet Set-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 2007, consulte Considerações sobre permissão. 

Parâmetros

Parâmetro	Necessário(s)	Tipo	Descrição
Identity	Necessário(s)	System.String	Use este parâmetro para especificar o nome para exibição do agente de transporte a ser modificado. O tamanho do nome não pode exceder 64 caracteres.
Confirm	Opcional	System.Management.Automation.SwitchParameter	O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o FQDN (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 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.
Priority	Opcional	System.Nullable	Use esse parâmetro para especificar a prioridade do agente de transporte. A prioridade do agente de transporte controla a ordem em que os agentes de transporte processam mensagens de email. A prioridade deve ser um valor entre 0 e o número máximo de agentes de transporte. O comportamento padrão é anexar um novo agente de transporte ao fim da lista de prioridades. Os agentes de transporte com prioridade mais próxima de 0 processam mensagens de email primeiro.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O exemplo a seguir mostra como a prioridade de um agente de antivírus fictício será modificada.

Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3