Freigeben über

Update-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Überprüft den Pullserver auf eine aktualisierte Konfiguration und wendet ihn 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 cmdlet Update-DscConfiguration stellt eine Verbindung mit einem Pullserver her, lädt die Konfiguration herunter, wenn sie sich von dem, was auf dem Knoten aktuell ist, unterscheidet, und wendet dann die Konfiguration auf den Computer an.

Dieses Cmdlet ist nur im Rahmen des November 2014-Updaterollups für Windows RT 8.1, Windows 8.1 und Windows Server 2012 R2verfü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 wenden Sie ihn an. Die Parameter Wait und Verbose sind optional. Bei der interaktiven Arbeit ermöglichen diese Parameter kombiniert echtzeitbasiertes Feedback zu Fortschritt und Erfolg oder Fehler bei der Anwendung 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 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 aktualisiert den in der CimSession in $Sessiongespeicherten Computer. Der Befehl gibt den Parameter Wait an. Die Konsole akzeptiert erst zusätzliche Befehle, wenn 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 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. Das Cmdlet wendet die Konfigurationseinstellungen auf die Computer an, die dieser Parameter angibt.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
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

-JobName

Gibt einen Anzeigenamen für einen Auftrag an. Wenn Sie diesen Parameter angeben, wird das Cmdlet als 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.

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

-Wait

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

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

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

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False