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 :

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

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

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

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

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

6. 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 : GUID Nom unique (DN) Nom de la base de données Remarque : Vous pouvez utiliser ce paramètre en association avec le paramètre Server.
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. Remarque : Vous pouvez utiliser ce paramètre en association avec le paramètre MailboxDatabaseName.
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.

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.

 © 2010 Microsoft Corporation. Tous droits réservés.