Test-MAPIConnectivity
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
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
Test-MAPIConnectivity
-Database <DatabaseIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Confirm]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]Test-MAPIConnectivity
[-Identity] <MailboxIdParameter>
[-ActiveDirectoryTimeout <Int32>]
[-AllConnectionsTimeout <Int32>]
[-Archive]
[-Confirm]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-PerConnectionTimeout <Int32>]
[-WhatIf]
[<CommonParameters>]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.
Con il comando è possibile usare tre parametri distinti: 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.
È 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-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 specifica la quantità di tempo, in secondi, consentita per il completamento di ogni operazione di Active Directory prima del timeout dell'operazione. Il valore predefinito è 15 secondi.
| Type: | Int32 |
| 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 |
-AllConnectionsTimeout
Questo parametro è disponibile solo in Exchange locale.
Il parametro AllConnectionsTimeout specifica 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 fino a quando tutte le informazioni necessarie per eseguire le connessioni non vengono raccolte da Active Directory. Il valore predefinito è 90 secondi.
| Type: | Int32 |
| 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 |
-Archive
L'opzione Archivio specifica 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 primaria.
| 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, Exchange Online |
-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, Exchange Online |
-CopyOnServer
Questo parametro è disponibile solo in Exchange locale.
Il parametro CopyOnServer specifica il server Cassette postali che contiene la copia di database specifica 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 usare questo parametro solo con il parametro Server, non con i parametri Identify o Database.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 usa 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 Identity, Database o Server nello stesso comando.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 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.
| 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 |
-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 esegue il pipe dell'identificazione 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 Identity, Database o Server nello stesso comando.
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludePassive
Questo parametro è disponibile solo in Exchange locale.
Il commutatore IncludePassive testa la connettività MAPI da tutte le copie attive e passive del database. Con questa opzione non è necessario specificare alcun valore.
Se non si usa questa opzione, il comando testa solo la connettività MAPI dalle copie attive del database.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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: i risultati del comando includono eventi di monitoraggio e contatori delle prestazioni. 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).
- $false: gli eventi di monitoraggio e i contatori delle prestazioni non sono inclusi nei risultati del comando. Questo è il valore predefinito.
| Type: | Boolean |
| 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 |
-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.
| Type: | Int32 |
| 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 |
-Server
Questo parametro è disponibile solo in Exchange locale.
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 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 Identity, Database o Server nello stesso comando.
| Type: | ServerIdParameter |
| Position: | Named |
| 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 |
-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, Exchange Online |
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
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per