Compartilhar via

Gerenciar agentes de transporte em Exchange Server

  • Artigo

Os agentes de transporte usam eventos SMTP para operar em mensagens à medida que as mensagens se movem pelo pipeline de transporte. A maioria dos agentes de transporte internos incluídos com Microsoft Exchange Server 2016 ou 2019 são invisíveis e incontroláveis. No entanto, você pode instalar e configurar agentes de transporte de terceiros em servidores do Exchange em sua organização. Para obter mais informações sobre agentes de transporte, consulte Agentes de transporte em Exchange Server.

Do que você precisa saber para começar?

  • Tempo estimado para finalizar cada procedimento: 10 minutos

  • Para executar este procedimento ou estes procedimentos, você precisa receber permissões. Para ver quais permissões você precisa, consulte a entrada "Agentes de transporte" no tópico Permissões de fluxo de email.

  • Você só pode usar o Shell de Gerenciamento do Exchange para executar esse procedimento.

  • Para informações sobre atalhos de teclado que possam se aplicar aos procedimentos neste tópico, confira Atalhos de teclado no Centro de Administração do Exchange.

Dica

Está com problemas? Peça ajuda nos fóruns do Exchange. Visite os fóruns em: Exchange Server.

Use o Shell de Gerenciamento do Exchange para instalar um agente de transporte

Quando você instala um agente de transporte, o Exchange registra apenas as DLLs associadas ao agente de transporte. Você precisa garantir que todos os arquivos, chaves de registro e outros objetos dos quais o agente de transporte depende estejam instalados corretamente e configurados. Depois que o Exchange carrega as DLLs, ele continua a referenciar as DLLs após a conclusão do comando.

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. Os agentes de transporte que são instáveis ou contêm falhas de segurança podem afetar a estabilidade e a segurança do Exchange. Portanto, você só deve instalar agentes de transporte de confiança total e que foram totalmente testados em um ambiente de teste.

Os agentes de transporte são instalados em um estado desabilitado para garantir que o fluxo de email não seja afetado por agentes de transporte que não foram configurados. Portanto, depois que um agente de transporte tiver sido configurado corretamente, você precisará habilitar o agente de transporte.

Use a sintaxe a seguir para instalar um agente de transporte.

Install-TransportAgent -Name <TransportAgentIdentity> -TransportAgentFactory <"TransportAgentFactory"> -AssemblyPath <"FilePath">

Este exemplo instala um agente de transporte fictício chamado Agente de Transporte contoso no serviço de transporte.

Install-TransportAgent -Name "Contoso Transport Agent" -TransportAgentFactory "vendor.exchange.ContosoTransportAgentfactory" -AssemblyPath "C:\Program Files\Vendor\TransportAgent\ContosoTransportAgentFactory.dll"

Como saber se funcionou?

Para verificar se você instalou com êxito o agente de transporte, execute o comando Get-TransportAgent e confirme se o agente de transporte está listado.

Usar o Shell de Gerenciamento do Exchange para habilitar um agente de transporte

Use a sintaxe a seguir para habilitar um agente de transporte.

Enable-TransportAgent <TransportAgentIdentity>

Este exemplo permite o agente de transporte chamado Agente de Transporte Contoso no serviço de transporte.

Enable-TransportAgent "Contoso Transport Agent"

Como saber se funcionou?

Para verificar se você habilitou com êxito um agente de transporte, execute o comando Get-TransportAgent | Format-List Name,Enabled e confirme se o agente de transporte está habilitado.

Usar o Shell de Gerenciamento do Exchange para desabilitar um agente de transporte

Use a seguinte sintaxe para desabilitar um agente de transporte:

Disable-TransportAgent <TransportAgentIdentity>

Este exemplo desabilita o agente de transporte chamado Fabrikam Transport Agent no serviço de transporte.

Disable-TransportAgent "Fabrikam Transport Agent"

Como saber se funcionou?

Para verificar se você desabilitou com êxito um agente de transporte, execute o comando Get-TransportAgent | Format-List Name,Enabled e confirme se o agente de transporte está desabilitado.

Usar o Shell de Gerenciamento do Exchange para exibir agentes de transporte

Para exibir uma lista de resumo de agentes de transporte, execute o seguinte comando:

Get-TransportAgent

Para exibir a configuração detalhada de um agente de transporte específico, execute o seguinte comando:

Get-TransportAgent <TransportAgentIdentity> | Format-List

Este exemplo fornece uma configuração detalhada do agente de transporte chamado Agente de Regra de Transporte.

Get-TransportAgent "Transport Rule Agent" | Format-List

Use o Shell de Gerenciamento do Exchange para configurar a prioridade de um agente de transporte

Os agentes de transporte com prioridade mais próxima de 0 processam primeiro as mensagens de email. No entanto, o evento SMTP no pipeline de transporte em que o agente de transporte está registrado pode fazer com que um agente de menor prioridade atue na mensagem antes de um agente de maior prioridade.

Para modificar a prioridade de um agente de transporte existente, execute o seguinte comando:

Set-TransportAgent <TransportAgentIdentity> -Priority <Integer>

Este exemplo define o valor do agente prioritário de 3 para o agente de transporte existente chamado Agente de Transporte contoso no serviço de transporte.

Set-TransportAgent "Contoso Transport Agent" -Priority 3

Como saber se funcionou?

Para verificar se você configurou com êxito a prioridade de um agente de transporte, execute o comando Get-TransportAgent | Format-List Name,Priority e confirme o valor de prioridade do agente de transporte.

Use o Shell de Gerenciamento do Exchange para desinstalar um agente de transporte

Quando o agente de transporte é desinstalado, o Exchange cancela o registro dos arquivos DLL usados com o agente. O Exchange não remove arquivos, chaves de registro ou outros objetos adicionados pela instalação do agente de transporte.

Para desinstalar um agente de transporte, execute o seguinte comando:

Uninstall-TransportAgent <TransportAgentIdentity>

Este exemplo desinstala o agente de transporte chamado Fabrikam Transport Agent do serviço de transporte.

Uninstall-TransportAgent "Fabrikam Transport Agent"

Como saber se funcionou?

Para verificar se você desinstalou com êxito o agente de transporte, execute o comando Get-TransportAgent e verifique se o agente de transporte não está listado.