Get-MailboxStatistics

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-MailboxStatistics permet d'obtenir 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 du dernier accès à la boîte aux lettres. En outre, vous pouvez obtenir l'historique de déplacement ou un rapport de déplacement d'une demande de déplacement terminée.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Get-MailboxStatistics -Identity <GeneralMailboxOrMailUserIdParameter> [-Archive <SwitchParameter>] [-CopyOnServer <ServerIdParameter>] <COMMON PARAMETERS>
Get-MailboxStatistics [-AuditLog <SwitchParameter>] [-Identity <GeneralMailboxOrMailUserIdParameter>] <COMMON PARAMETERS>
Get-MailboxStatistics -Database <DatabaseIdParameter> [-CopyOnServer <ServerIdParameter>] [-Filter <String>] [-StoreMailboxIdentity <StoreMailboxIdParameter>] <COMMON PARAMETERS>
Get-MailboxStatistics -Server <ServerIdParameter> [-Filter <String>] [-IncludePassive <SwitchParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-DomainController <Fqdn>] [-IncludeMoveHistory <SwitchParameter>] [-IncludeMoveReport <SwitchParameter>] [-IncludeQuarantineDetails <SwitchParameter>] [-NoADLookup <SwitchParameter>]

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é.

Get-MailboxStatistics -Identity AylaKol

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

Get-MailboxStatistics -Server MailboxServer01

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

Get-MailboxStatistics -Identity contoso\chris

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.

Get-MailboxStatistics -Database "Mailbox Database"

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 ».

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

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.

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

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.

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

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].

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

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.

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

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.

noteRemarque :
La cmdlet Get-MailboxStatistics nécessite un des paramètres suivants au minimum pour se terminer avec succès : Server, Database, ou Identity.

Vous pouvez utiliser la cmdlet Get-MailboxStatistics pour renvoyer l'historique de déplacement détaillé et utiliser un rapport de déplacement pour les demandes de déplacement terminées afin de résoudre une demande de déplacement. Pour afficher l'historique de déplacement, vous devez transmettre cette cmdlet sous la forme d'un objet. L’historique des déplacements est conservé dans la base de données de boîtes aux lettres et numéroté par incréments. La dernière demande de déplacement exécutée porte toujours le numéro 0. Pour plus d’informations, consultez « Exemple 7 » « Exemple 8 » et « Exemple 9 » dans cette rubrique.

noteRemarque :
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 tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir Section « Autorisations de configuration des destinataires » dans la rubrique Autorisations des destinataires.

 

Paramètre Obligatoire Type Description

Database

Obligatoire

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

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

Le paramètre Database spécifie le nom de la base de données de boîtes aux lettres. Lorsque vous spécifiez une valeur pour le paramètre Database, Exchange Management Shell renvoie les statistiques de toutes les boîtes aux lettres de la base de données spécifiée.

Vous pouvez utiliser les valeurs suivantes :

  • GUID

  • Base de données

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

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.GeneralMailboxOrMailUserIdParameter

Le paramètre Identity spécifie une boîte aux lettres. Lorsque vous spécifiez une valeur pour le paramètre Identity, la commande recherche la boîte aux lettres spécifiée dans le paramètre Identity, se connecte au serveur où réside la boîte aux lettres et renvoie les statistiques pour la boîte aux lettres.

Ce paramètre accepte les valeurs suivantes :

  • Alias

    Exemple : JPhillips

  • Canonical DN

    Exemple : Atlanta.Corp.Contoso.Com/Users/JPhilips

  • Display Name

    Exemple : Jeff Philips

  • Distinguished Name (DN)

    Exemple : CN = JPhillips, CN = Users, DC = Atlanta, DC = Corp, DC = contoso, DC = com

  • Domain\Account

    Exemple : Atlanta\JPhillips

  • GUID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2

  • Immutable ID

    Exemple : fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com

  • Legacy Exchange DN

    Exemple : /o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhilips

  • SMTP Address

    Exemple : Jeff.Phillips@contoso.com

  • User Principal Name

    Exemple : JPhillips@contoso.com

Server

Obligatoire

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Archive

Facultatif

System.Management.Automation.SwitchParameter

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.

Vous n’avez pas besoin de spécifier une valeur avec ce paramètre.

AuditLog

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

CopyOnServer

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

Le paramètre CopyOnServer permet de récupérer les statistiques à partir d’une copie de base de données spécifique sur le serveur spécifié à l’aide du paramètre Server.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Filter

Facultatif

System.String

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

Le paramètre Filter permet de filtrer les résultats de la cmdlet Get-MailboxStatistics. Par exemple, pour afficher toutes les boîtes aux lettres déconnectées sur une base de données de boites aux lettres spécifique, utilisez la syntaxe suivante pour ce paramètre : -Filter 'DisconnectDate -ne $null'

IncludeMoveHistory

Facultatif

System.Management.Automation.SwitchParameter

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.

IncludeMoveReport

Facultatif

System.Management.Automation.SwitchParameter

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.

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

IncludePassive

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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.

IncludeQuarantineDetails

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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-List Quarantine*.

NoADLookup

Facultatif

System.Management.Automation.SwitchParameter

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

L’interrupteur NoADLookup spécifie que les informations récupérées proviennent de la base de données de boîtes aux lettres, et non de 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.

StoreMailboxIdentity

Facultatif

Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter

Ce paramètre est disponible uniquement dans Exchange 2016 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

Cette syntaxe permet de récupérer des informations sur les boîtes aux lettres déconnectées n’ayant pas d’objet Active Directory correspondant ou ayant 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.

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.

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.

 
Afficher: