Como habilitar o rastreamento de pipeline
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Tópico modificado em: 2007-07-17
Este tópico explica como usar o Shell de Gerenciamento do Exchange para habilitar o rastreamento de pipeline de mensagens de email conforme elas se movem pelo pipeline de transporte em computadores que têm a função de servidor Transporte de Hub ou Transporte de Borda do Microsoft Exchange Server 2007 instalada.
Para obter mais informações sobre rastreamento de pipeline, o pipeline de transporte e os agentes de transporte no Exchange 2007, consulte os tópicos a seguir:
Rastreamento de pipeline Usando o rastreamento de pipeline para diagnosticar problemas do agente de Transporte
O pipeline de transporte no Exchange 2007 Arquitetura de Transporte
Agentes de transporte Visão geral de agentes de transporte
Dica
Não é possível administrar o rastreamento de pipeline usando o Console de Gerenciamento do Exchange. Para administrar o rastreamento de pipeline, você deve usar o Shell de Gerenciamento do Exchange. Para obter mais informações sobre como usar o Shell de Gerenciamento do Exchange, consulte Usando o Shell de Gerenciamento do Exchange.
Antes de começar
Aviso
O rastreamento de pipeline copia o conteúdo completo das mensagens de email enviadas a partir da conta configurada usando o parâmetro PipelineTracingSenderAddress no cmdlet Set-TransportServer. Para evitar exposição indesejada de informações confidenciais, você deve definir permissões de segurança apropriadas no local do arquivo de log de rastreamento do pipeline especificado pelo parâmetro PipelineTracingPath no cmdlet Set-TransportServer.
Aviso
Não habilite o rastreamento de pipeline por períodos de tempo prolongados. O rastreamento de pipeline cria arquivos de log detalhados que podem se acumular rapidamente. Monitore sempre o espaço disponível em disco quando o rastreamento de pipeline estiver habilitado.
Para executar o cmdlet Set-TransportServer em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve ser um membro do grupo Administradores local no computador.
Para executar o cmdlet Set-TransportServer, você deve usar a conta à qual esteja delegada a seguinte função:
- Função Administrador da Organização do Exchange
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.
Configurando o endereço de remetente de rastreamento do pipeline
O rastreamento de pipeline gera arquivos de log somente para mensagens de email enviadas do endereço de email SMTP que você especifica usando o parâmetro PipelineTracingSenderAddress no cmdlet Set-TransportServer. O rastreamento de pipeline não gera arquivos de log para mensagens enviadas a partir de outros endereços de email. O endereço de email SMTP especificado pode ser interno ou externo à organização do Exchange.
Se desejar gerar arquivos de log para mensagens geradas por servidores de email, como mensagens de ausência temporária, mensagens de notificação de status de entrega, relatórios de diário e outras mensagens geradas pelo sistema, você poderá especificar o valor "<>" com o parâmetro PipelineTracingSenderAddress.
Aviso
Definir o valor do parâmetro PipelineTracingSenderAddress como "<>" captura todas as mensagens geradas pelo servidor de email recebidas pelo servidor de Transporte de Hub ou de Transporte de Borda que você esteja configurando. Dependendo da quantidade de mensagens geradas pelo servidor de emails que sua organização receba, poderá ocorrer uma carga considerável sobre o servidor, e um rápido consumo do espaço em disco disponível. Monitore sempre o espaço disponível em disco quando o rastreamento de pipeline estiver habilitado.
Depois de especificar o endereço de remetente de rastreamento de pipeline, você deve habilitar o rastreamento de pipeline. Para obter mais informações, consulte a seção "Habilitando o rastreamento de pipeline" mais adiante neste tópico.
Para usar o Shell de Gerenciamento do Exchange para configurar o endereço do remetente de rastreamento de pipeline para capturar mensagens de um endereço SMTP específico
Execute o seguinte comando:
Set-TransportServer <Identity> -PipelineTracingSenderAddress <SMTPAddress>Por exemplo, para configurar o endereço SMTP chris@contoso.com como endereço de remetente de rastreamento de pipeline no computador Server1, execute o comando a seguir:
Set-TransportServer Server1 -PipelineTracingSenderAddress chris@contoso.com
Para usar o Shell de Gerenciamento do Exchange para configurar o endereço do remetente de rastreamento de pipeline para capturar mensagens geradas por servidores de email
Execute o seguinte comando:
Set-TransportServer <Identity> -PipelineTracingSenderAddress "<>"Por exemplo, para configurar <> como o endereço do remetente de rastreamento de pipeline no computador Server2, execute o comando a seguir:
Set-TransportServer Server2 -PipelineTracingSenderAddress "<>"
Para obter mais informações, consulte Usando o rastreamento de pipeline para diagnosticar problemas do agente de Transporte.
Configurando o local do diretório de log do rastreamento de pipeline
Por padrão, o diretório de log de rastreamento de pipeline está localizado em C:\Arquivos de Programas\Microsoft\Exchange Server\TransportRoles\Logs\PipelineTracing. O diretório deve estar localizado no computador do Exchange 2007.
Para utilizar o Shell de Gerenciamento do Exchange para configurar o local do log de rastreamento de pipeline
Execute o seguinte comando:
Set-TransportServer <Identity> -PipelineTracingPath <LocalFilePath>Por exemplo, para definir o local do diretório de log do rastreamento de pipeline como C:\Pipeline Tracing Logs, execute o comando a seguir:
Set-TransportServer Server1 -PipelineTracingPath "C:\Pipeline Tracing Logs"
Habilitando o rastreamento de pipeline
Por padrão, o rastreamento de pipeline está desabilitado em computadores que executam o Exchange 2007. Você pode habilitar ou desabilitar o rastreamento de pipeline em cada servidor Exchange.
Para utilizar o Shell de Gerenciamento do Exchange para habilitar o rastreamento de pipeline:
Configure o endereço de remetente de rastreamento do pipeline de acordo com a seção "Configurando o endereço de remetente de rastreamento de pipeline" anteriormente neste tópico. Você deve configurar o endereço de remetente de rastreamento de pipeline antes de habilitar o rastreamento de pipeline.
Execute o seguinte comando para habilitar o rastreamento de pipeline:
Set-TransportServer <Identity> -PipelineTracingEnabled <$True | $False>Por exemplo, para habilitar o rastreamento de pipeline no computador Server1, execute o comando a seguir:
Set-TransportServer Server1 -PipelineTracingEnabled $True
Para obter informações detalhadas de sintaxes e de parâmetros, consulte Set-TransportServer.