Get-DscConfiguration
Ruft die aktuelle Konfiguration der Knoten ab.
Syntax
Get-DscConfiguration
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Beschreibung
Das Get-DscConfiguration
Cmdlet 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
Mit diesem Befehl wird der aktuelle Zustand für den lokalen Computer abgerufen.
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 durch eine CIM-Sitzung angegeben wird. 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 variablen $Session . 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 ruft die aktuelle Konfiguration für die Computer ab, die durch die CimSession-Objekte identifiziert werden, die in der Variable $Session gespeichert sind, in diesem Fall der Computer namens Server01.
Parameter
-AsJob
Gibt an, dass dieses Cmdlet den Befehl als Hintergrundauftrag ausführt.
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[] |
Aliases: | Session |
Position: | Named |
Default value: | None |
Required: | False |
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 |