Test-ActiveSyncConnectivity

Questo cmdlet è disponibile solo in Exchange locale.

Usare il cmdlet Test-ActiveSyncConnectivity per verificare la connettività alle directory virtuali di Microsoft Exchange ActiveSync.

Nota: questo cmdlet funziona meglio in Exchange 2010. Nelle versioni successive di Exchange, la funzionalità di questo cmdlet è stata sostituita da Disponibilità gestita. Per risultati ottimali, usare il cmdlet Invoke-MonitoringProbe e specificare il probe del monitor attivo pertinente invece di usare questo cmdlet.

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

Sintassi

Default (Impostazione predefinita)

Test-ActiveSyncConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [[-URL] <String>]
    [-AllowUnsecureAccess]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-LightMode]
    [-MailboxCredential <PSCredential>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-MonitoringInstance <String>]
    [-ResetTestAccountCredentials]
    [-Timeout <UInt32>]
    [-TrustAnySSLCertificate]
    [-UseAutodiscoverForClientAccessServer]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-ActiveSyncConnectivity verifica Exchange ActiveSync connettività connettendosi a una directory virtuale Exchange ActiveSync specificata, a qualsiasi directory virtuale Exchange ActiveSync in un server Exchange specificato o a qualsiasi Exchange ActiveSync directory virtuali 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 di Exchange a cui si è connesso il client.
  • LocalSite: il nome del sito Active Directory locale.
  • Scenario: le operazioni che vengono testate. I valori validi sono Options, FolderSync, First Sync, GetItemEstimate, Sync Data, Ping e Sync Test Item.
  • Risultato: i valori restituiti sono in genere Success, Ignorato o Failure.
  • Latenza (MS): Il tempo necessario per completare il test in millisecondi.
  • Errore: qualsiasi messaggio di errore rilevato.

Puoi scrivere i risultati in un file inviando l'output tramite pipe a ConvertTo-Html e Set-Content. Ad esempio: Test-ActiveSyncConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\EAS Test.html".

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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-ActiveSyncConnectivity -ClientAccessServer MBX01

In questo esempio viene verificata la connettività client di Exchange ActiveSync per il server denominato MBX01.

Esempio 2

Test-ActiveSyncConnectivity -UseAutodiscoverForClientAccessServer $true -URL "https://contoso.com/mail" -MailboxCredential (Get-Credential pauls@contoso.com)

In questo esempio viene verificata la connettività di Exchange ActiveSync per la cassetta postale PaulS utilizzando l'URL di individuazione automatica.

Parametri

-AllowUnsecureAccess

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione AllowUnsecureAccess consente di continuare il test su un canale non protetto che non richiede TLS (Transport Layer Security). Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ClientAccessServer

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro ClientAccessServer consente di specificare 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 Url.

Proprietà dei parametri

Tipo:ServerIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LightMode

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 solo il test di Options.

Se non si utilizza questa opzione, vengono eseguiti i test di First Sync, GetItemEstimate, Sync Data, Ping e Sync Test Item.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MailboxCredential

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro MailboxCredential consente di specificare le credenziali della cassetta postale da utilizzare 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.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MailboxServer

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro MailboxServer consente di specificare il server Cassette postali di Exchange che si desidera 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 utilizza questo parametro, vengono verificate le connessioni a tutti i server Cassette postali nel sito Active Directory locale.

Proprietà dei parametri

Tipo:ServerIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MonitoringContext

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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, gli eventi di monitoraggio e i contatori delle prestazioni vengono inclusi nei risultati quando l'output viene passato a Microsoft Surface Headphones (SCOM).

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MonitoringInstance

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro MonitoringInstance specifica un identificatore per questa attività quando il test viene eseguito da Microsoft Surface Headphones (SCOM). Questo parametro è importante perché SCOM potrebbe eseguire più istanze del test dallo stesso server contemporaneamente.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResetTestAccountCredentials

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Timeout

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro Timeout consente di specificare il tempo di attesa (in secondi) per la ricezione di una risposta dal comando.

Proprietà dei parametri

Tipo:UInt32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TrustAnySSLCertificate

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione TrustAnySSLCertificate consente a Exchange di accettare certificati da autorità di certificazione (CA) 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-URL

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Il parametro URL consente di specificare l'URL utilizzato per connettersi alla directory virtuale di Exchange ActiveSync.

Non è possibile utilizzare questo parametro con il parametro ClientAccessServer.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseAutodiscoverForClientAccessServer

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione UseAutodiscoverForClientAccessServer specifica se il test deve utilizzare il servizio di individuazione automatica per individuare la directory virtuale di Exchange ActiveSync. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.