Partager via


Get-EXOMailboxFolderStatistics

Cette applet de commande est disponible uniquement dans le module PowerShell Exchange Online. Pour plus d’informations, consultez À propos du module PowerShell Exchange Online.

Utilisez l’applet de commande Get-EXOMailboxFolderStatistics pour récupérer des informations sur les dossiers d’une boîte aux lettres spécifiée, notamment le nombre et la taille des éléments dans le dossier, le nom et l’ID du dossier, ainsi que d’autres informations.

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-EXOMailboxFolderStatistics
   [-Archive]
   [-DiagnosticInfo <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-Folderscope <ElcFolderType>]
   [-Identity <String>]
   [-IncludeAnalysis]
   [-IncludeOldestAndNewestItems]
   [-IncludeSoftDeletedRecipients]
   [-PrimarySmtpAddress <String>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Description

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-EXOMailboxFolderStatistics peut retourner des éléments masqués pour les valeurs suivantes : FolderSize, FolderAndSubfolderSize, ItemsInFolder et ItemsInFolderAndSubfolders.

Ne confondez pas Get-EXOMailboxFolderStatistics applet de commande (dossiers) avec l’applet de commande Get-EXOMailboxStatistics (boîtes aux lettres).

Exemples

Exemple 1

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com

Cet exemple retourne des statistiques pour tous les dossiers de boîtes aux lettres. La valeur par défaut est FolderScope All.

Exemple 2

Get-EXOMailboxFolderStatistics -Identity admin@contoso.com -FolderScope Calendar -IncludeOldestAndNewestItems

Cet exemple retourne des statistiques uniquement pour les dossiers de calendrier.

Exemple 3

Get-EXOMailbox -ResultSize Unlimited | Get-EXOMailboxFolderStatistics -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 la boîte aux lettres d’archivage 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.

Si vous utilisez ce commutateur sur une boîte aux lettres pour laquelle l’archivage n’est pas activé, une erreur est retournée.

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

-DiagnosticInfo

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. Les valeurs valides sont les suivantes :

  • ExternalDirectoryObjectId
  • Identité
  • UserPrincipalName
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExternalDirectoryObjectId

Le paramètre ExternalDirectoryObjectId identifie la boîte aux lettres que vous souhaitez afficher par ObjectId dans Azure Active Directory.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres Identity, PrimarySmtpAddress ou UserPrincipalName.

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

-Folderscope

Le paramètre FolderScope indique l’étendue de la recherche par type de dossier. Les valeurs valides sont les suivantes :

  • tous
  • Archiver
  • Calendrier
  • Courrier non trié
  • Contacts
  • ConversationHistory
  • DeletedItems
  • Brouillons
  • Boîte de réception
  • Journal
  • Courrier indésirable
  • LegacyArchiveJournals
  • ManagedCustomFolder
  • NonIpmRoot
  • Remarques
  • Boîte d’envoi
  • Personnel
  • RecoverableItems
  • 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 Online

-Identity

Le paramètre Identity spécifie l’identité de la boîte aux lettres ou de l’utilisateur de messagerie. Pour de meilleures performances, nous vous recommandons d’utiliser l’ID d’utilisateur ou le nom d’utilisateur principal (UPN) pour identifier la boîte aux lettres.

Sinon, vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique l’utilisateur de boîte aux lettres ou de messagerie. Par exemple :

  • Nom
  • Alias
  • Nom unique
  • LegacyExchangeDN
  • SamAccountName

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExternalDirectoryObjectId, PrimarySmtpAddress ou UserPrincipalName.

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

-IncludeAnalysis

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 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 Online

-IncludeSoftDeletedRecipients

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 qui ont été supprimées, mais 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

-PrimarySmtpAddress

PrimarySmtpAddress identifie la boîte aux lettres que vous souhaitez afficher par adresse e-mail SMTP principale (par exemple, navin@contoso.com).

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExternalDirectoryObjectId, Identity ou UserPrincipalName.

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

-UserPrincipalName

Le paramètre UserPrincipalName identifie la boîte aux lettres que vous souhaitez afficher par UPN (par exemple, navin@contoso.onmicrosoft.com).

Vous ne pouvez pas utiliser ce paramètre avec les paramètres ExternalDirectoryObjectId, Identity ou PrimarySmtpAddress.

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