Get-MailboxFolderStatistics
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et paramètres peuvent être exclusifs à un environnement ou à l’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.
Syntaxe
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>]
Description
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont 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\chris
Cet 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 Calendar
Cet 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 -Archive
Cet exemple utilise le commutateur Archive pour afficher les statistiques de l’archive d’Ayla.
Exemple 4
Get-MailboxFolderStatistics -Identity "Tony" -FolderScope RecoverableItems -IncludeAnalysis
Cet 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
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AuditLog
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Ce paramètre est disponible uniquement dans Exchange sur site.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
AuditLog
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Database
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés des paramètres
| Type: | DatabaseIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Database
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DiagnosticInfo
Applicable : Exchange Online
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 du service clientèle et du support technique Microsoft pour résoudre les problèmes.
Propriétés des paramètres
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DomainController
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 ».
Propriétés des paramètres
| Type: | Fqdn |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
AuditLog
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FolderScope
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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
Propriétés des paramètres
| Type: | ElcFolderType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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)
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | GeneralMailboxOrMailUserIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Identity
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
AuditLog
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-IncludeAnalysis
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IncludeOldestAndNewestItems
Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IncludeSoftDeletedRecipients
Applicable : Exchange Online
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResultSize
Applicable : Exchange Online
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.
Propriétés des paramètres
| Type: | Unlimited |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SkipCount
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ Fill SkipCount Description }}
Propriétés des paramètres
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-StoreMailboxIdentity
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés des paramètres
| Type: | StoreMailboxIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Database
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UseCustomRouting
Applicable : Exchange Online
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
{{ Fill UseCustomRouting Description }}
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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.