Gérer la croissance des journaux des bases de données à l’aide du script Troubleshoot-DatabaseSpace.ps1 dans l’environnement de ligne de commande Exchange Management Shell
S’applique à : Exchange Server 2010 SP2, Exchange Server 2010 SP3
Dernière rubrique modifiée : 2016-11-28
Le script Troubleshoot-DatabaseSpace.ps1 est utilisé par Microsoft System Center Operations Manager 2007 pour détecter et corriger toute croissance excessive du journal ou du fichier de base de données (.edb) Microsoft Exchange, susceptible d’entraîner des temps d’arrêt de la base de données. Par défaut, System Center Operations Manager 2007 exécute le script toutes les 15 minutes. Toutefois, vous pouvez utiliser le Planificateur de tâches pour configurer et exécuter ce script afin de surveiller la croissance du fichier et du journal de base de données.
Remarque : |
---|
Un script doit être exécuté à partir du dossier dans lequel il réside. Par défaut, les scripts installés avec Exchange 2010 le sont dans C:\Program Files\Microsoft\Exchange Server\V14\Scripts. L’environnement de ligne de commande Exchange Management Shell ne charge pas automatiquement les scripts. Pour exécuter un script à partir du fichier local, vous devez faire précéder tous les scripts du signe « .\ ». Par exemple, pour exécuter le script SampleScript.ps1, tapez .\SampleScript.ps1 . Pour exécuter un script et spécifier le chemin d’installation par défaut, tapez "C:\Program Files\Microsoft\Exchange Server\V14\Scripts\SampleScript.ps1" . Pour plus d’informations, consultez la rubrique Scripts dans Exchange Management Shell. |
Le script Troubleshoot-DatabaseSpace.ps1 script effectue les actions suivantes :
Il consigne le suivi de la fréquence de génération des journaux des générateurs de journaux les plus élevés par base de données. Cette opération aide à déterminer les utilisateurs qui se connectent trop, entraînant probablement des problèmes d’espace.
Il consigne le suivi de l’espace disque disponible pour les fichiers et les journaux de base de données. Si l’un de ces éléments se trouve à la limite maximale d’un seuil configurable, les actions appropriées doivent être prises.
Il consigne le suivi de la fréquence de génération des journaux. Si le disque va manquer d’espace par rapport à la valeur spécifiée par le paramètre HourThreshold (basée sur la fréquence de génération des journaux), les actions appropriées doivent être prises.
Remarque : Pour éviter toute situation compliquée, assurez-vous que la valeur HourThreshold est suffisamment élevée pour vous donner le temps de réagir durant les heures ouvrables habituelles, pendant que l’espace disponible est suffisant. Si les lecteurs se remplissent plus rapidement que la valeur spécifiée, des actions immédiates doivent être prises pour protéger le disque. Si toutes les conditions antérieures sont satisfaites, le script détermine la liste des 25 utilisateurs ayant le plus accédé à la base de données au cours de la dernière heure. Le script met alors en quarantaine les boîtes aux lettres les plus utilisées, pour lesquelles la somme des fréquences de génération des journaux est supérieure à la différence entre la fréquence actuelle et la fréquence soutenable, laquelle permet d’ajuster le seuil de temps configurable. Ces utilisateurs sont mis en quarantaine pendant six heures, durée pendant laquelle ils n’ont pas accès à leur courrier électronique.
Si l’outil de dépannage ne parvient pas à faire chuter la fréquence de génération des journaux sous le seuil, il écrit des événements qui se traduisent en alertes du modèle d’intégrité. À cette étape, le script empêche l’approvisionnement de la base de données à l’aide de la cmdlet Set-MailboxDatabase avec le paramètre ExcludeFromProvisioning défini sur
$true
pour la base de données spécifiée. Vous pouvez avoir besoin de déplacer des boîtes aux lettres vers un nouveau serveur pour rééquilibrer l’espace.Si l’outil de dépannage met en quarantaine plus de 10 utilisateurs, cela révèle une erreur systématique qui demande votre attention. Le modèle d’intégrité déclenche une alerte d’urgence suite à cette erreur.
Les paramètres par défaut utilisés dans le script Troubleshoot-DatabaseSpace.ps1 sont définis dans le script StoreTSConstants.ps1.
Souhaitez-vous rechercher d’autres tâches de gestion relatives aux bases de données ? Consultez la rubrique Gestion de bases de données de boîtes aux lettres.
Utiliser le script Troubleshoot-DatabaseSpace.ps1
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Bases de données de boîtes aux lettres » dans la rubrique Autorisations de boîtes aux lettres.
La table et le jeu suivants de syntaxe de paramètres répertorient les paramètres que vous pouvez utiliser pour déplacer des boîtes aux lettres spécifiques.
Troubleshoot-DatabaseSpace.ps1 -MailboxDatabaseName <DatabaseID> [-PercentEdbFreeSpaceThreshold <1-99>] [-PercentLogFreeSpaceThreshold <1-99>] [-HourThreshold <1- 1000000000>] [-Quarantine <switch>] [-MonitoringContext <switch>]
Troubleshoot-DatabaseSpace.ps1 -Server <ServerID> [-PercentEdbFreeSpaceThreshold <1-99>] [-PercentLogFreeSpaceThreshold <1-99>] [-HourThreshold <1- 1000000000>] [-Quarantine <switch>] [-MonitoringContext <switch>]
Paramètre | Obligatoire | Description | ||
---|---|---|---|---|
MailboxDatabaseName |
Obligatoire |
Le paramètre MailboxDatabaseName spécifie la base de données de boîtes aux lettres pour laquelle vous surveillez la croissance des journaux. Ce paramètre accepte les valeurs suivantes :
|
||
Server |
Obligatoire |
Le paramètre Server spécifie le serveur de boîtes aux lettres pour laquelle vous surveillez la croissance des journaux pour toutes les bases de données de boîtes aux lettres.
|
||
HourThreshold |
Facultatif |
Le paramètre HourThreshold spécifie le nombre d’heures que vous pouvez attendre avant de manquer d’espace. La valeur par défaut est 12 heures. |
||
MonitoringContext |
Facultatif |
Le paramètre MonitoringContext spécifie si les résultats de la commande incluent l’écriture des événements de surveillance dans les journaux standard de l’application dans l’Observateur d’événements et dans le journal des opérations. Si vous ne spécifiez pas cette valeur, les journaux des opérations seront écrits à l’emplacement suivant dans l’Observateur d’événements : Observateur d’événements > Journaux des applications et des services > Microsoft-Exchange-Troubleshooters/Operational. Vous n’avez pas besoin de spécifier une valeur pour ce paramètre. |
||
PercentEdbFreeSpaceThreshold |
Facultatif |
Le paramètre PercentEdbFreeSpaceThreshold spécifie le pourcentage d’espace disque du fichier .edb à partir duquel Exchange doit commencer à mettre en quarantaine des utilisateurs. Par exemple, si vous indiquez 10 %, Exchange commencera à mettre en quarantaine les plus gros utilisateurs lorsque la commande détectera que le disque dur va manquer d’espace en raison de la croissance du fichier .edb dans le délai spécifié dans le paramètre HourThreshold. La valeur par défaut de ce paramètre est 25 %. |
||
PercentLogFreeSpaceThreshold |
Facultatif |
Le paramètre PercentLogFreeSpaceThreshold spécifie le pourcentage d’espace disque des fichiers journaux à partir desquels Exchange doit commencer à mettre en quarantaine des utilisateurs. Si vous choisissez 10 %, par exemple, Exchange commencera à mettre en quarantaine les plus gros utilisateurs lorsque la commande détectera que le disque dur va manquer d’espace en raison de la croissance des journaux dans le délai spécifié dans le paramètre HourThreshold. La valeur par défaut de ce paramètre est 25 %. |
||
Quarantine |
Facultatif |
Le paramètre Quarantine spécifie que les gros utilisateurs seront mis en quarantaine. Si vous ne spécifiez pas ce paramètre, les utilisateurs ne sont pas mis en quarantaine. Vous n’avez pas besoin de spécifier de valeur pour ce paramètre. |
Exemple
Cet exemple indique comment exécuter le script Troubleshoot-DatabaseSpace.ps1 avec les paramètres suivants :
Les avertissements sont définis à 10 % d’espace disponible sur le volume contenant les journaux de base de données, et à 10 % d’espace disponible dans le fichier de base de données et le volume qui le contient.
Le seuil horaire est défini à 5 heures.
Avec ces paramètres, l’outil de dépannage met en quarantaine les gros utilisateurs s’il détecte que l’espace disponible sur le disque dur va atteindre 10 % ou moins dans les 5 heures à venir.
.\Troubleshoot-databasespace.ps1 -server MBX01 -PercentLogFreeSpace 10 -PercentEDBFreeSpace 10 -HourThreshold 5 -Quarantine
Remarque : |
---|
Cet exemple montre comment exécuter la commande manuellement une seule fois. Pour produire les données dont l’outil de dépannage a besoin pour surveiller efficacement votre serveur ou votre base de données, vous devez exécuter cette commande plusieurs fois à intervalles réguliers. Nous vous conseillons d’utiliser le Planificateur de tâches du système d’exploitation Microsoft Windows pour définir cette tâche. Pour plus d’informations, voir Vue d’ensemble du planificateur de tâches. |
Afficher le résultat de l’outil de dépannage de la croissance des journaux
Dans l’Observateur d’événements, les résultats du script Troubleshoot-DatabaseSpace.ps1 sont disponibles à l’emplacement suivant : Observateur d’événements > Journaux des applications et des services > Microsoft-Exchange-Troubleshooters/Operational.
Par exemple, les résultats suivants proviennent de l’événement ID 5101, dans le cas où le script a été exécuté correctement, sans aucune erreur.
L’outil de dépannage de l’espace de base de données a pris fin sur le volume D:\ pour la base de données MBD01 ; aucun problème n’a été détecté. Espace disque disponible EDB : 151938752512 B Espace libre du lecteur de journal : 151845265408 B Seuil d’espace libre EDB : 10% Seuil d’espace libre du journal : 10% Seuil horaire : 12 heures Taux de croissance actuel : 314572800 B/Hr |
Le tableau suivant affiche l’ID de l’événement, sa description et, si nécessaire, l’action à prendre.
Remarque : |
---|
Les descriptions de ce tableau sont des exemples d’informations pouvant faire partie de ces événements. |
ID d’événement | Description | Action |
---|---|---|
5100 |
L’outil de dépannage d’espace de base de données a démarré sur le volume D:\ pour la base de données MBD01. |
Information uniquement. Aucune action n’est requise. |
5101 |
L’outil de dépannage d’espace de base de données a pris fin sur le volume D:\ pour la base de données MBD01. Aucun problème n’a été détecté. |
Information uniquement. Aucune action n’est requise. |
5400 |
L’outil de dépannage d’espace de base de données a pris fin sur le volume D:\ pour la base de données MBD01. La base de données a dépassé le seuil d’espace libre. Les utilisateurs ont été mis en quarantaine pour éviter de manquer d’espace. |
Événement d’avertissement : Continuer la surveillance. Les utilisateurs vont être mis en quarantaine pendant six heures et ne pourront pas accéder à leur boîte aux lettres. |
5401 |
L’outil de dépannage d’espace de base de données a pris fin sur le volume D:\ pour la base de données MBD01. La base de données se trouve sous le seuil d’espace libre, mais ne croît pas à un taux inhabituel. Aucune action n’a été effectuée. |
Événement d’avertissement : Continuer la surveillance. |
5410 |
L’outil de dépannage d’espace de base de données a mis en quarantaine la boîte aux lettres f3bb8007-b6d1-45f5-b748-211d66fa43f6 dans la base de données MBD01. |
Événement d’avertissement : Cet événement sera créé lors de la création de l’événement 5400. Continuer la surveillance. |
5700 |
L’outil de dépannage d’espace de base de données a pris fin sur le volume D:\ pour la base de données MBD01. La base de données a dépassé le seuil d’espace libre et continue de croître. Une intervention manuelle est requise. |
Cet événement d’erreur indique que l’espace de la base de données a dépassé le seuil d’espace libre. Exécutez l’outil Microsoft Exchange Server User Monitor (Exmon) pour suivre les utilisateurs ou les services à l’origine d’une croissance excessive des journaux. Pour plus d’informations, voir Microsoft Exchange Server User Monitor. |
5701 |
L’outil de dépannage d’espace de base de données a détecté un problème lié à un espace faible sur le volume D:\ pour la base de données MBD01. L’approvisionnement de cette base de données a été désactivé. L’espace disponible de cette base de données est inférieur à 10 %. |
Cet événement d’erreur indique que l’approvisionnement a été supprimé pour la base de données. Dans ce cas, le script exécute la cmdlet Set-MailboxDatabase avec le paramètre ExcludeFromProvisioning défini sur Vous pouvez avoir besoin de déplacer des boîtes aux lettres vers un nouveau serveur pour rééquilibrer l’espace. |
5702 |
L’outil de dépannage d’espace de base de données a détecté un problème critique lié à un espace faible sur le volume D:\ pour la base de données MBD01. L’approvisionnement de cette base de données a été désactivé. L’espace disponible de cette base de données est inférieur à 10 %. |
Cet événement d’erreur indique que l’approvisionnement a été supprimé pour la base de données car les ressources sont dangereusement basses. Dans ce cas, le script exécute la cmdlet Set-MailboxDatabase avec le paramètre ExcludeFromProvisioning défini sur Vous pouvez avoir besoin de déplacer des utilisateurs vers une nouvelle base de données pour rééquilibrer l’espace. |
© 2010 Microsoft Corporation. Tous droits réservés.