Partager via

Get-StoreUsageStatistics

Module:
Exchange PowerShell

La cmdlet est disponible uniquement dans Exchange en local.

Utilisez la cmdlet Get-StoreUsageStatistics pour faciliter le diagnostic des problèmes de performance de vos serveurs ou bases de données.

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

Syntaxe

Database 

Get-StoreUsageStatistics
    -Database <DatabaseIdParameter>
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [<CommonParameters>]

Identity 

Get-StoreUsageStatistics
    [-Identity] <GeneralMailboxIdParameter>
    [-CopyOnServer <ServerIdParameter>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [<CommonParameters>]

Server 

Get-StoreUsageStatistics
    -Server <ServerIdParameter>
    [-IncludePassive]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [<CommonParameters>]

Description

La banque d’informations Microsoft Exchange collecte des informations par utilisateur sur la latence, les entrées/sorties (E/S), le nombre de pages, l’utilisation du processeur et TimeInServer. La métrique TimeInServer représente le temps total passé par les demandes synchrones et asynchrones dans la banque d’informations Microsoft Exchange pour la boîte aux lettres d’un utilisateur. Vous pouvez récupérer ces informations de ressource dans la banque d’informations Microsoft Exchange pour les 25 comptes d’utilisation les plus élevés sur une base de données spécifiée. L’utilisation d’une boîte aux lettres est définie comme la durée passée par le serveur à réaliser des opérations pour cette boîte aux lettres. La cmdlet signale les 25 premiers utilisateurs pour chaque période d’une minute des 10 dernières minutes (250 objets par période de dix minutes). L’utilisation des ressources est un indicateur de la charge que différents utilisateurs placent sur le serveur.

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.

Exemples

Exemple 1

Get-StoreUsageStatistics -Server EX1 | ft -auto

Cet exemple récupère les statistiques d’utilisation de la banque pour toutes les bases de données actives sur le serveur EX1.

Exemple 2

Get-StoreUsageStatistics -Server EX1 -IncludePassive | ft -auto

Cet exemple récupère les statistiques d’utilisation de la banque pour toutes les bases de données actives et passives sur le serveur EX1.

Exemple 3

Get-StoreUsageStatistics -Database DB1 | Sort-Object LogRecordBytes -desc | Select-Object -First 10 | ft DigestCategory, *guid, LogRecordBytes, *time* -auto

Cet exemple récupère les statistiques d’utilisation des magasins pour la base de données DB1 et trie la sortie selon les 10 générateurs de fichiers journaux les plus élevés.

Paramètres

-CopyOnServer

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre CopyOnServer spécifie la copie de la base de données de boîtes aux lettres à partir de laquelle obtenir les statistiques d’utilisation. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique la base de données de boîtes aux lettres. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Vous utilisez ce paramètre avec les paramètres Server ou Identity.

Propriétés des paramètres

Type:ServerIdParameter
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:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
Identity
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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Database spécifie le nom de la base de données de boîtes aux lettres à partir de laquelle obtenir les statistiques d’utilisation (les 25 plus grandes boîtes aux lettres de la base de données de boîtes aux lettres spécifiée). Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique la base de données de boîtes aux lettres. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID

Vous ne pouvez pas utiliser ce paramètre avec les paramètres Identity ou Server.

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:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DomainController

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Filter

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 -eq , pour des valeurs égales 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 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, utilisez 500, $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.

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

-Identity

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Identity spécifie la boîte aux lettres à partir de laquelle obtenir les statistiques d’utilisation. Vous pouvez utiliser l’une des valeurs suivantes pour identifier la boîte aux lettres :

  • GUID
  • Nom unique (DN)
  • Domaine\Compte
  • Nom d’utilisateur principal (UPN)
  • DN Exchange hérité
  • Adresse SMTP
  • Alias

La commande retourne des résultats pour la boîte aux lettres uniquement s’il s’agit de l’un des 25 principaux utilisateurs des ressources du magasin.

Vous ne pouvez pas utiliser ce paramètre avec les paramètres de base de données ou de serveur.

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:GeneralMailboxIdParameter
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:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-IncludePassive

Applicable : Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le commutateur IncludePassive spécifie s’il faut inclure les statistiques d’utilisation des copies actives et passives des bases de données de boîtes aux lettres sur le serveur de boîtes aux lettres que vous avez spécifié avec le paramètre Server. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Si vous n’utilisez pas ce commutateur, seules les statistiques des copies actives des bases de données de boîtes aux lettres sont incluses dans les résultats.

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

Server
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Server

Applicable : Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Le paramètre Server spécifie le serveur de boîtes aux lettres à partir duquel obtenir les statistiques d’utilisation (les 25 premières boîtes aux lettres sur toutes les bases de données actives sur le serveur spécifié). Vous pouvez utiliser l’une des valeurs suivantes pour identifier le serveur :

  • nom de domaine complet (FQDN)
  • nom NetBIOS

Vous ne pouvez pas utiliser ce paramètre avec les paramètres Base de données ou Identité.

Propriétés des paramètres

Type:ServerIdParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

Server
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
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.