Freigeben über


Get-MailboxStatistics

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.

Verwenden Sie das Cmdlet Get-MailboxStatistics, um Informationen zu einem Postfach zurückzugeben, z. B. die Größe des Postfachs, die Anzahl der darin enthaltenen Nachrichten und den zeitpunkt des letzten Zugriffs. Darüber hinaus erhalten Sie den Verschiebungsverlauf oder Verschiebungsbericht einer abgeschlossenen Verschiebungsanforderung.

Hinweis: In Exchange Online PowerShell wird empfohlen, anstelle dieses Cmdlets das Cmdlet Get-EXOMailboxStatistics zu verwenden. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Exchange Online PowerShell.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-MailboxStatistics
   -Database <DatabaseIdParameter>
   [[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-IncludeSoftDeletedRecipients]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   -Server <ServerIdParameter>
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludePassive]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]

Beschreibung

Nur auf Postfachservern können Sie das Cmdlet Get-MailboxStatistics ohne Parameter verwenden. In diesem Fall können Sie mit dem Cmdlet die Statistik für alle Postfächer aller Datenbanken auf dem lokalen Server zurückgeben.

Das cmdlet Get-MailboxStatistics erfordert mindestens einen der folgenden Parameter, um erfolgreich abzuschließen: Server, Datenbank oder Identität.

Mit dem Cmdlet Get-MailboxStatistics können Sie den detaillierten Verschiebungsverlauf und einen Verschiebungsbericht für abgeschlossene Verschiebungsanforderungen zurückgeben, um Probleme einer Verschiebungsanforderung zu behandeln. Sie müssen zum Anzeigen des Verschiebungsverlaufs dieses Cmdlet als ein Objekt übergeben. Verschiebungsverläufe werden in der Postfachdatenbank beibehalten und inkrementell nummeriert, und die zuletzt ausgeführte Verschiebungsanforderung ist immer mit 0 nummeriert. Weitere Informationen finden Sie in "Beispiel 7," "Beispiel 8" und "Beispiel 9" in diesem Thema.

Es werden nur Verschiebungsberichte und Verschiebungsverläufe für abgeschlossene Verschiebungsanforderungen angezeigt.

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

Get-MailboxStatistics -Identity AylaKol

In diesem Beispiel wird die Postfachstatistik für das Postfach des Benutzers Ayla Kol mithilfe seines zugehörigen Alias AylaKol abgerufen.

Beispiel 2

Get-MailboxStatistics -Server MailboxServer01

In diesem Beispiel wird die Postfachstatistik für alle Postfächer auf dem Server "MailboxServer01" abgerufen.

Beispiel 3

Get-MailboxStatistics -Identity contoso\chris

In diesem Beispiel wird die Postfachstatistik für das angegebene Postfach abgerufen.

Beispiel 4

Get-MailboxStatistics -Database "Mailbox Database"

In diesem Beispiel wird die Postfachstatistik für alle Postfächer in der angegebenen Postfachdatenbank abgerufen.

Beispiel 5

Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'

In diesem Beispiel wird die Postfachstatistik für die nicht verbundenen Postfächer aller Postfachdatenbanken in der Organisation abgerufen. Der Operator -ne bedeutet "ungleich".

Beispiel 6

Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d

In diesem Beispiel wird die Postfachstatistik für ein einzelnes nicht verbundenes Postfach abgerufen. Der Wert für den Parameter StoreMailboxIdentity ist die Postfach-GUID des nicht verbundenen Postfachs. Sie können auch den LegacyDN verwenden.

Beispiel 7

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

In diesem Beispiel wird die Zusammenfassung des Verschiebungsverlaufs für die abgeschlossene Verschiebungsanforderung für das Postfach von "Ayla Kol" zurückgegeben. Wenn Sie die Ausgabe nicht über eine Pipeline an das Cmdlet Format-List übergeben, wird der Verschiebungsverlauf nicht angezeigt.

Beispiel 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory

$temp.MoveHistory[0]

