Restore-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Wendet die vorherige Konfiguration für den Knoten erneut an.

Syntax

Restore-DscConfiguration
       [-CimSession <CimSession[]>]
       [-ThrottleLimit <Int32>]
       [-AsJob]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Restore-DscConfiguration Cmdlet wendet die vorherige Konfiguration für den Knoten erneut an, wenn eine vorherige Konfiguration vorhanden ist. Geben Sie Computer mithilfe von CIM-Sitzungen (Common Information Model) an. Wenn Sie keinen Zielcomputer angeben, stellt das Cmdlet die Konfiguration des lokalen Computers wieder her. Wenn keine vorherige Konfiguration für einen bestimmten Knoten vorhanden ist, gibt dieses Cmdlet eine Fehlermeldung zurück.

Dieses Cmdlet unterstützt den Confirm-Parameter nicht.

Beispiele

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

Restore-DscConfiguration

Dieser Befehl stellt die Konfiguration für den lokalen Computer wieder her.

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

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

In diesem Beispiel wird die Konfiguration von einem von einer CIM-Sitzung angegebenen Computer wiederhergestellt. 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.

Mit dem zweiten Befehl wird die Konfiguration für die Computer wiederhergestellt, die durch die in der $Session Variablen gespeicherten CimSession-Objekte identifiziert werden, in diesem Fall der Computer mit dem Namen 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.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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