Install-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 Install-TransportAgent para registrar um agente de transporte em um computador em que a função de servidor Transporte de Borda ou Transporte de Hub esteja instalada em uma organização do Microsoft Exchange Server 2007.
Sintaxe
Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Install-TransportAgent é usado para registrar o agente de transporte para ser usado em um servidor de Transporte de Borda ou Transporte de Hub.
Aviso
Os agentes de transporte têm acesso total a todas as mensagens de email que encontrarem. O Exchange não faz restrições ao comportamento de um agente de transporte. Agentes de transporte instáveis ou que contenham falhas na segurança podem afetar a estabilidade e a segurança do Exchange. Por isso, você deve instalar apenas os agentes de transporte nos quais confia plenamente e que foram amplamente testados em um ambiente de teste.
Para executar o cmdlet Install-TransportAgent, você deve usar uma conta à qual esteja delegado o seguinte:
- Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino
Para executar o cmdlet Install-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 | Tipo | Descrição |
|---|---|---|---|
AssemblyPath |
Necessário |
System.String |
Esse parâmetro especifica o local do assembly do Microsoft .NET do agente de transporte. Os caminhos de arquivos UNC (Convenção de Nomenclatura Universal) não podem ser usados. |
Name |
Necessário |
System.String |
Este parâmetro especifica o nome para exibição do agente de transporte a ser instalado. O tamanho do nome não pode exceder 64 caracteres. |
TransportAgentFactory |
Necessário |
System.String |
Esse parâmetro especifica o tipo de classe do Microsoft .NET da fábrica do agente de transporte. O desenvolvedor do agente de transporte que está sendo instalado fornece a fábrica do agente de transporte e informações relacionadas. Para obter mais informações, consulte a documentação fornecida pelo desenvolvedor do agente de transporte. |
Confirm |
Optional |
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 |
Optional |
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. |
WhatIf |
Optional |
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 um aplicativo antivírus fictício é instalado em um servidor de Transporte de Borda ou de Transporte de Hub.
Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"