In diesem Beispiel wird der detaillierte Verschiebungsverlauf für die abgeschlossene Verschiebungsanforderung für das Postfach von "Ayla Kol" zurückgegeben. In diesem Beispiel wird eine temporäre Variable verwendet, um das Postfachstatistik-Objekt zu speichern. Wenn das Postfach mehrere Male verschoben wurde, sind mehrere Verschiebungsberichte verfügbar. Der letzte Verschiebungsbericht ist immer MoveReport[0].

Beispiel 9

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport

$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv

In diesem Beispiel wird der detaillierte Verschiebungsverlauf und ein ausführlicher, detaillierter Verschiebungsbericht für das Postfach von "Ayla Kol" zurückgegeben. In diesem Beispiel wird eine temporäre Variable verwendet, um das Verschiebungsanforderungs-Statistikobjekt und die Ausgaben des Verschiebungsberichts in eine CSV-Datei zu speichern.

Parameter

-Archive

Der Schalter Archiv gibt an, ob Postfachstatistiken für das Archivpostfach zurückgegeben werden sollen, das dem Postfach zugeordnet ist. Sie müssen keinen Wert für diese Option angeben.

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

-CopyOnServer

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter CopyOnServer wird verwendet, um Statistiken aus einer bestimmten Datenbankkopie auf dem angegebenen Server abzurufen.

Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:

  • Name
  • FQDN
  • Distinguished Name (DN)
  • Exchange-Legacy-DN

Exchange-Legacy-DN

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 Database-Parameter gibt Statistiken für alle Postfächer in der angegebenen Datenbank zurück. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:

  • Name
  • Distinguished Name (DN)
  • GUID

Dieser Parameter akzeptiert Pipelineeingaben vom Cmdlet Get-MailboxDatabase.

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

-Filter

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter Filter verwendet die OPATH-Syntax, um die Ergebnisse nach den angegebenen Eigenschaften und Werten zu filtern. Das Suchkriterium verwendet die Syntax "Property -ComparisonOperator 'Value'".

  • Schließen Sie den gesamten OPATH-Filter in doppelte Anführungszeichen " ein. Wenn der Filter Systemwerte enthält (z. B. $true, $falseoder $null), verwenden Sie stattdessen einfache Anführungszeichen ''. Obwohl dieser Parameter eine Zeichenfolge ist (kein Systemblock), können Sie auch geschweifte Klammern { } verwenden, jedoch nur, wenn der Filter keine Variablen enthält.
  • Eigenschaft ist eine filterbare Eigenschaft.
  • ComparisonOperator ist ein OPATH-Vergleichsoperator (z. B -eq . für gleich und -like für den Zeichenfolgenvergleich). Weitere Informationen über Vergleichsoperatoren finden Sie unter about_Comparison_Operators.
  • Wert ist der zu suchende Eigenschaftswert. Fügen Sie Textwerte und Variablen in einfache Anführungszeichen ('Value' oder '$Variable') ein. Wenn ein Variablenwert einfache Anführungszeichen enthält, müssen Sie die einfachen Anführungszeichen identifizieren (escape), um die Variable korrekt zu erweitern. Sie können z. B. '$($User -Replace "'","''")' anstelle von '$User' verwenden. Schließen Sie keine ganzen Zahlen oder Systemwerte in Anführungszeichen ein (verwenden Sie stattdessen beispielsweise 500$true, $false oder $null).

Sie können mehrere Suchkriterien mithilfe der logischen Operatoren -and und -or miteinander verketten. Zum Beispiel "Criteria1 -and Criteria2" oder "(Criteria1 -and Criteria2) -or Criteria3".

Ausführliche Informationen zu OPATH-Filtern in Exchange finden Sie unter Zusätzliche Informationen zur OPATH-Syntax.

Verwenden Sie beispielsweise die folgende Syntax, um alle getrennten Postfächer in einer bestimmten Postfachdatenbank anzuzeigen: 'DisconnectDate -ne $null'.

Type:String
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

-Identity

Der Parameter Identity gibt das Postfach an, für das Sie Statistiken zurückgeben möchten. 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)
Type:GeneralMailboxOrMailUserIdParameter
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

-IncludeMoveHistory

