Freigeben über

Test-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

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

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 cmdlet Test-DscConfiguration testet, ob die tatsächliche Konfiguration auf den Knoten der gewünschten Konfiguration entspricht. Geben Sie an, für welche Computer Sie Konfigurationen mithilfe von Computernamen oder CIM-Sitzungen (Common Information Model) 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 einen Zeichenfolgenwert von 'True' zurück. Andernfalls wird ein Zeichenfolgenwert von '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 Testkonfiguration von einem Computer getestet, der von einer CIM-Sitzung angegeben wird. Im Beispiel wird eine CIM-Sitzung für einen Computer namens Server01 für die Verwendung mit dem Cmdlet erstellt. Erstellen Sie alternativ ein Array von CIM-Sitzungen, um das Cmdlet auf mehrere angegebene Computer anzuwenden.

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

Die zweite Befehlstestkonfiguration für die Computer, die durch die CimSession Objekte identifiziert werden, die in der variablen $Session gespeichert sind, in diesem Fall der Computer mit dem Namen Server01.

Beispiel 3: Testen von Konfigurationen mit detaillierten Ergebnissen

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

Dieser Befehl testet Konfigurationen für einen Satz von Computern, die vom 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 und Computernamen befinden.

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 parameter Path angegeben wird. Die Konfigurationen werden anhand einer Reihe von Computern getestet, die jeweils durch den Dateinamen der Konfigurationsdatei identifiziert werden.

Beispiel 5: Testkonfigurationen, die in einer Datei angegeben sind

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

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

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. Verwenden Sie zum Verwalten des Auftrags die Cmdlets "Auftrag". Verwenden Sie das Cmdlet Receive-Job, um die Auftragsergebnisse abzurufen.

Um diesen Parameter zu verwenden, müssen die lokalen und Remotecomputer für Remoting konfiguriert sein, und 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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Cmdlet. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Typ:CimSession[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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 parameter Path auf diesen Computern angegeben wird.

Typ:String[]
Aliase:CN, ServerName
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Credential

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

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Detailed

Gibt an, dass dieses Cmdlet ein detailliertes Ergebnis zurückgibt, um das Konfigurationsdokument mit dem gewünschten Zustand der Knoten zu vergleichen. Das Ergebnis enthält Informationen wie gesamter Zustand, Ressourcen, die sich im gewünschten Zustand befinden, Ressourcen, die nicht im gewünschten Zustand sind, und Computername.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad eines Ordners an, der Konfigurationsdokumentdateien enthält. Das Cmdlet testet die Konfiguration anhand des gewünschten Zustands von Computern, die vom parameter ComputerName oder CimSession angegeben werden.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReferenceConfiguration

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ThrottleLimit

Gibt die maximale Anzahl gleichzeitiger Vorgänge an, die zum Ausführen des Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen wird 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. Der Drosselungsgrenzwert gilt nur für das aktuelle Cmdlet, nicht für die Sitzung oder für den Computer.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False