Test-Mailflow
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-02-16
Use o cmdlet Test-Mailflow para diagnosticar se emails podem ser enviados para a caixa de correio Caixa de Correio do Sistema e recebidos dela com êxito em um computador em que a função de servidor Caixa de Correio esteja instalada. Você pode também usar esse cmdlet para verificar se o email é enviado entre servidores de Caixa de Correio dentro de um limite de latência definido.
Sintaxe
Test-Mailflow [-Identity <ServerIdParameter>] [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
Test-Mailflow [-Identity <ServerIdParameter>] -TargetMailboxServer <ServerIdParameter> [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
Test-Mailflow [-Identity <ServerIdParameter>] -TargetEmailAddress <String> [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-TargetEmailAddressDisplayName <String>] [-WhatIf [<SwitchParameter>]]
Test-Mailflow [-Identity <ServerIdParameter>] -AutoDiscoverTargetMailboxServer <SwitchParameter> [-ActiveDirectoryTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ErrorLatency <Int32>] [-ExecutionTimeout <Int32>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Test-Mailflow testa o envio, o transporte e a entrega de emails. O cmdlet verifica se cada servidor de Caixa de Correio pode enviar com êxito para si mesmo uma mensagem. Você pode também usar esse cmdlet para verificar se a caixa de correio Caixa de Correio do Sistema em um servidor de Caixa de Correio pode enviar com êxito uma mensagem à caixa de correio Caixa de Correio do Sistema em outro servidor de Caixa de Correio.
Esta tarefa fornece informações úteis para o administrador, quando executada manualmente. Ela pode ser chamada também por ferramentas de monitoramento, como Microsoft Operations Manager (MOM), Exchange Best Practices Analyzer e Exchange Troubleshooting Assistant. Quando a tarefa for chamada por MOM, alertas serão gerados para indicar falhas ou desempenho lento.
O cmdlet Test-Mailflow pode executar um teste local ou um teste remoto. Se você não especificar nenhum parâmetro, um teste local será executado e o servidor enviará uma mensagem de email de teste para si mesmo. Quando o parâmetro TargetEmailAddress, TargetMailboxServer ou AutoDiscoverTargetMailboxServer for especificado, um teste remoto será executado. Os parâmetros TargetEmailAddress, TargetMailboxServer e AutoDiscoverTargetMailboxServer são mutuamente exclusivos.
Para testar uma entrega de email em um cenário entre florestas, use o parâmetro TargetEmailAddress. Para testar uma entrega de email entre servidores de Caixa de Correio na mesma floresta do Active Directory, use o parâmetro TargetMailboxServer. Para preencher automaticamente a lista de servidores de destino no qual testar o fluxo de mensagens, use o parâmetro AutoDiscoverTargetMailboxServer.
Se mais de um desses parâmetros for especificado, o parâmetro AutoDiscoverTargetMailboxServer terá precedência sobre os parâmetros TargetEmailAddress e TargetMailboxServer. O parâmetro TargetMailboxServer terá precedência sobre o parâmetro TargetEmailAddress. Se um teste local for executado, o servidor local deverá ter uma caixa de correio Caixa de Correio do Sistema para cada banco de dados de caixa de correio. Se um teste remoto for executado, os servidores de origem e de destino deverão ter uma caixa de correio Caixa de Correio do Sistema ou uma caixa de correio específica deverá ser fornecida usando parâmetros.
Para executar o cmdlet Test-Mailflow, você deve usar a conta à qual esteja delegado o seguinte:
- A funçao Administrador da Organização do Exchange e o grupo Administradores de Domínio do servidor em que o cmdlet estiver sendo executado.
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.
Parâmetros
| Parâmetro | Necessário(s) | Tipo | Descrição |
|---|---|---|---|
AutoDiscoverTargetMailboxServer |
Necessário(s) |
System.Management.Automation.SwitchParameter |
O parâmetro AutoDiscoverTargetMailboxServer preenche automaticamente uma lista de servidores de Caixa de Correio de destino para os quais enviar uma mensagem de teste. A tarefa consulta o serviço de diretório do Active Directory para descobrir todos os servidores de Caixa de Correio e enviar a cada servidor uma mensagem de teste. |
TargetEmailAddress |
Necessário(s) |
System.String |
O parâmetro TargetEmailAddress especifica o endereço SMTP da caixa de correio para a qual as mensagens de teste são enviadas. Use esse parâmetro para enviar mensagens de teste para um servidor de Caixa de Correio em uma floresta remota. Se esse parâmetro for usado, o teste será sempre um teste remoto. |
TargetMailboxServer |
Necessário(s) |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
O parâmetro TargetMailboxServer especifica um ou mais servidores de Caixa de Correio na organização local do Exchange para os quais as mensagens de teste são enviadas. |
ActiveDirectoryTimeout |
Opcional |
System.Int32 |
O parâmetro ActiveDirectoryTimeout especifica o número de segundos que decorrerá até que a tarefa forneça uma mensagem informativa para o administrador sobre o atraso. O valor padrão é 15 segundos. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que o administrador confirme o que o comando fará antes que o processamento continue. O valor padrão é |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Use o parâmetro DomainController para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio ao qual esse comando se ligará e que gravará essa alteração no Active Directory. |
ErrorLatency |
Opcional |
System.Int32 |
O parâmetro ErrorLatency especifica o tempo de espera de uma mensagem de teste a ser entregue antes de um evento de Erro ser registrado no MOM. O valor padrão quando uma mensagem de teste é enviada ao servidor de Caixa de Correio local é de 15 segundos e de 180 segundos quando uma mensagem de teste é enviada ao servidor de Caixa de Correio remoto. |
ExecutionTimeout |
Opcional |
System.Int32 |
O parâmetro ExecutionTimeout especifica o tempo máximo que essa tarefa pode ser executada antes que o teste seja determinado como uma falha. Se nenhuma mensagem de teste ou notificação de entrega chegar antes desse tempo expirar, a tarefa será encerrada e um erro será relatado. Quando a tarefa for executada no Shell de Gerenciamento do Exchange, a configuração padrão será de 240 segundos. Quando o parâmetro MonitoringContext for usado, a configuração padrão será de 15 segundos. |
Identity |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
O parâmetro Identity especifica o nome do servidor de Caixa de Correio de origem a ser usado para enviar uma mensagem de teste. O valor padrão é o servidor local de Caixa de Correio. |
MonitoringContext |
Opcional |
System.Boolean |
O parâmetro MonitoringContext é usado somente quando o monitoramento de servidores está sendo feito pelo MOM. Se você definir o valor como |
TargetEmailAddressDisplayName |
Opcional |
System.String |
O parâmetro TargetEmailAddressDisplayName especifica o nome para exibição da caixa de correio para a qual as mensagens de teste são enviadas. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, o administrador poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é |
Tipos de entrada
Tipos de retorno
O cmdlet Test-Mailflow retorna as seguintes propriedades para ajudar a solucionar os problemas de fluxo de mensagens:
MailFlowResult Esta propriedade exibe Êxito ou Falha.
MessageLatencyTime Essa propriedade exibe o tempo em segundos que levou para que uma mensagem de teste fosse enviada ao servidor de Caixa de Correio de recebimento.
IsRemoteTest Essa propriedade indica se a mensagem de teste foi enviada a um servidor diferente do servidor local de Caixa de Correio, ou se a mensagem de teste foi enviada a um endereço de email.
Erros
| Erro | Descrição |
|---|---|
|
Exceções
| Exceções | Descrição |
|---|---|
|
Exemplo
O primeiro exemplo mostra como enviar uma mensagem de teste do servidor Mailbox1 ao servidor Mailbox2.
O segundo exemplo mostra como enviar uma mensagem de teste do servidor Mailbox1 para o endereço de email john@contoso.com. Nesse exemplo, a mensagem de teste está sendo enviada para um servidor de Caixa de Correio em uma floresta remota.
Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2
Test-Mailflow Mailbox1 -TargetEmailAddress john@contoso.com