Get-StoreUsageStatistics
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.
Syntax
Get-StoreUsageStatistics
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>] Get-StoreUsageStatistics
[-Identity] <GeneralMailboxIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>] Get-StoreUsageStatistics
-Server <ServerIdParameter>
[-IncludePassive]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>] Description
La banque d’informations Exchange Microsoft 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 requêtes synchrones et asynchrones dans la banque d’informations Exchange Microsoft 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 d’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 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-StoreUsageStatistics -Server EX1 | ft -autoCet 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 -autoCet 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* -autoCet 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
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 manière 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.
| 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
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 manière 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.
| 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
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
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.
| Type: | String |
| 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 |
-Identity
Le paramètre Identity spécifie la boîte aux lettres à partir de laquelle obtenir des 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.
| Type: | GeneralMailboxIdParameter |
| 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 |
-IncludePassive
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.
| 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
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é.
| 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 |
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.