Test-SystemHealth

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-07-05

La cmdlet Test-SystemHealth permet de collecter des données sur votre système Microsoft Exchange et de les analyser conformément aux meilleures pratiques.

Syntaxe

test-SystemHealth [-ADCredentials <PSCredential>] [-Analyze <SwitchParameter>] [-Collect <SwitchParameter>] [-ConfigurationFileLocation <LongPath>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DomainController <Fqdn>] [-DownloadConfigurationUpdates <SwitchParameter>] [-ExchangeCredentials <PSCredential>] [-Export <SwitchParameter>] [-GenerateEvents <SwitchParameter>] [-GenerateSQMData <SwitchParameter>] [-MaxThreads <Int32>] [-MergeFileLocation <LongPath>] [-OutFileLocation <LongPath>] [-Roles <String[]>] [-ScanType <String>] [-ServerList <String[]>] [-Timeout <EnhancedTimeSpan>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Test-SystemHealth, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

ADCredentials

Facultatif

System.Management.Automation.PSCredential

Le paramètre ADCredentials spécifie les informations d'identification utilisées pour accéder au service d'annuaire Active Directory. La valeur par défaut correspond aux informations d'identification de l'utilisateur actuel.

Analyze

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Analyze active l'analyse des données collectées. La valeur $true active l'analyse. La valeur par défaut est $true.

Collect

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Collect active la collecte de données. La valeur $true active la collecte de données, La valeur par défaut est $true.

ConfigurationFileLocation

Facultatif

Microsoft.Exchange.Data.LongPath

Réservé à l'usage interne.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

Description

Facultatif

System.String

Le paramètre Description spécifie un intitulé descriptif pour l'analyse.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour accéder à Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser.

DownloadConfigurationUpdates

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre DownloadConfigurationUpdates vérifie l'existence de versions plus récentes du fichier de configuration et les télécharge le cas échéant. La valeur par défaut est $true, vérifie l'existence de versions plus récentes du fichier de configuration et les télécharge.

ExchangeCredentials

Facultatif

System.Management.Automation.PSCredential

Le paramètre ExchangeCredentials identifie les informations d'identification à appliquer pour accéder aux serveurs exécutant Exchange.

Export

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Export entraîne l'effacement des données sensibles du fichier de sortie spécifié. La valeur $true entraîne l'effacement des données. La valeur par défaut est $false.

GenerateEvents

Facultatif

System.Management.Automation.SwitchParameter

Réservé à l'usage interne.

GenerateSQMData

Facultatif

System.Management.Automation.SwitchParameter

Réservé à l'usage interne.

MaxThreads

Facultatif

System.Int32

Réservé à l'usage interne.

MergeFileLocation

Facultatif

Microsoft.Exchange.Data.LongPath

Réservé à l'usage interne.

OutFileLocation

Facultatif

Microsoft.Exchange.Data.LongPath

Le paramètre OutFileLocation identifie le nom et le chemin du fichier de données à générer.

Roles

Facultatif

System.String[]

Réservé à l'usage interne.

ScanType

Facultatif

System.String

Réservé à l'usage interne.

ServerList

Facultatif

System.String[]

Réservé à l'usage interne.

Timeout

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre Timeout spécifie le nombre de secondes s'écoulant avant l'expiration de l'opération. La valeur par défaut est de 300 secondes (5 minutes).

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple de code suivant illustre la commande Test-SystemHealth.

Test-SystemHealth