Test-Mailflow
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Test-Mailflow para diagnosticar se as mensagens podem ser enviadas com sucesso e entregues na caixa de correio do sistema em um servidor de Caixa de Correio. Também é possível usar esse cmdlet para verificar que o email é enviado entre os servidores de Caixa de Correio dentro de um limite de latência definido.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
AutoDiscoverTargetMailboxServer
Test-Mailflow
[[-Identity] <ServerIdParameter>]
[-AutoDiscoverTargetMailboxServer]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
CrossPremises
Test-Mailflow
-CrossPremises <Boolean>
[-ActiveDirectoryTimeout <Int32>]
[-CrossPremisesExpirationTimeout <EnhancedTimeSpan>]
[-CrossPremisesPendingErrorCount <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TargetDatabase
Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetDatabase <DatabaseIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TargetEmailAddress
Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetEmailAddress <String>
[-TargetEmailAddressDisplayName <String>]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
TargetMailboxServer
Test-Mailflow
[[-Identity] <ServerIdParameter>]
-TargetMailboxServer <ServerIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
SourceServer
Test-Mailflow
[[-Identity] <ServerIdParameter>]
[-ActiveDirectoryTimeout <Int32>]
[-Confirm]
[-DomainController <Fqdn>]
[-ErrorLatency <Int32>]
[-ExecutionTimeout <Int32>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
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 uma mensagem com sucesso para si mesmo. Também é possível usar esse cmdlet para verificar se a caixa de correio do sistema em um servidor de Caixa de Correio pode enviar uma mensagem com sucesso para a caixa de correio do sistema em outro servidor de Caixa de Correio. Uma caixa de correio do sistema é necessária em todos os servidores envolvidos no teste.
As mensagens de teste estão disponíveis na caixa de correio do sistema ou do usuário de destino. O assunto da mensagem é Test-Mailflow <GUID>e o corpo da mensagem contém o texto This is a Test-Mailflow probe message.
Os resultados de Test-Mailflow são exibidos na tela. Os valores que interessam nos resultados são:
- TestMailflowResult: os valores devolvidos são normalmente Êxito ou *FALHA*.
- MessageLatencyTime: o tempo necessário para concluir o teste (entregar a mensagem de teste). O valor usa a sintaxe hh:mm:ss.ffff, em que hh = horas, mm = minutos, ss = segundos e ffff = frações de um segundo.
Pode escrever os resultados do Test-Mailflow num ficheiro ao encaminhar a saída para ConvertTo-Html ou ConvertTo-Csv e adicionar > <filename> ao comando . Por exemplo: Test-Mailflow -AutoDiscoverTargetMailboxServer | ConvertTo-Csv > "C:\My Documents\test-mailflow 2020-05-01.csv".
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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
Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2
Este exemplo testa o fluxo de mensagens do servidor chamado Mailbox1 para o servidor chamado Mailbox2. Tem de executar este comando enquanto estiver ligado à Caixa de Correio1.
Exemplo 2
Test-Mailflow -TargetEmailAddress john@contoso.com
Este exemplo testa o fluxo de mensagens do servidor da Caixa de Correio local onde está a executar este comando para o endereço john@contoso.comde e-mail .
Parâmetros
-ActiveDirectoryTimeout
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ActiveDirectoryTimeout especifica o número de segundos decorridos até que a tarefa forneça uma mensagem informativa sobre o atraso. O valor padrão é 15 segundos.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AutoDiscoverTargetMailboxServer
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção AutoDiscoverTargetMailboxServer especifica se é necessário popular automaticamente uma lista de servidores de Caixa de Correio de destino para os quais enviar uma mensagem de teste. Não é preciso especificar um valor com essa opção.
A tarefa consulta o Active Directory para detetar todos os servidores de Caixa de Correio e, em seguida, envia uma mensagem de teste a cada servidor.
Ao usar essa opção, você não pode usar os parâmetros CrossPremises, TargetDatabase, TargetEmailAddress nem TargetMailboxServer.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AutoDiscoverTargetMailboxServer
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CrossPremises
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro CrossPremises especifica se o teste de fluxo de correio é realizado no modo em vários locais.
Defina este parâmetro como $true se sua organização estiver usando uma implantação entre locais e você desejar verificar o fluxo de mensagens entre locais.
Ao usar esse parâmetro, você não pode usar os parâmetros AutoDiscoverTargetMailboxServer, TargetDatabase, TargetEmailAddress nem TargetMailboxServer.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CrossPremises
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CrossPremisesExpirationTimeout
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro CrossPremisesExpirationTimeout é usado quando esse cmdlet é executado por agentes do Microsoft System Center Operations Manager 2007 para monitoramento assíncrono. Não é recomendável o uso deste parâmetro ao executar esse cmdlet manualmente.
Propriedades do parâmetro
| Tipo: | EnhancedTimeSpan |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CrossPremises
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CrossPremisesPendingErrorCount
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro CrossPremisesPendingErrorCount é usado quando esse cmdlet é executado por agentes do System Center Operations Manager 2007 para monitoramento assíncrono. Não é recomendável o uso deste parâmetro ao executar esse cmdlet manualmente.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
CrossPremises
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ErrorLatency
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ErrorLatency especifica por quanto tempo aguardar a entrega de uma mensagem de teste antes de um evento de erro ser registrado em log no Microsoft System Center Operations Manager 2007. O valor padrão quando uma mensagem de teste é enviada para o servidor de Caixa de Correio é de 15 segundos e 180 quando uma mensagem de teste é enviada para um servidor de Caixa de Correio remoto.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExecutionTimeout
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ExecutionTimeout especifica o tempo máximo durante o qual essa tarefa pode ser executada, antes que o teste seja determinado como falho. Se nenhuma mensagem de teste ou notificação de entrega chegar antes de esse tempo expirar, a tarefa será encerrada e um erro será relatado. Quando a tarefa é executada na Shell de Gestão do Exchange, a predefinição é de 240 segundos. Quando o parâmetro MonitoringContext for usado, a configuração padrão será de 15 segundos.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Identity especifica o nome do servidor de Caixa de Correio de origem do qual uma mensagem de teste é enviada. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- FQDN
- DN (nome diferenciado)
- DN Herdado do Exchange
Se você não usar este parâmetro, o servidor de Caixa de Correio local será usado.
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AutoDiscoverTargetMailboxServer
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
TargetDatabase
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
TargetEmailAddress
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
TargetMailboxServer
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
SourceServer
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-MonitoringContext
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro MonitoringContext especifica se é preciso incluir os eventos de monitoramento e contadores de desempenho associados nos resultados. Os valores válidos são:
- $true: os eventos de monitorização e os contadores de desempenho estão incluídos nos resultados do comando. Normalmente, inclui os eventos de monitorização e os contadores de desempenho nos resultados quando a saída é transmitida para o Microsoft System Center Operations Manager (SCOM).
- $false: os eventos de monitorização e os contadores de desempenho não estão incluídos nos resultados do comando. Este valor é a predefinição.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetDatabase
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro TargetDatabase especifica o banco de dados da caixa de correio para o qual as mensagens de teste são enviadas. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Não pode utilizar este parâmetro com os parâmetros AutoDiscoverTargetMailboxServer, CrossPremises, TargetEmailAddress ou TargetMailboxServer.
Propriedades do parâmetro
| Tipo: | DatabaseIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
TargetDatabase
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetEmailAddress
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro TargetEmailAddress especifica o endereço SMTP da caixa de correio para o qual 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 sempre é um teste remoto.
Ao usar esse parâmetro, você não pode usar os parâmetros AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase nem TargetMailboxServer.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
TargetEmailAddress
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetEmailAddressDisplayName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro TargetEmailAddressDisplayName especifica um nome de exibição personalizado que é usado em eventos e relatórios no Microsoft System Center Operations Manager 2007 quando o parâmetro TargetEmailAddress é usado. Se você não usar o parâmetro TargetEmailAddressDisplayName, os eventos e relatórios usarão o valor de endereço de email especificado pelo parâmetro TargetEmailAddress.
Este parâmetro só está disponível com o parâmetro TargetEmailAddress e não tem qualquer efeito na saída do cmdlet fora do Microsoft System Center Operations Manager.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
TargetEmailAddress
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetMailboxServer
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro TargetMailboxServer especifica um ou mais servidores de Caixa de Correio na organização local do Exchange para onde enviar mensagens de teste. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- FQDN
- DN (nome diferenciado)
- DN Herdado do Exchange
Ao usar esse parâmetro, você não pode usar os parâmetros AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase nem TargetEmailAddress.
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
TargetMailboxServer
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.