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 Mailbox2Questo 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.comIn 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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per