Test-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Testet, ob die tatsächliche Konfiguration auf den Knoten mit der gewünschten Konfiguration übereinstimmt.

Syntax

Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Path] <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    -ReferenceConfiguration <String>
    [<CommonParameters>]
Test-DscConfiguration
    [-ThrottleLimit <Int32>]
    -CimSession <CimSession[]>
    [-AsJob]
    [-Detailed]
    [<CommonParameters>]

Beschreibung

Das Test-DscConfiguration Cmdlet testet, ob die tatsächliche Konfiguration auf den Knoten mit der gewünschten Konfiguration übereinstimmt. Geben Sie mithilfe von Computernamen oder CIM-Sitzungen (Common Information Model) an, für welche Computer Sie Konfigurationen testen möchten. Wenn Sie keinen Zielcomputer angeben, testet das Cmdlet die Konfiguration des lokalen Computers.

Wenn die gewünschten und tatsächlichen Konfigurationen übereinstimmen, gibt das Cmdlet den Zeichenfolgenwert "True" zurück. Andernfalls wird der Zeichenfolgenwert "False" zurückgegeben.

Beispiele

Beispiel 1: Testkonfiguration für den lokalen Computer

Test-DscConfiguration

Dieser Befehl testet die Konfiguration für den lokalen Computer.

Beispiel 2: Testkonfiguration für einen angegebenen Computer

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Test-DscConfiguration -CimSession $Session

In diesem Beispiel wird die Konfiguration von einem Computer von einer CIM-Sitzung angegebenen Computer getestet. Das Beispiel erstellt eine CIM-Sitzung für einen Computer namens Server01 zur Verwendung mit dem Cmdlet. Erstellen Sie alternativ ein Array von CIM-Sitzungen, um das Cmdlet für mehrere angegebene Computer anzuwenden.

Der erste Befehl erstellt mithilfe des New-CimSession Cmdlets eine CIM-Sitzung und speichert dann das CimSession-Objekt in der $Session Variablen. Der Befehl fordert Sie zur Eingabe eines Kennworts auf. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help New-CimSession.

Der zweite Befehl testet die Konfiguration für die Computer, die durch die CimSession-Objekte identifiziert werden, die in der $Session Variablen gespeichert sind, in diesem Fall auf dem Computer mit dem Namen Server01.

Beispiel 3: Testkonfigurationen mit detaillierten Ergebnissen

Test-DscConfiguration -ComputerName "Server01", "Server02", "Server03" -Detailed

Dieser Befehl testet Konfigurationen für eine Reihe von Computern, die durch den ComputerName-Parameter angegeben werden, und gibt detaillierte Informationen zurück, die den Gesamtzustand, Ressourcen, die sich im gewünschten Zustand befinden, Ressourcen, die sich nicht im gewünschten Zustand befinden, und den Computernamen.

Beispiel 4: In einem Ordner angegebene Testkonfigurationen

Test-DscConfiguration -Path "C:\Dsc\Configurations"

Dieser Befehl testet Konfigurationen, die in einem Ordner definiert sind, der durch den Path-Parameter angegeben wird. Die Konfigurationen werden mit einer Reihe von Computern getestet, die jeweils durch den Dateinamen der Konfigurationsdatei identifiziert werden.

Beispiel 5: In einer Datei angegebene Testkonfigurationen

Test-DscConfiguration -ReferenceConfiguration "C:\Dsc\Configurations\WebServer.mof" -ComputerName "Server01", "Server02", "Server03"

Dieser Befehl testet eine in einer Datei definierte Konfiguration mit einer Gruppe von Computern, die durch den ComputerName-Parameter angegeben werden.

Parameter

-AsJob

Gibt an, dass dieses Cmdlet den Befehl als Hintergrundauftrag ausführt.

Wenn Sie den AsJob-Parameter angeben, gibt der Befehl ein Objekt zurück, das den Auftrag darstellt, und zeigt dann die Eingabeaufforderung an. Sie können in der Sitzung weiterarbeiten, bis der Auftrag abgeschlossen ist. Der Auftrag wird auf dem lokalen Computer erstellt, und die Ergebnisse von Remotecomputern werden automatisch an den lokalen Computer zurückgegeben. Um den Auftrag zu verwalten, verwenden Sie die Job-Cmdlets. Um die Auftragsergebnisse abzurufen, verwenden Sie das Cmdlet Receive-Job.

Um diesen Parameter verwenden zu können, müssen die lokalen Und Remotecomputer für Remoting konfiguriert werden. Unter Windows Vista und höheren Versionen des Windows-Betriebssystems müssen Sie Windows PowerShell mit der Option Als Administrator ausführen öffnen. Weitere Informationen finden Sie unter about_Remote_Requirements.

Weitere Informationen zu Windows PowerShell Hintergrundaufträgen finden Sie unter about_Jobs und about_Remote_Jobs.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines New-CimSession- oder Get-CimSession-Cmdlets . Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Gibt ein Array von Computernamen an, auf dem dieses Cmdlet die Konfiguration testet. Das Cmdlet testet das Konfigurationsdokument an dem Speicherort, der durch den Path-Parameter für diese Computer angegeben wird.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Gibt einen Benutzernamen und ein Kennwort als ein PSCredential -Objekt für den Zielcomputer an. Verwenden Sie das Get-Credential Cmdlet, um ein PSCredential-Objekt abzurufen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Gibt an, dass dieses Cmdlet ein detailliertes Ergebnis des Vergleichs des Konfigurationsdokuments mit dem gewünschten Zustand der Knoten zurückgibt. Das Ergebnis enthält Informationen wie den Gesamtzustand, Ressourcen, die sich im gewünschten Zustand befinden, Ressourcen, die sich nicht im gewünschten Zustand befinden, und Computername.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Gibt den Pfad eines Ordners an, der Konfigurationsdokumentdateien enthält. Das Cmdlet testet die Konfiguration mit dem gewünschten Zustand der Computer, die durch den ComputerName- oder CimSession-Parameter angegeben werden.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceConfiguration

Gibt den Pfad der Konfigurationsdokumentdatei an. Dieses Cmdlet testet die Konfiguration anhand des tatsächlichen Zustands von Computern, die durch den ComputerName - oder CimSession-Parameter angegeben werden.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen des Cmdlets erstellt werden können. Wenn dieser Parameter ausgelassen oder ein Wert von 0 eingegeben wird, berechnet Windows PowerShell ein optimales Drosselungslimit für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Dieser Drosselungsgrenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder den PC.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False