Test-OutlookConnectivity

Modulo:

ExchangePowerShell

Si applica a:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet Test-OutlookConnectivity per testare la connettività client end-to-end di Microsoft Outlook nell'organizzazione di Microsoft Exchange. Sono inclusi i test sia per Outlook Anywhere (RPC su HTTP) che per MAPI su connessioni HTTP.

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

Sintassi

Test-OutlookConnectivity
    [-ProbeIdentity] <String>
    [-Credential <PSCredential>]
    [-Hostname <String>]
    [-MailboxId <MailboxIdParameter>]
    [-RunFromServerId <ServerIdParameter>]
    [-TimeOutSeconds <String>]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -Protocol <Protocol>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -GetDefaultsFromAutodiscover <Boolean>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyServer <ServerIdParameter>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -RpcTestType <RpcTestType>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-RpcAuthenticationType <RpcAuthenticationType>]
    [-RpcClientAccessServer <ClientAccessServerIdParameter>]
    [-RpcProxyAuthenticationType <RPCProxyAuthenticationType>]
    [-RpcProxyTestType <RpcProxyTestType>]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Test-OutlookConnectivity
    [[-Identity] <MailboxIdParameter>]
    -WSTestType <VirtualDirectoryUriScope>
    [-Archive <Boolean>]
    [-Confirm]
    [-MailboxCredential <PSCredential>]
    [-MonitoringContext]
    [-TotalTimeoutInMinutes <Int32>]
    [-TrustAnySslCert]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

L'esecuzione del cmdlet Test-OutlookConnectivity convalida una connessione di Outlook definita dai parametri specificati. Il comando è in grado di convalidare una singola cassetta postale.

Il cmdlet Test-OutlookConnectivity esegue lo stesso processo dei probe di monitoraggio. Il servizio Microsoft Exchange Health Manager (MSExchangeHM) deve essere in esecuzione e avere creato i probe di Outlook nel computer che verranno testati. È necessario selezionare una delle identità del probe di Outlook per eseguire il test. Usare il cmdlet Get-MonitoringItemIdentity per vedere quali probe sono attivi.

In questo esempio vengono elencati i probe in esecuzione nei servizi back-end in un server Cassette postali: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook.protocol | ?{$_.Name -like '*probe'}.

In questo esempio vengono elencati i probe in esecuzione nei servizi di accesso client in un server Cassette postali: Get-MonitoringItemIdentity -Server MailboxServer1 -Identity outlook | ?{$_.Name -like '*probe'}.

Per altre informazioni sui probe e sul framework di monitoraggio, vedere Disponibilità gestita, Disponibilità gestita e Integrità del server e Personalizzazione della disponibilità gestita.

Per impostazione predefinita, il cmdlet usa l'account di monitoraggio dei test collegato al probe specificato. È possibile immettere una cassetta postale diversa invece tramite il parametro MailboxId. Di seguito vengono forniti opzioni e risultati.

• MailboxId e Credential non sono specificati: test di connettività generico su una cassetta postale di test usando le credenziali di test del sistema.
• MailboxId è specificato, Credential non è: test di connettività alla cassetta postale specifica usando le credenziali di test del sistema.
• MailboxId e Credential sono entrambi specificati: Vengono forniti un test di connettività per la cassetta postale specifica e inoltre un test per verificare che le credenziali fornite siano valide per quella cassetta postale

È 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-OutlookConnectivity -ProbeIdentity OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe

In Exchange 2013 o versioni successive questo esempio esegue un MAPI tramite HTTP OutlookRpcSelfTestProbe nel server Cassette postali a cui si è attualmente connessi.

Esempio 2

Test-OutlookConnectivity "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 1234512345" -RunFromServerId PrimaryMailbox -MailboxId johnd@contoso.com

In Exchange 2013 o versioni successive questo esempio esegue OutlookRpcDeepTestProbe dal server "PrimaryMailbox" per la cassetta postale "johnd@contoso.com" montata su "Mailbox Database 1234512345". Poiché il parametro Credential non è specificato, il probe utilizzerà le credenziali di test predefinite.

Esempio 3

Test-OutlookConnectivity -Protocol HTTP -GetDefaultsFromAutoDiscover $true

In Exchange 2010 questo esempio testa lo scenario di connettività di Outlook end-to-end più comune per Outlook Via Internet. Sono inclusi i test per la connettività tramite il servizio di individuazione automatica, la creazione di un profilo utente e l'accesso alla cassetta postale utente. Tutti i valori necessari vengono recuperati dal servizio di individuazione automatica. Poiché il parametro Identity non è specificato, il comando usa l'utente di test temporaneo creato usando lo script New-TestCasConnectivityUser.ps1. Questo comando di esempio può essere eseguito per testare la connettività TCP/IP impostando il parametro Protocol su RPC.

Esempio 4

Test-OutlookConnectivity -RpcProxyTestType:Internal -RpcTestType:Server

