Get-MailboxFolderStatistics

Modul:

Exchange PowerShell

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen können für die eine oder die andere Umgebung exklusiv sein.

Verwenden Sie das Cmdlet Get-MailboxFolderStatistics, um Informationen zu Ordnern in einem bestimmten Postfach abzurufen, wie zum Beispiel die Anzahl und Größe von Elementen in einem Ordner, der Name und die ID eines Ordners sowie sonstige Informationen.

Hinweis: In Exchange Online PowerShell empfehlen wir die Verwendung des Cmdlets "Get-EXOMailboxFolderStatistics" statt dieses Cmdlets. 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

Identity

Get-MailboxFolderStatistics
    [-Identity] <GeneralMailboxOrMailUserIdParameter>
    [-Archive]
    [-DiagnosticInfo <String>]
    [-DomainController <Fqdn>]
    [-FolderScope <ElcFolderType>]
    [-IncludeAnalysis]
    [-IncludeOldestAndNewestItems]
    [-IncludeSoftDeletedRecipients]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [-UseCustomRouting]
    [<CommonParameters>]

AuditLog

Get-MailboxFolderStatistics
    [[-Identity] <GeneralMailboxOrMailUserIdParameter>]
    [-AuditLog]
    [-DiagnosticInfo <String>]
    [-DomainController <Fqdn>]
    [-FolderScope <ElcFolderType>]
    [-IncludeAnalysis]
    [-IncludeOldestAndNewestItems]
    [-IncludeSoftDeletedRecipients]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [<CommonParameters>]

Database

Get-MailboxFolderStatistics
    -Database <DatabaseIdParameter>
    -StoreMailboxIdentity <StoreMailboxIdParameter>
    [-DiagnosticInfo <String>]
    [-FolderScope <ElcFolderType>]
    [-IncludeAnalysis]
    [-IncludeOldestAndNewestItems]
    [-IncludeSoftDeletedRecipients]
    [-ResultSize <Unlimited>]
    [-SkipCount <Int32>]
    [<CommonParameters>]

Beschreibung

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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.

Ein Postfach kann über ausgeblendete Elemente verfügen, die niemals für den Benutzer sichtbar sind und ausschließlich von Anwendungen verwendet werden. Das Cmdlet Get-MailboxFolderStatistics kann ausgeblendete Elemente für die folgenden Werte zurückgeben: "FolderSize", "FolderAndSubfolderSize", "ItemsInFolder" und "ItemsInFolderAndSubfolders".

Verwechseln Sie das Cmdlet Get-MailboxFolderStatistics nicht mit dem Cmdlet Get-MailboxStatistics.

Beispiele

Beispiel 1

Get-MailboxFolderStatistics -Identity contoso\chris

In diesem Beispiel wird der Parameter FolderScope nicht angegeben, sodass alle Informationen zum Benutzer "Chris" in der Domäne "Contoso" abgerufen werden.

Beispiel 2

Get-MailboxFolderStatistics -Identity Chris -FolderScope Calendar

In diesem Beispiel wird der Parameter FolderScope verwendet, um die Statistiken für Kalenderordner für den Benutzer "Chris" anzuzeigen.

Beispiel 3

Get-MailboxFolderStatistics -Identity Ayla@contoso.com -Archive

In diesem Beispiel wird die Option Archive verwendet, um die Statistik für das Archiv von Benutzerin "Ayla" anzuzeigen.

Beispiel 4

Get-MailboxFolderStatistics -Identity "Tony" -FolderScope RecoverableItems -IncludeAnalysis

In diesem Beispiel wird die Option IncludeAnalysis verwendet, um die Statistik für den Ordner "Wiederherstellbare Elemente" des Benutzers "Tony" anzuzeigen.

Beispiel 5

$All = Get-Mailbox -ResultSize Unlimited

$All | foreach {Get-MailboxFolderStatistics -Identity $_.Identity -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize}

In diesem Beispiel wird der Parameter FolderScope verwendet, um die Statistiken zum Posteingangsordner für alle Postfächer anzuzeigen.

Parameter

-Archive

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Die Option Archive gibt an, ob die Verwendungsstatistik für das dem Postfach oder E-Mail-Benutzer zugeordnete Archiv zurückgegeben werden. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Identity

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-AuditLog

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Dieser Parameter ist im lokalen Exchange verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

AuditLog

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Database

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:	DatabaseIdParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Database

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DiagnosticInfo

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Sie sollten den DiagnosticArgument-Parameter nur verwenden, wenn Sie vom Microsoft-Kundendienst und -Support dazu aufgefordert werden.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DomainController

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:	Fqdn
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Identity

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

AuditLog

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-FolderScope

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der Parameter FolderScope gibt den Bereich für die Suche nach Ordnertyp an. Gültige Parameterwerte sind:

• Alle
• Archive: Exchange 2016 oder höher.
• Kalender
• Kontakte
• ConversationHistory
• DeletedItems
• Entwürfe
• Posteingang
• JunkEmail
• Journal
• LegacyArchiveJournals: Exchange 2013 oder höher.
• ManagedCustomFolder: gibt die Ausgabe für alle verwalteten benutzerdefinierten Ordner zurück.
• NonIpmRoot: Exchange 2013 oder höher.
• Notizen
• Postausgang
• Persönlich
• RecoverableItems: gibt die Ausgabe für den Ordner "Wiederherstellbare Elemente" und die Unterordner "Deletions", "DiscoveryHolds", "Purges" und "Versions" zurück.
• RssSubscriptions
• SentItems
• SyncIssues
• Aufgaben

Parametereigenschaften

Typ:	ElcFolderType
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Der Parameter "Identity" gibt die Identität des Postfachs oder E-Mail-Benutzers an. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach oder den E-Mail-Benutzer eindeutig kennzeichnet. Zum 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)

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

Typ:	GeneralMailboxOrMailUserIdParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Identity

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

AuditLog

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludeAnalysis

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Die Option IncludeAnalysis gibt an, ob alle Elemente in einem Ordner überprüft werden und eine Statistik in Bezug auf Ordner- und Elementgröße zurückgegeben wird. Sie müssen keinen Wert für diese Option angeben.

Sie sollten diese Option zur Problembehandlung verwenden, da der Befehl eine lange Zeit in Anspruch nehmen kann.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-IncludeOldestAndNewestItems

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Die Option IncludeOldestAndNewestItems gibt an, ob die Datumsangaben der ältesten und neuesten Elemente in jedem Ordner zurückgegeben werden. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-IncludeSoftDeletedRecipients

Anwendbar: Exchange Online

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.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-ResultSize

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Parametereigenschaften

Typ:	Unlimited
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-SkipCount

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill SkipCount Description }}

Parametereigenschaften

Typ:	Int32
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-StoreMailboxIdentity

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:	StoreMailboxIdParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

Database

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-UseCustomRouting

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill UseCustomRouting Description }}

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.