Condividi tramite


Test-Mailflow

Questo cmdlet è disponibile solo in Exchange locale.

Il cmdlet Test-Mailflow consente di diagnosticare eventuali problemi relativi all'invio e al recapito della posta alla cassetta postale di sistema su un server Cassette postali. È possibile utilizzare il cmdlet anche per verificare che la posta elettronica venga inviata tra i server Cassette postali entro una soglia di latenza definita.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    [-AutoDiscoverTargetMailboxServer]
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]
Test-Mailflow
    -CrossPremises <Boolean>
    [-ActiveDirectoryTimeout <Int32>]
    [-CrossPremisesExpirationTimeout <EnhancedTimeSpan>]
    [-CrossPremisesPendingErrorCount <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]
Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    -TargetDatabase <DatabaseIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]
Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    -TargetEmailAddress <String>
    [-TargetEmailAddressDisplayName <String>]
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]
Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    -TargetMailboxServer <ServerIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]
Test-Mailflow
    [[-Identity] <ServerIdParameter>]
    [-ActiveDirectoryTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ErrorLatency <Int32>]
    [-ExecutionTimeout <Int32>]
    [-MonitoringContext <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-Mailflow consente di verificare l'invio, il trasporto e il recapito della posta. Il cmdlet consente di verificare che ciascun server Cassette postali sia in grado di inviarsi correttamente un messaggio. Il cmdlet può inoltre essere utilizzato per verificare che la cassetta postale di sistema su un singolo server Cassette postali possa inviare un messaggio alla cassetta postale di sistema su un altro server Cassette postali. È necessaria una cassetta postale di sistema su tutti i server coinvolti nella verifica.

I messaggi di prova sono disponibili nella cassetta postale di sistema o utente di destinazione. L'oggetto del messaggio è Test-Mailflow <GUID>e il corpo del messaggio contiene il testo This is a Test-Mailflow probe message.

I risultati di Test-Mailflow vengono visualizzati sullo schermo. I valori interessanti nei risultati sono:

  • TestMailflowResult: i valori restituiti sono in genere Success o *FAILURE*.
  • MessageLatencyTime: tempo necessario per completare il test (recapitare il messaggio di test). Il valore utilizza la sintassi hh:mm:ss.ffff dove hh = ore, mm = minuti, ss = secondi e ffff = frazioni di secondo.

È possibile scrivere i risultati Test-Mailflow in un file inviando l'output a ConvertTo-Html o ConvertTo-Csv e aggiungendo > <filename> al comando . Ad esempio: Test-Mailflow -AutoDiscoverTargetMailboxServer | ConvertTo-Csv > "C:\My Documents\test-mailflow 2020-05-01.csv".

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Test-Mailflow Mailbox1 -TargetMailboxServer Mailbox2

Questo esempio verifica il flusso dei messaggi dal server denominato Cassette postali1 al server denominato Cassette postali2. Questo comando deve essere eseguito mentre si è connessi a Cassette postali1.

Esempio 2

Test-Mailflow -TargetEmailAddress john@contoso.com

In questo esempio viene testato il flusso del messaggio dal server Cassette postali locale in cui si esegue questo comando all'indirizzo john@contoso.comdi posta elettronica .

Parametri

-ActiveDirectoryTimeout

Il parametro ActiveDirectoryTimeout consente di specificare il numero di secondi che trascorrono prima che l'attività fornisca un messaggio informativo sul ritardo. Il valore predefinito è 15 secondi.

Type:Int32
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

-AutoDiscoverTargetMailboxServer

L'opzione AutoDiscoverTargetMailboxServer consente di specificare se deve essere compilato automaticamente un elenco di server Cassette postali di destinazione a cui inviare un messaggio di prova. Con questa opzione non è necessario specificare alcun valore.

L'attività esegue una query su Active Directory per individuare tutti i server Cassette postali e quindi invia a ogni server un messaggio di test.

Quando si utilizza questa opzione, non è possibile utilizzare i parametri CrossPremises, TargetDatabase, TargetEmailAddress o TargetMailboxServer.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
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

-CrossPremises

Il parametro CrossPremises consente di specificare se il test del flusso di posta sarà condotto nella modalità tra sedi diverse.

Impostare il parametro su $true se l'organizzazione utilizza una distribuzione tra sedi diverse e si desidera verificare il flusso di posta tra le sedi.

Quando si utilizza questo parametro, non è possibile utilizzare i parametri AutoDiscoverTargetMailboxServer, TargetDatabase, TargetEmailAddress o TargetMailboxServer.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CrossPremisesExpirationTimeout

Il parametro CrossPremisesExpirationTimeout è utilizzato quando il cmdlet viene eseguito dagli agenti di Microsoft System Center Operations Manager 2007 per il monitoraggio asincrono. Non è consigliabile utilizzare questo parametro durante l'esecuzione manuale del cmdlet.

Type:EnhancedTimeSpan
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

-CrossPremisesPendingErrorCount

Il parametro CrossPremisesPendingErrorCount è utilizzato quando il cmdlet viene eseguito dagli agenti di System Center Operations Manager 2007 per il monitoraggio asincrono. Non è consigliabile utilizzare questo parametro durante l'esecuzione manuale del cmdlet.

Type:Int32
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

-DomainController

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

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

-ErrorLatency

Il parametro ErrorLatency consente di specificare il tempo per cui viene atteso il recapito di un messaggio di prova prima che venga registrato un evento in Microsoft System Center Operations Manager 2007. Il valore predefinito per l'invio di un messaggio di prova al server Cassette postali locale è 15 secondi, 180 secondi se viene inviato un messaggio di prova a un server Cassette postali remoto.

Type:Int32
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

-ExecutionTimeout

Il parametro ExecutionTimeout consente di specificare il tempo massimo consentito per l'esecuzione dell'attività prima che il test abbia esito negativo. Se non arriva alcun messaggio di prova o rapporto di recapito prima della scdenza, l'attività terminerà e verrà restituito un errore. Quando l'attività viene eseguita in Exchange Management Shell, l'impostazione predefinita è 240 secondi. Quando si utilizza il parametro MonitoringContext, l'impostazione predefinita è 15 secondi.

Type:Int32
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

-Identity

Il parametro Identity consente di specificare il nome del server Cassette postali da cui viene inviato un messaggio di prova. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

  • Nome
  • FQDN
  • Nome distinto (DN)
  • DN legacy di Exchange

Se non si utilizza questo parametro, viene utilizzato il server Cassette postali locale.

Type:ServerIdParameter
Position:1
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

-MonitoringContext

Il parametro MonitoringContext consente di specificare se includere gli eventi di monitoraggio e i contatori delle prestazioni associati nei risultati. I valori validi sono:

  • $true: i risultati del comando includono eventi di monitoraggio e contatori delle prestazioni. In genere, si includono gli eventi di monitoraggio e i contatori delle prestazioni nei risultati quando l'output viene passato a Microsoft System Center Operations Manager (SCOM).
  • $false: gli eventi di monitoraggio e i contatori delle prestazioni non sono inclusi nei risultati del comando. Questo è il valore predefinito.
Type:Boolean
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

-TargetDatabase

Il parametro TargetDatabase consente di specificare il database delle cassette postali a quale vengono inviati i messaggi di prova. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Non è possibile usare questo parametro con i parametri AutoDiscoverTargetMailboxServer, CrossPremises, TargetEmailAddress o TargetMailboxServer.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TargetEmailAddress

Il parametro TargetEmailAddress consente di specificare l'indirizzo SMTP della cassetta postale a cui vengono inviati i messaggi di prova. Utilizzare questo parametro per inviare messaggi di prova a un server Cassette postali che si trova in una foresta remota. Se si utilizza questo parametro, il test sarà sempre un test remoto.

Quando si utilizza questo parametro, non è possibile utilizzare i parametri AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase o TargetMailboxServer.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TargetEmailAddressDisplayName

Il parametro TargetEmailAddressDisplayName specifica un nome visualizzato personalizzato utilizzato in eventi e rapporti in Microsoft System Center Operations Manager 2007 quando viene utilizzato il parametro TargetEmailAddress. Se non si utilizza il parametro TargetEmailAddressDisplayName, gli eventi e i rapporti utilizzano il valore dell'indirizzo di posta elettronica specificato dal parametro TargetEmailAddress.

Questo parametro è disponibile solo con il parametro TargetEmailAddress e non ha alcun effetto sull'output del cmdlet all'esterno di Microsoft System Center Operations Manager.

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

-TargetMailboxServer

Il parametro TargetMailboxServer consente di specificare uno o più server Cassette postali nell'organizzazione di Exchange locale a cui inviare messaggi di test. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

  • Nome
  • FQDN
  • Nome distinto (DN)
  • DN legacy di Exchange

Quando si utilizza questo parametro, non è possibile utilizzare i parametri AutoDiscoverTargetMailboxServer, CrossPremises, TargetDatabase o TargetEmailAddress.

Type:ServerIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.