Test-MAPIConnectivity
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.
Mithilfe des Cmdlets Test-MapiConnectivity können Sie die Serverfunktionalität überprüfen, indem Sie sich bei dem von Ihnen angegebenen Postfach anmelden. Wenn Sie kein Postfach angeben, meldet sich das Cmdlet bei dem Systempostfach in der von Ihnen angegebenen Datenbank an.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
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>]
Beschreibung
Mit dem Cmdlet Test-MapiConnectivity überprüfen Sie die Serverfunktionalität. Dieses Cmdlet meldet sich bei dem von Ihnen angegebenen Postfach an (oder bei dem Systempostfach, wenn Sie den Parameter Identity nicht angeben), und ruft eine Liste der Elemente im Posteingang ab. Durch das Anmelden beim Postfach werden zwei kritische Protokolle getestet, die verwendet werden, wenn ein Client eine Verbindung mit einem Postfachserver herstellt: MAPI und LDAP. Während der Authentifizierung überprüft das Cmdlet Test-MapiConnectivity indirekt, ob der MAPI-Server, der Exchange-Speicher und der Verzeichnisdienstzugriff (DSAccess) funktionieren.
Das Cmdlet meldet sich bei dem von Ihnen angegebenen Postfach mit den Anmeldeinformationen des Kontos an, mit dem Sie auf dem lokalen Computer angemeldet sind. Im Anschluss an eine erfolgreiche Authentifizierung greift das Cmdlet Test-MapiConnectivity auf das Postfach zu, um zu überprüfen, ob die Datenbank funktioniert. Wenn eine erfolgreiche Verbindung mit einem Postfach hergestellt wird, ermittelt das Cmdlet zusätzlich die Zeit, zu der der Anmeldeversuch unternommen wurde.
Es gibt drei verschiedene Parameter, die Sie mit dem Befehl verwenden können: Datenbank, Identität und Server:
- Der Parameter Database akzeptiert eine Datenbankidentität und testet, ob eine Anmeldung bei dem Systempostfach in der angegebenen Datenbank möglich ist.
- Der Parameter Identity akzeptiert eine Postfachidentität und testet, ob eine Anmeldung bei einem bestimmten Postfach möglich ist.
- Der Parameter Server akzeptiert eine Serveridentität und testet, ob eine Anmeldung bei jedem Systempostfach auf dem angegebenen Server möglich ist.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Test-MapiConnectivity -Server "Server01"
In diesem Beispiel wird die Verbindung mit dem Server "Server01" getestet.
Beispiel 2
Test-MapiConnectivity -Identity "midwest\john"
In diesem Beispiel wird die Verbindung mit einem Postfach, das als Domänenname und Benutzername angegeben wurde, getestet.
Parameter
-ActiveDirectoryTimeout
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter ActiveDirectoryTimeout gibt die Zeitspanne in Sekunden an, die für jeden Active Directory-Vorgang zulässig ist, bevor ein Timeout für den Vorgang auftritt. Der Standardwert ist 15 Sekunden.
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
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Parameter AllConnectionsTimeout gibt die Zeitdauer in Sekunden an, die für den Abschluss aller Verbindungen zulässig ist, bevor für das Cmdlet ein Timeout auftritt. Der Timeout-Countdown beginnt erst, wenn alle informationen, die zum Herstellen der Verbindungen erforderlich sind, aus Active Directory gesammelt wurden. Der Standardwert ist 90 Sekunden.
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
Der Schalter Archiv gibt an, ob die MAPI-Konnektivität des persönlichen Archivs getestet werden soll, das dem angegebenen Postfach zugeordnet ist. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diesen Schalter nicht verwenden, wird nur das primäre Postfach getestet.
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
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false
. - Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
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
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter CopyOnServer gibt den Postfachserver an, auf dem die zu testde Datenbankkopie gespeichert ist. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- FQDN
- Distinguished Name (DN)
- Exchange-Legacy-DN
Sie können diesen Parameter nur mit dem Server-Parameter verwenden, nicht mit den Parametern Identify oder 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
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter Database gibt die Datenbank an, auf der die Konnektivität mit dem Systempostfach getestet werden soll. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Wenn Sie diesen Parameter oder den Identity-Parameter nicht verwenden, testet der Befehl systemMailbox auf jeder aktiven Datenbank auf dem Exchange-Server (dem lokalen Exchange-Server oder dem Server, den Sie mit dem Server-Parameter angeben).
Sie können die Parameter Identity, Database oder Server nicht im gleichen Befehl verwenden.
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
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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
Der Parameter Identity gibt ein zu testendes Postfach an. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Dieses Cmdlet akzeptiert Pipelineeingaben vom Get-Mailbox- oder Get-Recipient-Cmdlet. Wenn Sie die Identifizierung aus dem Get-Mailbox- oder Get-Recipient-Cmdlets übergeben, müssen Sie diesen Parameter nicht verwenden.
Wenn Sie diesen Parameter nicht verwenden, testet das Cmdlet systemMailbox für die von Ihnen angegebene Datenbank.
Sie können die Parameter Identity, Database oder Server nicht im gleichen Befehl verwenden.
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
Dieser Parameter ist im lokalen Exchange verfügbar.
Der IncludePassive-Switch testet die MAPI-Konnektivität von allen aktiven und passiven Datenbankkopien. Sie müssen bei dieser Option keinen Wert angeben.
Wenn Sie diesen Schalter nicht verwenden, testet der Befehl die MAPI-Konnektivität nur aus aktiven Datenbankkopien.
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
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter MonitoringContext gibt an, ob zugehörige Überwachungsereignisse und Leistungsindikatoren in den Ergebnissen verwendet werden sollen. Gültige Werte sind:
- $true: Überwachungsereignisse und Leistungsindikatoren sind in den Befehlsergebnissen enthalten. In der Regel sind Überwachungsereignisse und Leistungsindikatoren in den Ergebnissen eingeschlossen, wenn die Ausgabe an den Microsoft System Center Operations Manager (SCOM) übergeben wird.
- $false: Überwachungsereignisse und Leistungsindikatoren sind nicht in den Befehlsergebnissen enthalten. Dies ist der Standardwert.
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
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter PerConnectionTimeout gibt den Zeitraum in Sekunden an, den das erfolgreiche Herstellen einer Verbindung dauern darf, bevor es zum Timeout der Verbindung kommt. Die Standardeinstellung ist 10 Sekunden.
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
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Parameter Server gibt den Server an, auf dem die MAPI-Verbindung getestet werden soll. Der Befehl testet die MAPI-Verbindung mit jedem Systempostfach in aktiven Datenbanken auf dem angegebenen Server. Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:
- Name
- FQDN
- Distinguished Name (DN)
- Exchange-Legacy-DN
Wenn Sie diesen Parameter nicht angeben, prüft der Befehl das Postfach auf dem lokalen Server.
Sie können die Parameter Identity, Database oder Server nicht im gleichen Befehl verwenden.
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
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
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 |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.