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.
Utilisez l’applet de commande Get-MailboxStatistics pour retourner 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 l’heure à laquelle elle a été consultée pour la dernière fois. 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 l’applet de commande Get-EXOMailboxStatistics 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-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.
L’applet de commande Get-MailboxStatistics nécessite qu’au moins l’un des paramètres suivants s’exécute correctement : Serveur, Base de données ou Identité.
Vous pouvez utiliser l’applet de commande Get-MailboxStatistics pour retourner un historique de déplacement détaillé et un rapport de déplacement pour les demandes de déplacement terminées afin de résoudre les problèmes d’une demande de déplacement. Pour afficher l’historique des déplacements, vous devez passer 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 façon incrémentielle et la dernière demande de déplacement exécutée est toujours numérotée 0. Pour plus d’informations, consultez « Exemple 7 », « Exemple 8 » et « Exemple 9 » dans 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.
Exemples
Exemple 1
Get-MailboxStatistics -Identity AylaKolCet 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 MailboxServer01Cet exemple récupère les statistiques de toutes les boîtes aux lettres sur le serveur MailboxServer01.
Exemple 3
Get-MailboxStatistics -Identity contoso\chrisCet 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-ae022b43742dCet 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-ListCet 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.csvCet 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.
Paramètres
-Archive
Le commutateur Archive spécifie s’il faut retourner des statistiques de boîte aux lettres pour la boîte aux lettres d’archivage associée à la boîte aux lettres. 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 |
-CopyOnServer
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre CopyOnServer est utilisé pour récupérer des statistiques à partir d’une copie de base de données spécifique sur le serveur spécifié.
Vous pouvez utiliser n’importe quelle valeur qui identifie uniquement le serveur. Par exemple :
- Nom
- FQDN
- Nom unique
- DN Exchange hérité
DN Exchange hérité
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 retourne des statistiques pour 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 |
| Required: | True |
| 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 |
| Required: | False |
| 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 en fonction des propriétés et valeurs spécifiées. Les critères de recherche utilisent la syntaxe "Property -ComparisonOperator 'Value'".
- Placez l’ensemble du filtre OPATH entre guillemets doubles « ». Si le filtre contient des valeurs système (par exemple,
$true,$falseou$null), utilisez plutôt des 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
-eqpour des valeurs égales et-likepour 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 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 (échappement) les guillemets simples pour développer la variable correctement. Par exemple, au lieu de'$User', utilisez'$($User -Replace "'","''")'. Ne placez pas entre guillemets les entiers ou les valeurs système (par exemple, utilisez500,$true,$falseou$nullà la place).
Vous pouvez chaîner 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, consultez Informations supplémentaires sur la syntaxe OPATH.
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 |
| Required: | False |
| 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 retourner des 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
- 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 |
-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 |
| 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 |
-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 |
| 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 |
-IncludePassive
Ce paramètre est disponible uniquement dans Exchange sur site.
Le commutateur IncludePassive spécifie s’il faut retourner des statistiques à partir de toutes les copies de base de données actives et passives. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Si vous n’utilisez pas ce commutateur, la commande récupère uniquement les statistiques des copies de base de données actives.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
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-List Quarantine*.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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é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 |
-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. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Ce commutateur permet d’améliorer les performances des applets de commande lors de l’interrogation d’une base de données de boîtes aux lettres qui contient un grand nombre de boîtes aux lettres.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.