Freigeben über


Test-SystemHealth

Dieses Cmdlet ist nur in Exchange Server 2010 verfügbar.

Verwenden Sie das Cmdlet Test-SystemHealth, um Daten zu Ihrem Microsoft Exchange-System zu sammeln und die Daten gemäß bewährten Methoden zu analysieren.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

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

Beschreibung

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Test-SystemHealth

In diesem Beispiel werden Daten zu Ihrem Exchange-System gesammelt.

Beispiel 2

$SysHealth = Test-SystemHealth -OutData

[System.IO.File]::WriteAllBytes('D:\temp\SystemHealthOutData.xml', $SysHealth.FileData)

In diesem Beispiel werden die Ausgabedaten als Bytestream in der Variablen namens $SysHealth gespeichert. Der Inhalt wird dann in die SystemHealthOutData.xml Datei im Ordner D:\temp geschrieben.

Parameter

-ADCredentials

Der PARAMETER ADCredentials gibt den Benutzernamen und das Kennwort an, die für den Zugriff auf Active Directory verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Analyze

Der Schalter Analysieren ermöglicht die Analyse der gesammelten Daten. Sie müssen bei dieser Option keinen Wert angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Collect

Der Schalter Collect ermöglicht die Datensammlung. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ConfigurationData

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ConfigurationFileLocation

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:LongPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Description

Der Description-Parameter gibt eine beschreibende Bezeichnung für die Überprüfung an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: 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

-DownloadConfigurationUpdates

Der Schalter DownloadConfigurationUpdates sucht nach neueren Versionen der Konfigurationsdatei und lädt sie herunter. Sie müssen bei dieser Option keinen Wert angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ExchangeCredentials

Der Parameter ExchangeCredentials gibt den Benutzernamen und das Kennwort an, die für den Zugriff auf Exchange-Server verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Export

Die Option Exportieren bewirkt, dass vertrauliche Daten aus der angegebenen Ausgabedatei entfernt werden. Sie müssen bei dieser Option keinen Wert angeben.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GenerateEvents

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-GenerateSQMData

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MaxThreads

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MergeFileLocation

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:LongPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-OutData

Der Schalter OutData gibt an, ob die Ausgabedaten als Bytestream gesendet werden. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie z. B. den Befehl ausführen: $temp = Test-SystemHealth -OutData, $temp enthält den Bytestream der Ausgabedaten, und Sie können ihn mit dem Befehl Set-Content in xml zurücklegen. Ein Codebeispiel finden Sie unter "Beispiel 2" in diesem Thema.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-OutFileLocation

Der OutFileLocation-Parameter identifiziert den Namen und pfad der zu generierenden Datendatei.

Type:LongPath
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Roles

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ScanType

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ServerList

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Timeout

Der Timeout-Parameter gibt die Anzahl von Sekunden an, bevor das Timeout für den Vorgang auftritt. Der Standardwert ist 300 Sekunden (5 Minuten).

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.