Test-MAPIConnectivity

Modulo:: Exchange PowerShell

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

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 sul database specificato.

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

Sintassi

Database

Test-MAPIConnectivity
    -Database <DatabaseIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Identity

Test-MAPIConnectivity
    [-Identity] <MailboxIdParameter>
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Archive]
    [-Confirm]
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Server

Test-MAPIConnectivity
    [-Server <ServerIdParameter>]
    [-ActiveDirectoryTimeout <Int32>]
    [-AllConnectionsTimeout <Int32>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IncludePassive]
    [-MonitoringContext <Boolean>]
    [-PerConnectionTimeout <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-MapiConnectivity consente di 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. L'accesso alla cassetta postale consente di verificare 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) funzionino.

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 parametri distinti che è possibile usare con il comando: Database, Identità 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.

È 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-MapiConnectivity -Server "Server01"

Con questo esempio viene verificata la connettività al server Server01.

Esempio 2

Test-MapiConnectivity -Identity "midwest\john"

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

Parametri

-ActiveDirectoryTimeout

Questo parametro è disponibile solo in Exchange locale.

Il parametro ActiveDirectoryTimeout consente di specificare la quantità di tempo in secondi consentito per il completamento di ogni operazione di Active Directory prima del timeout dell'operazione. Il valore predefinito è 15 secondi.

Proprietà dei parametri

Tipo:	Int32
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

-AllConnectionsTimeout

Questo parametro è disponibile solo in Exchange locale.

Il parametro AllConnectionsTimeout consente di specificare la quantità di tempo in secondi consentita per il completamento di tutte le connessioni prima del timeout del cmdlet. Il conto alla rovescia del timeout non inizia finché non vengono raccolte tutte le informazioni necessarie per eseguire le connessioni da Active Directory. Il valore predefinito è 90 secondi.

Proprietà dei parametri

Tipo:	Int32
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

-Archive

L'opzione Archivio consente di specificare se testare la connettività MAPI dell'archivio personale associato alla cassetta postale specificata. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, viene testata solo la cassetta postale principale.

Proprietà dei parametri

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

Set di parametri

Identity

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

-Confirm

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

-CopyOnServer

Questo parametro è disponibile solo in Exchange locale.

Il parametro CopyOnServer consente di specificare il server Cassette postali che contiene la copia specifica del database da testare. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

Nome
FQDN
Nome distinto (DN)
DN legacy di Exchange

È possibile utilizzare questo parametro solo con il parametro Server, non con i parametri Identify o Database.

Proprietà dei parametri

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

Set di parametri

Database

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

Identity

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

-Database

Questo parametro è disponibile solo in Exchange locale.

Il parametro Database consente di specificare il database su cui verificare la connettività della cassetta postale del sistema. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

Nome
Nome distinto (DN)
GUID

Se non si utilizza questo parametro o il parametro Identity, il comando testa SystemMailbox in ogni database attivo nel server Exchange (il server Exchange locale o il server specificato con il parametro Server).

Non è possibile usare i parametri di identità, database o server nello stesso comando.

Proprietà dei parametri

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

Set di parametri

Database

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

-DomainController

Questo parametro è disponibile solo in Exchange locale.

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

-Identity

Il parametro Identity specifica la cassetta postale da verificare. È 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)

Questo cmdlet accetta l'input della pipeline dal cmdlet Get-Mailbox o Get-Recipient. Se si reindirizza l'identificativo dai cmdlet Get-Mailbox o Get-Recipient, non è necessario usare questo parametro.

Se non si usa questo parametro, il cmdlet testa SystemMailbox nel database specificato.

Non è possibile usare i parametri di identità, database o server nello stesso comando.

Proprietà dei parametri

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

Set di parametri

Identity

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

-IncludePassive

Questo parametro è disponibile solo in Exchange locale.

L'opzione IncludePassive verifica la connettività MAPI da tutte le copie di database attive e passive. Con questa opzione non è necessario specificare alcun valore.

Se non si usa questa opzione, il comando testa la connettività MAPI solo dalle copie del database attive.

Proprietà dei parametri

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

Set di parametri

Server

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

-MonitoringContext

Questo parametro è disponibile solo in Exchange locale.

Il parametro MonitoringContext consente di specificare se includere gli eventi di monitoraggio e i contatori delle prestazioni associati nei risultati. I valori validi sono:

$true: gli eventi di monitoraggio e i contatori delle prestazioni sono inclusi nei risultati del comando. 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).
$false: gli eventi di monitoraggio e i contatori delle prestazioni non sono inclusi nei risultati del comando. Questo è il valore predefinito.

Proprietà dei parametri

Tipo:	Boolean
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

-PerConnectionTimeout

Questo parametro è disponibile solo in Exchange locale.

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

Proprietà dei parametri

Tipo:	Int32
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

-Server

Questo parametro è disponibile solo in Exchange locale.

Il parametro Server consente di specificare il server su cui testare la connettività MAPI. Il comando verificherà la connettività MAPI di ogni cassetta postale del sistema sui database attivi sul server specificato. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

Nome
FQDN
Nome distinto (DN)
DN legacy di Exchange

Se non si specifica questo parametro, il comando controlla la cassetta postale sul server locale.

Non è possibile usare i parametri di identità, database o server nello stesso comando.

Proprietà dei parametri

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

Set di parametri

Server

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

-WhatIf

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.

Commenti e suggerimenti

Questa pagina è stata utile?