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
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>]
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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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. È necessario eseguire questo comando durante la connessione a Mailbox1.
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
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AutoDiscoverTargetMailboxServer
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AutoDiscoverTargetMailboxServer
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CrossPremises
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Il parametro CrossPremises consente di specificare se il test del flusso di posta viene eseguito in modalità cross-premise.
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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CrossPremises
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CrossPremisesExpirationTimeout
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | EnhancedTimeSpan |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CrossPremises
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CrossPremisesPendingErrorCount
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
CrossPremises
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ErrorLatency
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ExecutionTimeout
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | ServerIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AutoDiscoverTargetMailboxServer
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
TargetDatabase
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
TargetEmailAddress
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
TargetMailboxServer
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
SourceServer
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MonitoringContext
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 valore è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TargetDatabase
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | DatabaseIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TargetDatabase
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TargetEmailAddress
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TargetEmailAddress
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TargetEmailAddressDisplayName
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TargetEmailAddress
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TargetMailboxServer
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | ServerIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
TargetMailboxServer
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.