In Exchange 2010 questo esempio verifica la connettività di Outlook Via Internet usando il server locale come endpoint RpcProxy e l'endpoint RPC. Poiché il parametro Identity non è specificato, il comando usa l'utente di test temporaneo creato usando lo script New-TestCasConnectivityUser.ps1. Modificare questo esempio per usare l'URL esterno pubblico impostando il parametro RpcProxyTestType su External. Inoltre, il comando di esempio può usare la matrice del server Accesso client come endpoint RPC impostando il parametro RpcTestType su Array. Per convalidare solo la connettività TCP/IP, omettere il parametro RpcProxyTestType.

Esempio 5

Test-OutlookConnectivity -RpcProxyServer RpcProxySrv01 -RpcProxyAuthenticationType Basic -RpcClientAccessServer CAS01 -RpcAuthenticationType NTLM

In Exchange 2010 questo esempio convalida la connettività di Outlook tramite RpcProxy in un server diverso che esegue il ruolo del server Accesso client con Basic per il livello di autenticazione esterno e NTLM per il livello di autenticazione interna. L'uso di questi parametri dovrebbe consentire di convalidare la maggior parte dei tipi di configurazioni di connettività di Outlook. Questo comando può essere usato anche con il parametro GetDefaultsFromAutoDiscover impostato su $true se è necessario eseguire l'override di uno o due parametri. Questo comando seguente è simile all'esecuzione di un test di connettività usando l'utilità Ping RPC, ma offre una convalida più avanzata.

Parametri

-Archive

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro Archive consente di specificare se è necessario eseguire test per connettersi alla cassetta postale di archiviazione locale dell'utente. I valori validi sono:

$true: connettersi alla cassetta postale di archiviazione locale dell'utente.

$false: non connettersi alla cassetta postale locale dell'utente. 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

-Confirm

Questo parametro è disponibile solo in Exchange Server 2010.

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

-Credential

Il parametro Credential specifica la credenziale utilizzata dal probe. Le credenziali di test del sistema vengono usate per impostazione predefinita

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 2013, Exchange Server 2016, Exchange Server 2019

-GetDefaultsFromAutodiscover

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro GetDefaultsFromAutodiscover specifica se ottenere valori predefiniti per tutti gli altri parametri per il comando dalle impostazioni del servizio di individuazione automatica. Se si esegue il comando che specifica i valori per altri parametri, questi valori sostituiscono i valori predefiniti del servizio di individuazione automatica. Il valore predefinito per questo parametro è $true.

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

-Hostname

Il parametroHostname specifica la destinazione dell'endpoint del protocollo del probe. È possibile usare un server Cassette postali specifico o una route tramite il server del servizio nomi distribuiti.

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

-Identity

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro Identity consente di specificare una cassetta postale utente di destinazione. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Dominio\nomeutente
• Indirizzo di posta elettronica
• GUID
• LegacyExchangeDN
• SamAccountName
• ID utente o Nome entità utente (UPN)

Se non si usa questo parametro, il comando cerca un utente di test in Active Directory creato in precedenza usando lo script New-TestCasConnectivityUser.ps1.

Type:	MailboxIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxCredential

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro MailboxCredential consente di specificare determinate credenziali per consentire l'accesso alla cassetta postale di un utente. Usare il parametro insieme al parametro Identity per accedere alla cassetta postale di un utente quando non si dispone delle autorizzazioni di accesso.

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:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MailboxId

Il parametro MailboxID specifica la cassetta postale di destinazione.

In Exchange 2013 o versioni successive il parametro Identity specifica una cassetta postale utente di destinazione. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

• Nome
• Alias
• Nome distinto (DN)
• Nome distinto (DN)
• Dominio\nomeutente
• Indirizzo di posta elettronica
• GUID
• LegacyExchangeDN
• SamAccountName
• ID utente o Nome entità utente (UPN)

Se non si usa questo parametro, il comando usa l'account di test.

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

-MonitoringContext

Questo parametro è disponibile solo in Exchange Server 2010.

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

-ProbeIdentity

Il parametro ProbeIdentity specifica il probe da utilizzare. I valori validi sono:

Probe di Outlook Via Internet (RPC su HTTP):

• Outlook.Protocol\OutlookRpcSelfTestProbe: verifica che l'endpoint RPC/HTTP sia in grado di ricevere traffico nel server Cassette postali. Non tenta di accedere a una cassetta postale. È un controllo della connettività di alto livello.
• Outlook.Protocol\OutlookRpcDeepTestProbe: verifica che l'endpoint RPC/HTTP funzioni nel server Cassette postali. Tenterà di connettersi e accedere alla cassetta postale. Poiché non viene specificato alcun database, tenterà di connettersi al primo database restituito dal cmdlet Get-MailboxDatabase.
• Outlook.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: verifica che l'endpoint RPC/HTTP funzioni nel server cassette postali. Tenterà di connettersi e accedere alla cassetta postale nel database delle cassette postali specificato. Se il nome del database della cassetta postale contiene spazi, racchiudere l'intero valore tra virgolette ,ad esempio . "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530"

