Test-ImapConnectivity
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Test-ImapConnectivity per verificare che la connettività al servizio IMAP4 di Microsoft Exchange funzioni come previsto.
Nota: questo cmdlet funziona meglio in Exchange 2010. Nelle versioni successive di Exchange, la funzionalità di questo cmdlet è stata sostituita da Disponibilità gestita. Per ottenere risultati ottimali, usare il cmdlet Invoke-MonitoringProbe e specificare il probe di monitoraggio attivo pertinente anziché usare questo cmdlet.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Test-ImapConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-Confirm]
[-ConnectionType <ProtocolConnectionType>]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-PerConnectionTimeout <Int32>]
[-PortClientAccessServer <Int32>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Test-ImapConnectivity testa la connettività IMAP4 connettendosi alla cassetta postale specificata, al server Exchange specificato o a tutti i server Exchange disponibili nel sito di Active Directory locale.
La prima volta che si utilizza questo cmdlet potrebbe essere necessario creare un utente di prova. Per creare un utente di test, eseguire il comando seguente:
& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1
I risultati del test vengono visualizzati sullo schermo. Il cmdlet restituisce le seguenti informazioni.
- CasServer: il server Exchange a cui il client si è connesso.
- LocalSite: nome del sito active directory locale.
- Scenario: operazioni testate. Test IMAP4 Connectivity si connette al server usando il protocollo IMAP4, cerca il messaggio di test ed lo elimina insieme a tutti i messaggi precedenti a 24 ore.
- Risultato: i valori restituiti sono in genere Operazione riuscita, Ignorata o Errore.
- Latenza(MS): tempo necessario per completare il test in millisecondi.
- Errore: eventuali messaggi di errore rilevati.
È possibile scrivere i risultati in un file inviando l'output a ConvertTo-Html e Set-Content. Ad esempio: Test-IMAPConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\IMAP Test.html"
.
È 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.
Nota importante: in Exchange 2013 o versioni successive, quando si esegue questo comando per testare una singola cassetta postale in un server Exchange che non ospita la copia del database delle cassette postali attiva per la cassetta postale, potrebbe essere visualizzato il messaggio di errore seguente:
Unable to create MailboxSession object to access the mailbox [user@contoso.com]. Detailed error information: [Microsoft.Exchange.Data.Storage.WrongServerException]: The user and the mailbox are in different Active Directory sites. Inner error [Microsoft.Mapi.MapiExceptionMailboxInTransit]: MapiExceptionMailboxInTransit: Detected site violation (hr=0x0, ec=1292)
Quando viene visualizzato questo errore, eseguire di nuovo il comando nel server che ospita la copia del database delle cassette postali attiva per verificare che IMAP funzioni per la cassetta postale.
Esempio
Esempio 1
Test-ImapConnectivity -ClientAccessServer Contoso12 -MailboxCredential (Get-Credential contoso\kweku)
Con questo esempio viene verificata la connettività IMAP4 del client per il server denominato Contoso12 utilizzando le credenziali dell'utente contoso\kweku.
Esempio 2
Test-ImapConnectivity -ClientAccessServer Contoso12
In questo esempio viene testata la connettività IMAP4 client del server denominato Contoso12 e vengono testate tutte le cassette postali di Exchange.
Parametri
-ClientAccessServer
Il parametro ClientAccessServer specifica il server Exchange da testare. In questo server è installato il ruolo del server Accesso client ed è responsabile dell'accettazione delle connessioni client.
È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- ExchangeLegacyDN
- GUID
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 |
-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 |
-ConnectionType
Il parametro ConnectionType consente di specificare il tipo di connessione utilizzato per connettersi al servizio IMAP4. I valori validi sono:
- Plaintext
- Ssl
- Tls
Type: | ProtocolConnectionType |
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 |
-LightMode
L'opzione LightMode indica al comando di eseguire solo un accesso di prova al server utilizzando il protocollo IMAP4. Con questa opzione non è necessario specificare alcun valore.
Se non si utilizza questa opzione, il comando verifica anche l'invio e la ricezione di un messaggio utilizzando il protocollo IMAP4.
Type: | SwitchParameter |
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 |
-MailboxCredential
Il parametro MailboxCredential consente di specificare le credenziali della cassetta postale da usare per un singolo test della cassetta postale.
Un valore per questo parametro richiede il cmdlet Get-Credential. Per sospendere questo comando e visualizzare la richiesta di immissione delle credenziali, usare il valore (Get-Credential)
. In alternativa, prima di eseguire questo comando, archiviare le credenziali in una variabile (ad esempio, $cred = Get-Credential
) e quindi usare il nome della variabile ($cred
) per questo parametro. Per altre informazioni, vedere Get-Credential.
Type: | PSCredential |
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 |
-MailboxServer
Il parametro MailboxServer consente di specificare il server Cassette postali di Exchange da testare. Questo parametro identifica il server back-end che accetta connessioni proxy dal server front-end in cui si connettono i client.
Il parametro MailboxServer consente di specificare il server Cassette postali di exExchange2k16 o exExchange2k13 da verificare. Ad esempio:
- Nome
- Nome distinto (DN)
- ExchangeLegacyDN
- GUID
Se non si usa questo parametro, vengono testate le connessioni a tutti i server Cassette postali nel sito Active Directory locale.
Type: | ServerIdParameter |
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 |
-MonitoringContext
L'opzione MonitoringContext include nei risultati gli eventi di monitoraggio e i contatori delle prestazioni associati. Con questa opzione non è necessario specificare alcun valore.
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).
Type: | SwitchParameter |
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 |
-PerConnectionTimeout
Il parametro PerConnectionTimeout consente di specificare il tempo di attesa, indicato in secondi, per il completamento dell'operazione di test. I valori validi sono compresi tra 0 e 120 secondi. Il valore predefinito è 120 secondi.
È consigliabile configurare questo parametro con un valore pari o superiore a 5 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 |
-PortClientAccessServer
Il parametro PortClientAccessServer consente di specificare la porta da utilizzare per la connessione al server Accesso client. Per IMAP4 la porta predefinita è 143. L'intervallo valido va da 0 a 65.535.
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 |
-ResetTestAccountCredentials
Il parametro ResetTestAccountCredentials consente di reimpostare la password dell'account di test utilizzato per eseguire il comando. Con questa opzione non è necessario specificare alcun valore.
La password dell'account di prova è, in genere, reimpostata ogni 7 giorni. Se necessario per motivi di sicurezza, è possibile utilizzare questa opzione per forzare la reimpostazione della password in qualsiasi momento.
Type: | SwitchParameter |
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 |
-Timeout
Il parametro Timeout consente di specificare il tempo di attesa, indicato in secondi, per il completamento dell'operazione di test. I valori validi sono compresi tra 0 e 3600 secondi (1 ora). Il valore predefinito è 180 secondi (3 minuti).
È consigliabile configurare questo parametro con un valore pari o superiore a 5 secondi.
Type: | UInt32 |
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 |
-TrustAnySSLCertificate
Il commutatore TrustAnySSLCertificate consente a Exchange di accettare certificati da autorità di certificazione non attendibili. Con questa opzione non è necessario specificare alcun valore.
L'opzione TrustAnySSLCertificate consente di specificare se ignorare gli errori della convalida del certificato SSL (Secure Sockets Layer). Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
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 |
-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.