Get-MailboxStatistics

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-MailboxStatistics permet de renvoyer des informations sur une boîte aux lettres, telles que la taille de la boîte aux lettres, le nombre de messages qu’elle contient et la dernière fois que l’utilisateur y a accédé. En outre, vous pouvez obtenir l'historique de déplacement ou un rapport de déplacement d'une demande de déplacement terminée. Remarque : dans Exchange Online PowerShell, nous vous recommandons d’utiliser la cmdlet Get-EXOMailboxStatistics au lieu de cette applet de commande. Pour plus d’informations, consultez la rubrique utiliser le module Exchange Online PowerShell v2 (https://docs.microsoft.com/powershell/exchange/exchange-online-powershell-v2).

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Get-MailboxStatistics
   -Database <DatabaseIdParameter>
   [[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   [-Identity] <GeneralMailboxOrMailUserIdParameter>
   [-Archive]
   [-CopyOnServer <ServerIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludeQuarantineDetails]
   [-IncludeSoftDeletedRecipients]
   [-NoADLookup]
   [<CommonParameters>]
Get-MailboxStatistics
   -Server <ServerIdParameter>
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IncludeMoveHistory]
   [-IncludeMoveReport]
   [-IncludePassive]
   [-IncludeQuarantineDetails]
   [-NoADLookup]
   [<CommonParameters>]

Description

Sur les serveurs de boîtes aux lettres uniquement, vous pouvez utiliser la cmdlet Get-MailboxStatistics sans paramètre. Dans ce cas, la cmdlet renvoie les statistiques de toutes les boîtes aux lettres sur toutes les bases de données du serveur local.

La cmdlet Get-MailboxStatistics nécessite au moins l’un des paramètres suivants pour se terminer correctement : serveur, base de données ou identité.

Vous pouvez utiliser la cmdlet Get-MailboxStatistics pour renvoyer un historique des déplacements détaillés et un rapport de déplacement pour les demandes de déplacement terminées afin de dépanner une demande de déplacement. Pour afficher l’historique des déplacements, vous devez transmettre cette applet de commande en tant qu’objet. Les historiques de déplacement sont conservés dans la base de données de boîtes aux lettres et sont numérotés de manière incrémentielle et la dernière demande de déplacement exécutée est toujours numérotée 0. Pour plus d’informations, reportez-vous aux rubriques « example 7 », « Example 8 » et « Example 9 » de cette rubrique.

Vous pouvez uniquement voir les rapports et l'historique de déplacement concernant les demandes de déplacement terminées.

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.

Examples

Exemple 1

Get-MailboxStatistics -Identity AylaKol

Cet exemple récupère les statistiques de la boîte aux lettres de l’utilisateur Ayla Kol en utilisant l’alias AylaKol qui lui est associé.

Exemple 2

Get-MailboxStatistics -Server MailboxServer01

Cet exemple récupère les statistiques de toutes les boîtes aux lettres sur le serveur MailboxServer01.

Exemple 3

Get-MailboxStatistics -Identity contoso\chris

Cet exemple récupère les statistiques de la boîte aux lettres spécifiée.

Exemple 4

Get-MailboxStatistics -Database "Mailbox Database"

Cet exemple récupère les statistiques de toutes les boîtes aux lettres présentes dans la base de données de boîtes aux lettres spécifiée.

Exemple 5

Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'

Cet exemple récupère les statistiques des boîtes aux lettres déconnectées de toutes les bases de données de boîtes aux lettres de l’organisation. L'opérateur -ne signifie « différent de ».

Exemple 6

Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d

Cet exemple récupère les statistiques d’une seule boîte aux lettres déconnectée. La valeur du paramètre StoreMailboxIdentity est le GUID de boîte aux lettres de celle qui est déconnectée. Vous pouvez également utiliser LegacyDN.

Exemple 7

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List

Cet exemple renvoie le résumé de l'historique de déplacement concernant la demande de déplacement terminée de la boîte aux lettres d'Ayla Kol. Si vous ne transmettez pas la sortie à la cmdlet Format-List, l'historique de déplacement ne s'affiche pas.

Exemple 8

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory; $temp.MoveHistory[0]

Cet exemple renvoie l'historique de déplacement détaillé concernant la demande de déplacement terminée de la boîte aux lettres d'Ayla Kol. Cet exemple utilise une variable temporaire pour stocker l'objet statistiques de la boîte aux lettres. Si la boîte aux lettres a été déplacée plusieurs fois, il y aura plusieurs rapports de déplacement. Le dernier rapport de déplacement est toujours MoveReport[0].

Exemple 9

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport; $temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv

Cet exemple renvoie l'historique de déplacement détaillé et un rapport de déplacement détaillé concernant la boîte aux lettres d'Ayla Kol. Cet exemple utilise une variable temporaire pour stocker l'objet statistiques de la demande de déplacement et place le rapport de déplacement dans un fichier CSV.

Parameters

-Archive

Le paramètre de commutateur Archive spécifie s'il faut retourner les statistiques de la boîte aux lettres d'archivage associée à la boîte aux lettres spécifiée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Copyonserver permet

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre Copyonserver permet permet de récupérer les statistiques d’une copie de base de données spécifique sur le serveur spécifié.

Le paramètre MailboxServer spécifie le serveur de boîtes aux lettres exExchange2k16 ou exExchange2k13 à tester. Ce paramètre identifie le serveur principal qui accepte les connexions transmises par proxy à partir du serveur frontal sur lequel les clients se connectent.

  • Nom

  • FQDN

  • FQDN

  • Nom unique (DN)

DN Exchange hérité

Type:ServerIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Database

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre Database renvoie les statistiques de toutes les boîtes aux lettres de la base de données spécifiée. Vous pouvez utiliser n’importe quelle valeur qui identifie la base de données de manière unique. Par exemple :

  • Nom

  • Nom unique (DN)

  • GUID

Ce paramètre accepte l'entrée en pipeline à partir de la cmdlet Get-MailboxDatabase.

Type:DatabaseIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Filter

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre Filter utilise la syntaxe OPath pour filtrer les résultats selon les propriétés et les valeurs spécifiées. Les critères de recherche utilisent la syntaxe "Property -ComparisonOperator 'Value'" .

  • Placez le filtre OPath entier entre guillemets doubles "". Si le filtre contient des valeurs système (par exemple,, $true $false ou $null ), utilisez à la place les guillemets simples «». Bien que ce paramètre soit une chaîne (et non un bloc système), vous pouvez également utiliser des accolades {}, mais uniquement si le filtre ne contient pas de variables.

  • Property est une propriété filtrable.

  • ComparisonOperator est un opérateur de comparaison OPath (par exemple -eq , pour égal à et -like pour la comparaison de chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.

  • Value est la valeur de la propriété à rechercher. Placez les valeurs de texte et les variables entre guillemets simples ( 'Value' ou '$Variable' ). Si une valeur de variable contient des guillemets simples, vous devez identifier (échapper) les guillemets simples pour développer la variable correctement. Par exemple, à la place de '$User' , utilisez '$($User -Replace "'","''")' . Ne délimitez pas les nombres entiers ou les valeurs système (par exemple,,, 500 $true $false ou $null ).

Vous pouvez regrouper plusieurs critères de recherche à l’aide des opérateurs logiques -and et -or . Par exemple, "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3" .

Pour plus d’informations sur les filtres OPath dans Exchange, reportez-vous à la rubrique Additional OPATH Syntax information.

Par exemple, pour afficher toutes les boîtes aux lettres déconnectées sur une base de données de boîtes aux lettres spécifique, utilisez la syntaxe suivante : 'DisconnectDate -ne $null' .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

Le paramètre Identity spécifie la boîte aux lettres pour laquelle vous souhaitez renvoyer les statistiques. Vous pouvez utiliser n’importe quelle valeur qui identifie la boîte aux lettres de manière unique. Par exemple :

  • Nom

  • Alias

  • Nom unique

  • Nom unique

  • <domain name>\<account name>

  • Nom unique canonique

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • Identifiant utilisateur ou nom d’utilisateur principal (UPN)

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-IncludeMoveHistory

Le commutateur IncludeMoveHistory spécifie s'il faut retourner des informations supplémentaires sur la boîte aux lettres qui contiennent l'historique d'une requête de déplacement terminée : l'état, les indicateurs, la base de données cible, les éléments incorrects, les heures de début et de fin, la durée de la demande de déplacement dans les différentes phases et les codes d'échec, par exemple. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-IncludeMoveReport

Le commutateur IncludeMoveReport spécifie s'il faut retourner un rapport de déplacement plus détaillé pour une demande de déplacement terminée, les connexions au serveur et les phases de déplacement, par exemple. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Étant donné que la sortie de cette commande est détaillée, vous devez l'envoyer vers un fichier .csv pour faciliter l'analyse.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-IncludePassive

Ce paramètre est disponible uniquement dans Exchange sur site.

Sans le paramètre IncludePassive, la cmdlet récupère les statistiques à partir des copies de bases de données actives uniquement. L’utilisation du paramètre IncludePassive vous permet de faire en sorte que la cmdlet renvoie les statistiques à partir de toutes les copies de bases de données actives et passives.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-IncludeQuarantineDetails

Ce paramètre est disponible uniquement dans Exchange sur site.

Le commutateur IncludeQuarantineDetails spécifie si des détails de mise en quarantaine supplémentaires concernant la boîte aux lettres doivent être renvoyés (ces détails ne sont pas inclus dans les résultats autrement). Vous pouvez utiliser ces détails afin de déterminer le moment et les raisons pour lesquelles la boîte aux lettres a été mise en quarantaine.

Plus spécifiquement, ce commutateur renvoie les valeurs des propriétés QuarantineDescription, QuarantineLastCrash et QuarantineEnd sur la boîte aux lettres. Pour afficher ces valeurs, vous devez utiliser une cmdlet de mise en forme. Par exemple, Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-répertorier la mise en quarantaine * .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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écupérable 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 (récupérables) sont des boîtes aux lettres supprimées qui sont toujours récupérables.

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

Ce paramètre est disponible uniquement dans Exchange sur site.

Le commutateur NoADLookup spécifie que les informations sont récupérées à partir de la base de données de boîtes aux lettres, et non à partir d’Active Directory. Ceci améliore les performances de la cmdlet lors d’une requête sur une base de données de boîtes aux lettres contenant de nombreuses boîtes aux lettres.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Server

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre Server spécifie le serveur à partir duquel vous voulez obtenir les statistiques sur les boîtes aux lettres. Vous pouvez utiliser l'une des valeurs suivantes :

  • nom de domaine complet (FQDN)

  • nom NetBIOS

Lorsque vous spécifiez une valeur pour le paramètre Server, la commande renvoie les statistiques pour toutes les boîtes aux lettres de toutes les bases de données, y compris les bases de données de récupération, sur le serveur spécifié. Si vous ne spécifiez pas ce paramètre, la commande renvoie les statistiques d'accès pour le serveur local.

Type:ServerIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-StoreMailboxIdentity

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre StoreMailboxIdentity spécifie l’identité de la boîte aux lettres lorsqu’elle est utilisée avec le paramètre Database pour renvoyer les statistiques d’une seule boîte aux lettres sur la base de données spécifiée. Vous pouvez utiliser l’une des valeurs suivantes :

  • MailboxGuid

  • LegacyDN

Utilisez cette syntaxe pour récupérer des informations sur les boîtes aux lettres déconnectées, qui n’ont pas d’objet Active Directory correspondant, ou qui ont un objet Active Directory correspondant qui ne pointe pas vers la boîte aux lettres déconnectée dans la base de données de boîtes aux lettres.

Type:StoreMailboxIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Inputs

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.

Outputs

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.