Test-PowerShellConnectivity

Riferimento

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-PowerShellConnectivity per testare la connettività client alle directory virtuali remote di PowerShell di Exchange.

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-PowerShellConnectivity
    -ConnectionUri <Uri>
    -TestCredential <PSCredential>
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-ResetTestAccountCredentials]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Test-PowerShellConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-ResetTestAccountCredentials]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-PowerShellConnectivity testa la connettività remota di PowerShell di Exchange connettendosi a una directory virtuale di PowerShell remota specificata, a qualsiasi directory virtuale di PowerShell remota in un server Exchange specificato o a qualsiasi directory virtuale di PowerShell remota disponibile 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. I valori sono: Logon User.
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-PowerShellConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\PowerShell 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.

Esempio

Esempio 1

Test-PowerShellConnectivity -ClientAccessServer MBX2 -VirtualDirectoryName "PowerShell (Default Web Site)" -TrustAnySSLCertificate

Con questo esempio viene verificata la directory virtuale PowerShell (Sito Web predefinito) sul server MBX2. L'opzione TrustAnySSLCertificate consente di ignorare il controllo del certificato durante la connessione.

Esempio 2

$UserCredentials = Get-Credential

Test-PowerShellConnectivity -ConnectionUri https://contoso.com/powershell -TestCredential $UserCredentials -Authentication Basic

In questo esempio viene testata la directory virtuale di PowerShell remota disponibile in https://contoso.com/powershell. Non è prevista una mancata corrispondenza tra il certificato SSL e l'URL; pertanto non viene usata l'opzione TrustAnySSLCertificate. La directory virtuale viene configurata affinché possa utilizzare l'autenticazione di base.

Le credenziali utilizzate per connettersi alla directory virtuale vengono memorizzate nella variabile $UserCredentials. A questo punto, il test viene eseguito nel modo descritto in precedenza.

Parametri

-Authentication

Il parametro Authentication consente di specificare il tipo di autenticazione che viene utilizzato per connettersi. I valori validi sono:

Predefiniti
Basic
Credssp
Del digest
Kerberos
Negoziare

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

-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

Non è possibile utilizzare questo parametro con quello ConnectionUri.

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

-ConnectionUri

Il parametro ConnectionUri consente di specificare l'URL della directory virtuale di PowerShell remota da testare, ad esempio https://contoso.com/powershell.

Non è possibile utilizzare questo parametro con il parametro ClientAccessServer.

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

-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

-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

-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

-TestCredential

Il parametro TestCredential consente di specificare le credenziali da utilizzare per la verifica.

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.

È possibile usare questo parametro solo con il parametro ConnectionUri.

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

-TestType

Il parametro TestType consente di specificare se il comando verificherà gli URL interni o esterni. I valori validi sono Internal e External. Il valore predefinito è Internal.

È possibile utilizzare questo parametro soltanto con il parametro ClientAccessServer.

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

-VirtualDirectoryName

Il parametro VirtualDirectoryName consente di specificare il nome della directory virtuale remota di PowerShell che si desidera verificare. Racchiudere i valori che contengono spazi tra virgolette (").

È possibile utilizzare questo parametro soltanto con il parametro ClientAccessServer. Se non si utilizza questo parametro, vengono verificate tutte le directory virtuali remote PowerShell disponibili nel server.

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

-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.