Get-MailboxFolderStatistics
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
La cmdlet Get-MailboxFolderStatistics permet d’extraire des informations sur les dossiers d’une boîte aux lettres spécifiée, notamment le nombre et la taille des éléments du dossier, son nom et son ID, ainsi que d’autres informations.
Remarque : Dans Exchange Online PowerShell, nous vous recommandons d’utiliser l’applet de commande Get-EXOMailboxFolderStatistics au lieu de cette applet de commande. Pour plus d'informations, reportez-vous à Connexion à Exchange Online.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Get-MailboxFolderStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-DiagnosticInfo <String>]
[-DomainController <Fqdn>]
[-FolderScope <ElcFolderType>]
[-IncludeAnalysis]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-ResultSize <Unlimited>]
[-SkipCount <Int32>]
[<CommonParameters>] Get-MailboxFolderStatistics
[[-Identity] <GeneralMailboxOrMailUserIdParameter>]
[-AuditLog]
[-DiagnosticInfo <String>]
[-DomainController <Fqdn>]
[-FolderScope <ElcFolderType>]
[-IncludeAnalysis]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-ResultSize <Unlimited>]
[-SkipCount <Int32>]
[<CommonParameters>] Get-MailboxFolderStatistics
-Database <DatabaseIdParameter>
-StoreMailboxIdentity <StoreMailboxIdParameter>
[-DiagnosticInfo <String>]
[-FolderScope <ElcFolderType>]
[-IncludeAnalysis]
[-IncludeOldestAndNewestItems]
[-IncludeSoftDeletedRecipients]
[-ResultSize <Unlimited>]
[-SkipCount <Int32>]
[<CommonParameters>] Description
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Une boîte aux lettres peut contenir des éléments cachés jamais perceptibles par l’utilisateur et utilisés uniquement par les applications. L’applet de commande Get-MailboxFolderStatistics peut retourner des éléments masqués pour les valeurs suivantes : FolderSize, FolderAndSubfolderSize, ItemsInFolder et ItemsInFolderAndSubfolders.
Il ne faut pas confondre la cmdlet Get-MailboxFolderStatistics avec la cmdlet Get-MailboxStatistics.
Exemples
Exemple 1
Get-MailboxFolderStatistics -Identity contoso\chrisCet exemple ne spécifie pas le paramètre FolderScope et récupère toutes les informations concernant l’utilisateur Chris dans le domaine Contoso.
Exemple 2
Get-MailboxFolderStatistics -Identity Chris -FolderScope CalendarCet exemple utilise le paramètre FolderScope pour afficher les statistiques des dossiers calendrier pour l’utilisateur Chris.
Exemple 3
Get-MailboxFolderStatistics -Identity Ayla@contoso.com -ArchiveCet exemple utilise le commutateur Archive pour afficher les statistiques de l’archive d’Ayla.
Exemple 4
Get-MailboxFolderStatistics -Identity "Tony" -FolderScope RecoverableItems -IncludeAnalysisCet exemple utilise le commutateur IncludeAnalysis pour afficher les statistiques du dossier Éléments récupérables de l’utilisateur Tony.
Exemple 5
$All = Get-Mailbox -ResultSize Unlimited
$All | foreach {Get-MailboxFolderStatistics -Identity $_.Identity -FolderScope Inbox | Format-Table Identity,ItemsInFolderAndSubfolders,FolderAndSubfolderSize -AutoSize}Cet exemple utilise le paramètre FolderScope pour afficher les statistiques des dossiers de boîte de réception pour toutes les boîtes aux lettres.
Paramètres
-Archive
Le commutateur Archive spécifie s’il faut retourner les statistiques d’utilisation de l’archive associée à la boîte aux lettres ou à l’utilisateur de messagerie. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
| 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 |
-AuditLog
Ce paramètre est disponible uniquement dans Exchange sur site.
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Database
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DiagnosticInfo
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
En règle générale, vous utilisez le paramètre DiagnosticInfo uniquement à la demande de Microsoft Service clientèle et support technique pour résoudre les problèmes.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DomainController
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « 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 |
-FolderScope
Le paramètre FolderScope indique l’étendue de la recherche par type de dossier. Les valeurs de paramètres valides sont les suivantes :
- tous
- Archive : Exchange 2016 ou version ultérieure.
- Calendrier
- Contacts
- ConversationHistory
- DeletedItems
- Brouillons
- Boîte de réception
- Courrier indésirable
- Journal
- LegacyArchiveJournals : Exchange 2013 ou version ultérieure.
- ManagedCustomFolder : retourne la sortie de tous les dossiers personnalisés managés.
- NonIpmRoot : Exchange 2013 ou version ultérieure.
- Remarques
- Boîte d’envoi
- Personnel
- RecoverableItems : retourne la sortie du dossier Éléments récupérables et des sous-dossiers Suppressions, DiscoveryHolds, Purges et Versions.
- RssSubscriptions
- SentItems
- SyncIssues
- Tâches
| Type: | ElcFolderType |
| 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 |
-Identity
Le paramètre Identity spécifie l’identité de la boîte aux lettres ou de l’utilisateur de messagerie. Vous pouvez utiliser n’importe quelle valeur qui identifie l’utilisateur de messagerie ou la boîte aux lettres de manière unique. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (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 |
-IncludeAnalysis
Le commutateur IncludeAnalysis spécifie s’il faut analyser tous les éléments d’un dossier et retourner des statistiques relatives au dossier et à la taille de l’élément. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous devez utiliser ce commutateur à des fins de résolution des problèmes, car la commande peut prendre du temps.
| 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 |
-IncludeOldestAndNewestItems
Le commutateur IncludeOldestAndNewestItems spécifie s’il convient de renvoyer les dates des éléments les plus anciens et les plus récents dans chaque dossier. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
| 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 |
-IncludeSoftDeletedRecipients
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le commutateur IncludeSoftDeletedRecipients spécifie s’il faut inclure des boîtes aux lettres supprimées de manière réversible dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Les boîtes aux lettres supprimées de manière réversible sont des boîtes aux lettres supprimées qui sont toujours récupérables.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SkipCount
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ Fill SkipCount Description }}
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StoreMailboxIdentity
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | StoreMailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.