Share via

Test-MapiConnectivity

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-07-05

Utilizzare il cmdlet Test-MapiConnectivity per verificare la funzionalità del server effettuando l'accesso alla cassetta postale specificata. Se non si specifica una cassetta postale, il cmdlet accede a SystemMailbox nel database specificato.

Sintassi

Test-MAPIConnectivity [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Database <DatabaseIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Test-MAPIConnectivity -Identity <MailboxIdParameter> [-ActiveDirectoryTimeout <Int32>] [-AllConnectionsTimeout <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-PerConnectionTimeout <Int32>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Per eseguire il cmdlet Test-MapiConnectivity, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale del server di destinazione.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni. 

Utilizzare il cmdlet Test-MapiConnectivity per verificare la funzionalità del server. Il cmdlet effettua l'accesso alla cassetta postale specificata o a SystemMailbox se non si specifica il parametro Identity e recupera un elenco degli elementi nella Posta in arrivo. Accedendo alla cassetta postale vengono verificati due protocolli critici utilizzati quando un client si connette a un server Cassette postali: MAPI e LDAP. Durante l'autenticazione, il cmdlet Test-MapiConnectivity verifica indirettamente che il server MAPI, l'archivio di Exchange e l'accesso al servizio directory (DSAccess) siano in funzione.

Il cmdlet accede alla cassetta postale specificata utilizzando le credenziali dell'account con cui è stato effettuato l'accesso al computer locale. Quando l'autenticazione viene completata correttamente, il cmdlet Test-MapiConnectivity accede alla cassetta postale per verificare che il database sia in funzione. Se viene effettuata una connessione corretta alla cassetta postale, il cmdlet determina anche il tempo necessario al tentativo di accesso.

Esistono tre diversi parametri che è possibile utilizzare con il comando: Database, Identity e Server.

  • Il parametro Database utilizza l'identità del database e verifica la capacità di accedere alla cassetta postale del sistema sul database specifico.

  • Il parametro Identity utilizza l'identità della cassetta postale e verifica la capacità di accedere a una cassetta postale specifica.

  • Il parametro Server utilizza l'identità del server e verifica la capacità di accedere alla cassetta postale di ogni sistema sul server specifico.

Parametri

Parametro Obbligatorio Tipo Descrizione

Database

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Il parametro Database consente di specificare il database su cui verificare la connettività della cassetta postale del sistema. Se non è specificato questo parametro né il parametro Identity, il comando esegue una verifica di SystemMailbox in ciascun database del server specificato o del server locale se non si specifica il parametro Server.

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Il parametro Identity specifica la cassetta postale da verificare. È possibile utilizzare i seguenti valori:

  • GUID

  • Nome distinto (DN)

  • Dominio\Account

  • Nome dell'entità utente (UPN)

  • DN precedente di Exchange

  • Indirizzo SMTP (Simple Mail Transfer Protocol)

  • Alias

  • Questo parametro accetta l'immissione in pipeline dal cmdlet Get-Mailbox o Get-Recipient. Se un oggetto è reindirizzato dal cmdlet Get-Mailbox o dal cmdlet Get-Recipient, questo parametro non è necessario.

  • Se non si specifica questo parametro, il cmdlet esegue una verifica di SystemMailbox nel database specificato.

ActiveDirectoryTimeout

Facoltativo

System.Int32

Il parametro ActiveDirectoryTimeout specifica il tempo necessario, in secondi, consentito per il completamento di ogni operazione di Active Directory prima del timeout. Il valore predefinito è 15 secondi.

AllConnectionsTimeout

Facoltativo

System.Int32

Il parametro AllConnectionTimeout specifica il tempo necessario, in secondi, consentito per il completamento di tutte le connessioni prima del timeout del cmdlet. Il conto alla rovescia per il timeout non inizia prima che siano state raccolte tutte le informazioni necessarie all'esecuzione delle connessioni da Active Directory. Il valore predefinito è 90 secondi.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Il parametro DomainController specifica il controller di dominio da utilizzare per accedere al servizio directory Active Directory. Utilizzare il nome di dominio completo (FQDN) del controller di dominio che si desidera utilizzare.

MonitoringContext

Facoltativo

System.Boolean

Il parametro MonitoringContext consente di specificare se i risultati del comando includeranno il monitoraggio dei contatori di eventi e prestazioni. I due possibili valori per questo parametro sono $true o $false. Se si specifica $true, i risultati includeranno il monitoraggio dei contatori di eventi e prestazioni oltre alle informazioni sulla transazione MAPI.

PerConnectionTimeout

Facoltativo

System.Int32

Il parametro PerConnectionTimeout specifica il tempo necessario, in secondi, consentito per il completamento di ogni connessione prima del timeout. Il valore predefinito è 10 secondi.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Il parametro Server specifica il server su cui sarà verificata la connettività MAPI. Il comando verificherà la connettività MAPI di ogni cassetta postale del sistema sul server specificato.

Se non si specifica questo parametro, il comando esegue una verifica della cassetta postale sul server locale.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

Nel primo esempio viene verificata la connettività al server Server01.

Nel secondo esempio viene verificata la connettività a una cassetta postale, specificata come nome dominio e nome utente.

Test-MapiConnectivity -Server "Server01"
Test-MapiConnectivity -Identity "midwest\john"