Test-WebServicesConnectivity
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Test-WebServicesConnectivity per testare la connettività client alle directory virtuali di Servizi Web 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-WebServicesConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-AllowUnsecureAccess]
[-Confirm]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-UseAutodiscoverForClientAccessServer]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
-AutoDiscoverServer <ClientAccessServerIdParameter>
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-MonitoringContext]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Test-WebServicesConnectivity
[[-Identity] <MailboxIdParameter>]
[-ClientAccessServer <ClientAccessServerIdParameter>]
[-Confirm]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Descrizione
Il cmdlet Test-WebServicesConnectivity testa la connettività di Servizi Web Exchange connettendosi a una directory virtuale di Servizi Web Exchange specificata, a qualsiasi directory virtuale di Servizi Web Exchange in un server Exchange specificato o a qualsiasi directory virtuale di Servizi Web Exchange disponibile nel sito 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.
- Origine: server di origine.
- ServiceEndpoint: server di destinazione.
- Scenario: operazioni testate. I valori sono Autodiscover: SOAP Provider e EWS: GetFolder (modalità estesa) oppure EWS: ConvertID (modalità ridotta).
- Risultato: i valori restituiti sono in genere Success o *FAILURE*.
- Latenza(MS): tempo necessario per completare il test in millisecondi
È possibile scrivere i risultati in un file inviando l'output a ConvertTo-Html e Set-Content. Ad esempio: Test-WebServicesConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EWS 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-WebServicesConnectivity -AllowUnsecureAccessIn Exchange 2010 questo esempio testa Servizi Web Exchange nel server Accesso client locale e consente al test di usare una connessione non protetta che non richiede SSL. Viene usato un account di test predefinito.
Esempio 2
Test-WebServicesConnectivity -ClientAccessServer MBX01In questo esempio viene testata la connessione client a Servizi Web Exchange nel server denominato MBX01.
Parametri
-AllowUnsecureAccess
Questo parametro è disponibile solo in Exchange Server 2010.
L'opzione AllowUnsecureAccess specifica se abilitare il comando per continuare l'esecuzione su un canale non protetto che non richiede 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 |
-AutoDiscoverServer
Il parametro AutoDiscoverServer consente di specificare il server nel quale è installato il ruolo del server Accesso Client utilizzato per l'individuazione automatica.
È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:
- È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca, ad esempio:
- Nome (ad esempio, Exchange01)
- DN legacy di Exchange (ad esempio, /o=First Organization/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=Exchange01)
- GUID (ad esempio, bc014a0d-1509-4ecc-b569-f077eec54942)
Non è possibile utilizzare questo parametro con il parametro ClientAccessServer.
| Type: | ClientAccessServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 il parametro AutoDiscoverServer.
| 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 |
-DomainController
Questo parametro è disponibile solo in Exchange Server 2010.
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 |
-Identity
Il parametro Identity consente di specificare la cassetta postale da utilizzare per la verifica. È 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)
Quando si utilizza questo parametro, è necessario utilizzare anche il parametro MailboxCredential.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LightMode
L'opzione LightMode consente di indicare al comando di eseguire solo un sottoinsieme dei test. Con questa opzione non è necessario specificare alcun valore.
Quando si utilizza questa opzione, viene eseguito il test EWS: ConvertId anziché il test EWS: GetFolder.
| 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.
Il parametro è obbligatorio quando si utilizza quello Identity.
| 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 l'identità del server Cassette postali di Exchange in cui viene eseguito il test.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-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: | True |
| 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 |
-Timeout
Il parametro Timeout consente di specificare il tempo di attesa, indicato in secondi, per il completamento dell'operazione di test. Il valore predefinito per il parametro Timeout è 300 secondi. È necessario specificare un valore di timeout maggiore di 0 secondi. È 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 |
-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 |
-UseAutodiscoverForClientAccessServer
Questo parametro è disponibile solo in Exchange Server 2010.
L'opzione UseAutodiscoverForClientAccessServer specifica se il test deve utilizzare il servizio di individuazione automatica per individuare il server Accesso client. 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
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.