Test-Message

Aplica-se a: Exchange Server 2010

Tópico modificado em: 2009-07-30

Use o cmdlet Test-Message para solucionar problemas gerados pelo impacto de regras de Caixa de Entrada sobre uma mensagem específica. Se uma mensagem estiver sendo processada de forma inesperada, você pode usar este cmdlet para reenviá-la e coletar informações detalhadas sobre como as regras a estão processando.

Sintaxe

Test-Message -Recipients <ProxyAddressCollection> [-Confirm [<SwitchParameter>]] [-DeliverMessage <SwitchParameter>] [-MessageFileData <Byte[]>] [-Sender <SmtpAddress>] [-SendReportTo <RecipientIdParameter>] [-WhatIf [<SwitchParameter>]]

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Recipients	Necessário	Microsoft.Exchange.Data.ProxyAddressCollection	O parâmetro Recipients especifica a lista de endereços de e-mail a serem usados como destinatários para a mensagem de teste se um arquivo .eml não for especificado.
Confirm	Opcional	System.Management.Automation.SwitchParameter	A opção 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 a opção Confirm.
DeliverMessage	Opcional	System.Management.Automation.SwitchParameter	A opção DeliverMessage especifica que a mensagem deve ser entregue no destino final. Se você não especificar essa opção, a mensagem reenviada não é entregue nos destinatários. Apenas dados de solução de problemas são gerados e enviados ao destinatário especificado.
MessageFileData	Opcional	System.Byte[]	O parâmetro MessageFileData especifica dados de arquivos recuperados de um arquivo .eml usando o cmdlet Get-Content. Para mais informações sobre a sintaxe obrigatória para usar esse parâmetro, consulte Noções Básicas Sobre Importação e Exportação de Arquivos no Shell de Gerenciamento do Exchange.
Sender	Opcional	Microsoft.Exchange.Data.SmtpAddress	O parâmetro Sender especifica o endereço de email a ser usado como remetente da mensagem de teste se um arquivo .eml não for especificado.
SendReportTo	Opcional	Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter	O parâmetro SendReportTo especifica o endereço de email para qual o relatório final é enviado.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	A opção WhatIf instrui o comando a simular as ações que ele executaria no objeto. Usando-se a opção WhatIf, é possível exibir que alterações ocorreriam sem que seja necessário aplicar nenhuma dessas alterações. Você não precisa especificar um valor com a opção WhatIf.

Descrição detalhada

Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Testando o processamento de regras de transporte" no tópico Permissões de transporte.

Exemplos

EXEMPLO 1

Este exemplo re-envia um email específico e envia o relatório final para o endereço postmaster@contoso.com.

Test-Message -MessageFileData ([Byte[]]$(Get-Content -path c:\testmessage.eml" -encoding byte -ReadCount 0)) -SendReportTo postmaster@contoso.com