Get-MessageTrackingLog
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Get-MessageTrackingLog para pesquisar informações de entrega de mensagens que estão armazenadas no log de acompanhamento de mensagens.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Get-MessageTrackingLog
[-DomainController <Fqdn>]
[-End <DateTime>]
[-EventId <String>]
[-InternalMessageId <String>]
[-MessageId <String>]
[-MessageSubject <String>]
[-Recipients <String[]>]
[-Reference <String>]
[-ResultSize <Unlimited>]
[-Sender <String>]
[-Server <ServerIdParameter>]
[-Start <DateTime>]
[-NetworkMessageId <String>]
[-Source <String>]
[-TransportTrafficType <String>]
[<CommonParameters>]
Description
Existe um log de controle de mensagens exclusivo para o serviço de Transporte em um servidor de Caixa de Correio, para o serviço de Transporte de Caixa de Correio em um servidor de Caixa de Correio e em um servidor de Transporte de Borda. O log de acompanhamento de mensagens é um arquivo CSV (valor separado por vírgula) que contém informações detalhadas sobre o histórico de cada email conforme ele percorre um servidor Exchange.
Os nomes dos campos mostrados nos resultados do cmdlet Get-MessageTrackingLog são similares aos nomes de campos reais usados nos logs de acompanhamento de mensagens. As diferenças são:
- Os traços são removidos dos nomes de campo. Por exemplo, internal-message-id é exibido como InternalMessageId.
- O campo date-time é exibido como Timestamp.
- O campo recipient-address é exibido como Recipients.
- O campo sender-address é exibido como Sender.
Para obter mais informações sobre os arquivos de log de rastreamento de mensagens, consulte Rastreamento de mensagens.
Você pode gravar os resultados em um arquivo canalizando a saída para ConvertTo-Html ou ConvertTo-Csv e adicionando > <filename>
ao comando. Por exemplo: Get-MessageTrackingLog -Start "03/13/2020 09:00:00" -End "03/13/2020 09:10:00" | ConvertTo-Html > "C:\My Documents\message track.html"
.
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-MessageTrackingLog -Server Mailbox01 -Start "03/13/2018 09:00:00" -End "03/15/2018 17:00:00" -Sender "john@contoso.com"
Este exemplo pesquisa os logs de rastreamento de mensagens no servidor mailbox chamado Mailbox01 para obter informações sobre todas as mensagens enviadas de 13 de março de 2018, 09:00 a 15 de março de 2018, 17:00 pelo remetente john@contoso.com.
Parâmetros
-DomainController
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-End
O parâmetro End especifica data e hora de término do intervalo de datas. As informações de entrega de mensagens são retornadas até, mas sem incluir, a data e a hora especificadas.
Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EventId
O parâmetro EventId filtra as entradas do log de acompanhamento de mensagens pelo valor do campo EventId. O valor EventId classifica cada evento de mensagem. Exemplos de valores são DSN, Defer, Deliver, Send ou Receive.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalMessageId
O parâmetro InternalMessageId filtra as entradas do log de acompanhamento de mensagens pelo valor do campo InternalMessageId. O valor InternalMessageId é um identificador de mensagem atribuído pelo servidor Exchange que estiver processando a mensagem no momento.
O valor de internal-message-id para uma mensagem específica é diferente no log de acompanhamento de mensagens para cada servidor Exchange envolvido na entrega da mensagem.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageId
O parâmetro MessageId filtra as entradas do log de acompanhamento de mensagens pelo valor do campo MessageId. O valor de MessageId corresponde ao valor do campo do cabeçalho Message-Id: na mensagem. Se o campo de cabeçalho Message-ID estiver em branco ou não existir, será atribuído um valor arbitrário. Certifique-se de incluir a cadeia de caracteres MessageId completa (que pode incluir colchetes de ângulo) e incluir o valor entre aspas (por exemplo, "d9683b4c-127b-413a-ae2e-fa7dfb32c69d@contoso.com").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MessageSubject
O parâmetro MessageSubject filtra as entradas do log de acompanhamento de mensagens pelo valor do assunto da mensagem. O valor do parâmetro MessageSubject automaticamente suporta correspondências parciais sem usar caracteres curingas ou especiais. Por exemplo, se você especificar o valor de MessageSubject como sea, os resultados incluirão mensagens com Seattle no assunto. Por padrão, os assuntos da mensagem são armazenados nos logs de controle de mensagens.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-NetworkMessageId
O parâmetro NetworkMessageId filtra as entradas do log de acompanhamento de mensagens pelo valor do campo NetworkMessageId. Esse campo contém um valor de ID de mensagem exclusivo que persiste nas cópias da mensagem que podem ser criadas devido a bifurcação ou à expansão do grupo de distribuição. Um exemplo de valor é 1341ac7b13fb42ab4d4408cf7f55890f.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Recipients
O parâmetro Recipients filtra as entradas do log de acompanhamento de mensagens pelo endereço de email SMTP dos destinatários das mensagens. Vários destinatários em uma única mensagem são registrados em uma única entrada do log de acompanhamento de mensagens. Os destinatários do grupo de distribuição não expandido são registrados usando-se o endereço de email SMTP do grupo. Você pode especificar vários endereços de email de destinatários separados por vírgulas.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Reference
O parâmetro Reference filtra as entradas do log de acompanhamento de mensagens pelo valor do campo Reference. O campo Reference contém informações adicionais para tipos específicos de eventos. Por exemplo, o valor do campo Reference para uma entrada de acompanhamento de mensagem DSN contém o valor InternalMessageId da mensagem que causou o DSN. Para muitos tipos de eventos, o valor de Reference fica em branco.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Sender
O parâmetro Sender filtra as entradas do log de acompanhamento de mensagens pelo endereço de email SMTP do remetente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
O parâmetro Servidor especifica o servidor Exchange em que você deseja executar esse comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- FQDN
- DN (nome diferenciado)
- DN Herdado do Exchange
DN Herdado do Exchange
Type: | ServerIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Source
O parâmetro Source filtra as entradas do log de controle de mensagens pelo valor do campo Source. Esses valores indicam o componente de transporte responsável pelo evento de controle de mensagens. Para mais informações, confira Source values in the message tracking log.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Start
O parâmetro Start especifica data e hora de início do intervalo de datas.
Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransportTrafficType
O parâmetro TransportTrafficType filtra as entradas do log de controle de mensagens pelo valor do campo TransportTrafficType. No entanto, esse campo não é interessante para organizações locais do Exchange.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.