Gerenciar agentes de transporte

  • Artigo

Aplica-se a: Exchange Server 2013

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 2013 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 mais informações sobre agentes de transporte, consulte Agentes de transporte.

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 para executar esse procedimento.

  • O suporte para agentes de transporte herdados não está habilitado por padrão, mas você pode habilitá-lo. Para obter instruções, consulte Habilitar suporte para agentes de transporte herdados.

  • 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 no Exchange Server.

Sobre os procedimentos do agente de transporte no serviço de transporte front-end em servidores de acesso ao cliente

Você não pode usar o Shell de Gerenciamento do Exchange para gerenciar o agente de transporte no serviço de transporte front-end em um servidor de Acesso ao Cliente. Em vez disso, você precisa abrir Windows PowerShell no servidor de Acesso ao Cliente e importar os cmdlets do Exchange para a sessão Windows PowerShell.

Aviso

Não há suporte para executar cmdlets do Exchange em Windows PowerShell para tarefas diferentes do gerenciamento de agentes de transporte no serviço de transporte front-end. Há sérias consequências que podem resultar se você ignorar o SHELL de Gerenciamento do Exchange e o RBAC (controle de acesso baseado em função) executando cmdlets do Exchange em Windows PowerShell. Você sempre deve executar cmdlets do Exchange no Shell de Gerenciamento do Exchange. Para obter mais informações, consulte Notas de versão do Exchange 2013.

Para executar qualquer um dos procedimentos do Agente de Transporte descritos neste tópico no serviço de Transporte front-end, você precisa executar as seguintes etapas adicionais:

  1. No servidor de Acesso ao Cliente, abra Windows PowerShell e execute o seguinte comando:

    Add-PSSnapin Microsoft.Exchange.Management.PowerShell.SnapIn

  2. Execute o comando conforme descrito, mas adicione o seguinte valor ao comando: -TransportService FrontEnd.

    Por exemplo, para exibir os agentes de transporte no serviço de transporte front-end em um servidor de Acesso ao Cliente, execute o seguinte comando:

    Get-TransportAgent -TransportService FrontEnd

Usar o Shell 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 encontradas. 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 em um servidor de caixa de correio.

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 verifique se o agente de transporte está listado.

Usar o Shell 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 em um servidor de caixa de correio.

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 verifique se o agente de transporte está habilitado.

Use o Shell 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 Fabirkam Transport Agent no serviço de transporte em um servidor de caixa de correio.

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 verifique se o agente de transporte está desabilitado.

Usar o Shell 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 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 em um servidor de caixa de correio.

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 verifique o valor de prioridade do agente de transporte.

Usar o Shell 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 em um servidor de caixa de correio.

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.