Get-EXOMailboxFolderStatistics
Dieses Cmdlet ist nur im PowerShell-Modul Exchange Online verfügbar. Weitere Informationen finden Sie unter Informationen zum PowerShell-Modul von Exchange Online.
Verwenden Sie das Cmdlet Get-EXOMailboxFolderStatistics, um Informationen zu den Ordnern in einem bestimmten Postfach abzurufen, einschließlich der Anzahl und Größe der Elemente im Ordner, des Ordnernamens und der Ordner-ID sowie weiterer Informationen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Default (Standard)
Get-EXOMailboxFolderStatistics
[-Archive]
[-DiagnosticInfo <String>]
[-ExternalDirectoryObjectId <Guid>]
[-Folderscope <ElcFolderType>]
[-Identity <String>]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-PrimarySmtpAddress <String>]
[-UserPrincipalName <String>]
[<CommonParameters>]
Beschreibung
Ein Postfach kann über ausgeblendete Elemente verfügen, die niemals für den Benutzer sichtbar sind und ausschließlich von Anwendungen verwendet werden. Das Get-EXOMailboxFolderStatistics Cmdlet kann ausgeblendete Elemente für die folgenden Werte zurückgeben: FolderSize, FolderAndSubfolderSize, ItemsInFolder und ItemsInFolderAndSubfolders.
Verwechseln Sie Get-EXOMailboxFolderStatistics Cmdlet (Ordner) nicht mit dem Get-EXOMailboxStatistics Cmdlet (Postfächer).
Beispiele
Beispiel 1
Get-EXOMailboxFolderStatistics -Identity admin@contoso.com
Dieses Beispiel gibt Statistiken für alle Postfachordner zurück. Der Standardwert ist FolderScope All.
Beispiel 2
Get-EXOMailboxFolderStatistics -Identity admin@contoso.com -FolderScope Calendar -IncludeOldestAndNewestItems
Dieses Beispiel gibt Statistiken nur für Kalenderordner zurück.
Beispiel 3
Get-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxFolderStatistics -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize
In diesem Beispiel wird der Parameter FolderScope verwendet, um die Statistiken für Posteingangsordner für alle Postfächer anzuzeigen.
Parameter
-Archive
Anwendbar: Exchange Online
Der Schalter "Archiv" gibt an, ob die Verwendungsstatistiken des Archivpostfachs zurückgegeben werden sollen, das dem Postfach oder E-Mail-Benutzer zugeordnet ist. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie diese Option für ein Postfach verwenden, für das die Archivierung nicht aktiviert ist, wird ein Fehler zurückgegeben.
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 |
-DiagnosticInfo
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.7.0-Preview1 oder höher veraltet.
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 |
-ExternalDirectoryObjectId
Anwendbar: Exchange Online
Der Parameter ExternalDirectoryObjectId identifiziert das Postfach, das Sie anzeigen möchten, anhand der ObjectId in Microsoft Entra ID.
Sie können diesen Parameter nicht mit den Parametern Identity, PrimarySmtpAddress oder UserPrincipalName verwenden.
Parametereigenschaften
| Typ: | Guid |
| 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: | True |
| Wert aus verbleibenden Argumenten: | False |
-Folderscope
Anwendbar: Exchange Online
Der Parameter FolderScope gibt den Bereich für die Suche nach Ordnertyp an. Gültige Werte sind:
- Alle
- Archivieren
- Kalender
- Unwichtige Elemente
- Kontakte
- ConversationHistory
- DeletedItems
- Entwürfe
- Posteingang
- Journal
- JunkEmail
- LegacyArchiveJournals
- ManagedCustomFolder
- NonIpmRoot
- Notizen
- Postausgang
- Persönlich
- Wiederherstellbare Elemente
- 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 Online
Der Parameter "Identity" gibt die Identität des Postfachs oder E-Mail-Benutzers an. Um eine optimale Leistung zu erzielen, empfehlen wir die Verwendung der Benutzer-ID oder des Benutzerprinzipalnamens (UPN) zur Identifizierung des Postfachs.
Andernfalls können Sie einen beliebigen Wert verwenden, der das Postfach oder den E-Mail-Benutzer eindeutig identifiziert. Zum Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- LegacyExchangeDN
- SamAccountName
Sie können diesen Parameter nicht mit den Parametern ExternalDirectoryObjectId, PrimarySmtpAddress oder UserPrincipalName verwenden.
Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-IncludeOldestAndNewestItems
Anwendbar: 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
Die Option IncludeSoftDeletedRecipients gibt an, ob vorläufig gelöschte Postfächer in die Ergebnisse eingeschlossen werden sollen. Sie müssen keinen Wert für diese Option angeben.
Vorläufig gelöschte Postfächer sind Postfächer, die gelöscht wurden, aber noch wiederherstellbar sind.
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 |
-PrimarySmtpAddress
Anwendbar: Exchange Online
Die PrimarySmtpAddress identifiziert das Postfach, das Sie anzeigen möchten, anhand der primären SMTP-E-Mail-Adresse (z. B navin@contoso.com. ).
Sie können diesen Parameter nicht mit den Parametern ExternalDirectoryObjectId, Identity oder UserPrincipalName verwenden.
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: | True |
| Wert aus verbleibenden Argumenten: | False |
-UserPrincipalName
Anwendbar: Exchange Online
Der Parameter UserPrincipalName identifiziert das Postfach, das Sie anzeigen möchten, per UPN (z. B navin@contoso.onmicrosoft.com. ).
Sie können diesen Parameter nicht mit den Parametern ExternalDirectoryObjectId, Identity oder PrimarySmtpAddress verwenden.
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: | True |
| 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.