Freigeben über

Get-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Ruft die aktuelle Konfiguration der Knoten ab.

Syntax

Get-DscConfiguration
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-DscConfiguration ruft die aktuelle Konfiguration der Knoten ab, wenn die Konfiguration vorhanden ist. Geben Sie Computer mithilfe von CIM-Sitzungen (Common Information Model) an. Wenn Sie keinen Zielcomputer angeben, ruft das Cmdlet die Konfiguration vom lokalen Computer ab.

Beispiele

Beispiel 1: Abrufen der Konfiguration für den lokalen Computer

Get-DscConfiguration

Dieser Befehl ruft den aktuellen Zustand für den lokalen Computer ab.

Beispiel 2: Abrufen der Konfiguration für einen angegebenen Computer

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

In diesem Beispiel wird der aktuelle Zustand von einem Computer abgerufen, 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.

Der zweite Befehl ruft die aktuelle Konfiguration für die Computer ab, die durch die CimSession Objekte identifiziert werden, die in der variablen $Session gespeichert sind, in diesem Fall der Computer mit dem Namen Server01.

Parameter

-AsJob

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

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[]
Aliase:Session
Position:Named
Standardwert:None
Erforderlich:False
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