MAPI su probe HTTP:

• OutlookMapiHttp.Protocol\OutlookMapiHttpSelfTestProbe: verifica che l'endpoint MAPI/HTTP sia in grado di ricevere traffico nel server Cassette postali. Non tenta di accedere a una cassetta postale. È un controllo della connettività di alto livello.
• OutlookMapiHttp.Protocol\OutlookMapiHttpDeepTestProbe: verifica che l'endpoint MAPI/HTTP funzioni nel server Cassette postali. Tenterà di connettersi e accedere alla cassetta postale. Poiché non viene specificato alcun database, tenterà di connettersi al primo database restituito dal cmdlet Get-MailboxDatabase.
• OutlookMapiHttp.Protocol\OutlookRpcDeepTestProbe\<Case-sensitive Mailbox Database Name>: verifica che l'endpoint MAPI/HTTP funzioni nel server cassette postali. Tenterà di connettersi e accedere alla cassetta postale nel database specificato. Se il nome del database della cassetta postale contiene spazi, racchiudere l'intero valore tra virgolette ,ad esempio . "Outlook.Protocol\OutlookRpcDeepTestProbe\Mailbox Database 0352791530"

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

-Protocol

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro Protocol consente di specificare se testare la connettività di Outlook Via Internet o direttamente per la connettività RPC o TCP/IP. Il valore è HTTP o TCP.

Type:	Protocol
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcAuthenticationType

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro RpcAuthenticationType consente di specificare l'impostazione di autenticazione da testare per il livello RPC. L'uso di questo parametro è utile se nella directory virtuale del proxy RPC viene impostato un tipo di autenticazione diverso. È possibile utilizzare i seguenti valori:

• NTLM
• Kerberos
• Negoziare

Il valore predefinito è Negotiate.

Type:	RpcAuthenticationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcClientAccessServer

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro RpcClientAccessServer specifica il server di destinazione con il ruolo del server Accesso client installato che si vuole testare. Può trattarsi di un nome di dominio completo (FQDN) del server o di un GUID.

Type:	ClientAccessServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyAuthenticationType

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro RpcProxyAuthenticationType consente di specificare l'impostazione di autenticazione per l'endpoint proxy RPC. Il valore può essere specificato come Basic, NTLM o Negotiate. Non esiste alcun valore predefinito a meno che non venga usato con il parametro GetDefaultsFromAutodiscover.

Type:	RPCProxyAuthenticationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcProxyServer

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro RpcProxyServer consente di specificare se impostare il server RpcProxy di destinazione per il test. Questo parametro può essere usato quando il server RpcProxy è diverso dal server Accesso client.

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

-RpcProxyTestType

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro RpcProxyTestType specifica a quale endpoint HTTP deve connettersi il comando. I valori validi sono:

• Interno: fa riferimento al nome del computer locale ,https://<localcomputername> ad esempio https://CAS01.
• Esterno: fa riferimento a uno spazio dei nomi pubblico (l'URL HTTP esterno nella directory virtuale /rpc, ad esempio ). https://mail.contoso.com

Type:	RpcProxyTestType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RpcTestType

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro RpcTestType consente di specificare il tipo di endpoint RPC che il comando deve testare. I valori validi sono:

• Server: il comando usa il server locale come endpoint RPC.
• Matrice: il comando cerca un oggetto ClientAccessArray nel sito active directory locale.

Type:	RpcTestType
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RunFromServerId

Il parametro RunFromServerID consente di specificare il server in cui deve essere eseguito il test.

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

-TimeOutSeconds

Il parametro TimeOutSeconds specifica il periodo di timeout in secondi prima che il probe sia terminato. Il valore predefinito è 30 secondi. È possibile immettere le cifre con o senza l'uso delle virgolette. Il valore 10 o "10" funzionerà. Qualunque errore di input torna indietro di 30 secondi.

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

-TotalTimeoutInMinutes

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro TotalTimeoutInMinutes specifica il limite di tempo, espresso in minuti, per consentire al comando di attendere i risultati del test prima di terminare la richiesta. Il valore predefinito è di due minuti.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TrustAnySslCert

Questo parametro è disponibile solo in Exchange Server 2010.

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

-WhatIf

Questo parametro è disponibile solo in Exchange Server 2010.

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

-WSTestType

Questo parametro è disponibile solo in Exchange Server 2010.

Il parametro WSTestType consente di specificare il tipo di server da includere nel test di connettività di Outlook. È possibile utilizzare i seguenti valori:

• Sconosciuto (valore predefinito).
• Interno
• Esterno

Type:	VirtualDirectoryUriScope
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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.