Die Option IncludeMoveHistory gibt an, ob zusätzliche Informationen zum Postfach, das den Verlauf einer abgeschlossenen Verschiebungsanforderung enthält, z. B. Status, Flags, Zieldatenbank, ungültige Elemente, Startzeiten, Endzeiten, Dauer der Verschiebungsanforderung in verschiedenen Phasen und Fehlercodes, zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

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

-IncludeMoveReport

Die Option IncludeMoveReport gibt an, ob ein ausführlicher, detaillierter Verschiebungsbericht für eine abgeschlossene Verschiebungsanforderung, z. B. Serververbindungen und Verschiebungsphasen, zurückgegeben werden sollen. Sie müssen keinen Wert für diese Option angeben.

Da die Ausgabe dieses Befehls ausführlich ist, müssen Sie die Ausgabe an eine CSV-Datei senden, um eine einfachere Analyse durchzuführen.

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

-IncludePassive

Dieser Parameter ist im lokalen Exchange verfügbar.

Der IncludePassive-Schalter gibt an, ob Statistiken aus allen aktiven und passiven Datenbankkopien zurückgegeben werden sollen. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie diesen Schalter nicht verwenden, ruft der Befehl statistiken nur aus aktiven Datenbankkopien ab.

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

-IncludeQuarantineDetails

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Schalter IncludeQuarantineDetails gibt an, ob zusätzliche Quarantändedetails zum Postfach zurückgegeben werden sollen, die andernfalls nicht in den Ergebnissen vorhanden wären. Verwenden Sie diese Details zum Festlegen, wann und warum das Postfach in Quarantäne gestellt wurde. Sie müssen bei dieser Option keinen Wert angeben.

Insbesonder gibt dieser Schalter die werte der Eigenschaften QuarantineDescription, QuarantineLastCrash und QuarantineEnd des Postfachs zurück. Sie müssen ein Formatierungs-Cmdlet verwenden, damit diese Werte angezeigt werden. Beispiel: Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*.

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

-IncludeSoftDeletedRecipients

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Die Option IncludeSoftDeletedRecipients gibt an, ob die vorläufig gelöschten Empfänger in die Ergebnisse einbezogen werden sollen. Sie müssen keinen Wert für diese Option angeben.

Vorläufig gelöschte Postfächer sind gelöschte Postfächer, die noch wiederhergestellt werden können.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-NoADLookup

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Schalter NoADLookup gibt an, dass Informationen aus der Postfachdatenbank und nicht aus Active Directory abgerufen werden. Sie müssen bei dieser Option keinen Wert angeben.

Dieser Schalter trägt zur Verbesserung der Cmdlet-Leistung beim Abfragen einer Postfachdatenbank bei, die eine große Anzahl von Postfächern enthält.

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

-Server

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter Server gibt den Server an, von dem Sie die Postfachstatistik erhalten möchten. Einer der folgenden Werte kann verwendet werden:

  • Vollqualifizierter Domänenname (FQDN)
  • NetBIOS-Name

Wenn Sie einen Wert für den Parameter Server angeben, gibt der Befehl die Statistik für alle Postfächer aller Datenbanken, einschließlich Wiederherstellungsdatenbanken, auf dem angegebenen Server zurück. Wenn Sie diesen Parameter nicht angeben, gibt der Befehl die Anmeldestatistik für den lokalen Server zurück.

Type:ServerIdParameter
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

-StoreMailboxIdentity

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter StoreMailboxIdentity gibt die Postfachidentität an, wenn er zusammen mit dem Parameter Database verwendet wird, um Statistiken für ein einzelnes Postfach in der angegebenen Datenbank zurückzugeben. Sie können einen der folgenden Werte verwenden:

  • MailboxGuid
  • LegacyDN

Verwenden Sie diese Syntax, um Informationen zu getrennten Postfächern abzurufen, die nicht über ein entsprechendes Active Directory-Objekt verfügen oder über ein entsprechendes Active Directory-Objekt verfügen, das nicht auf das getrennte Postfach in der Postfachdatenbank verweist.

Type:StoreMailboxIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.