Update-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Überprüft den Pullserver auf eine aktualisierte Konfiguration und wendet sie an.

Syntax

Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [[-ComputerName] <String[]>]
      [-Credential <PSCredential>]
      [-ThrottleLimit <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-DscConfiguration
      [-Wait]
      [-JobName <String>]
      [-ThrottleLimit <Int32>]
      -CimSession <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Update-DscConfiguration Cmdlet stellt eine Verbindung mit einem Pullserver her, lädt die Konfiguration herunter, wenn sie sich von der aktuellen Konfiguration auf dem Knoten unterscheidet, und wendet die Konfiguration dann auf den Computer an.

Dieses Cmdlet ist nur im Rahmen des Updaterollups vom November 2014 für Windows RT 8.1, Windows 8.1 und Windows Server 2012 R2 verfügbar.

Beispiele

Beispiel 1: Aktualisieren einer Konfiguration

Update-DscConfiguration -Wait -Verbose

Nach dem Ausführen dieses Befehls stellt der Server eine Verbindung mit dem registrierten Pulldienst her, lädt die neueste zugewiesene Konfiguration herunter und wendet sie dann an. Die Parameter Wait und Verbose sind optional. Beim interaktiven Arbeiten ermöglichen diese kombinierten Parameter Echtzeitfeedback über Fortschritt und Erfolg oder Fehler beim Anwenden der Konfiguration.

Beispiel 2: Aktualisieren einer Konfiguration durch Herstellen einer Verbindung über eine CIM-Sitzung

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

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 der computer aktualisiert, der in cimSession angegeben ist $Session. Der Befehl gibt den Wait-Parameter an. Die Konsole akzeptiert keine zusätzlichen Befehle, bis der aktuelle Befehl abgeschlossen ist.

Parameter

-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. Das Cmdlet wendet die Konfigurationseinstellungen auf die Computer an, die mit diesem Parameter angegeben werden.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
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

-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

-JobName

Gibt einen Anzeigenamen für einen Auftrag an. Wenn Sie diesen Parameter angeben, wird das Cmdlet Auftrag ausgeführt und gibt ein Job-Objekt zurück.

Standardmäßig weist Windows PowerShell den Namen JobN zu, wobei N eine ganze Zahl ist.

Wenn Sie den Parameter Wait angeben, geben Sie diesen Parameter nicht an.

Type:String
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

-Wait

Gibt an, dass das Cmdlet die Konsole blockiert, bis alle Konfigurationsaufgaben abgeschlossen sind.

Wenn Sie diesen Parameter angeben, geben Sie den Parameter JobName nicht an.

Type:SwitchParameter
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