Update-DscConfiguration
Überprüft den Pullserver auf eine aktualisierte Konfiguration und wendet ihn an.
Syntax
ComputerNameSet (Standardwert)
Update-DscConfiguration
[[-ComputerName] <String[]>]
[-Wait]
[-JobName <String>]
[-Credential <PSCredential>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CimSessionSet
Update-DscConfiguration
-CimSession <CimSession[]>
[-Wait]
[-JobName <String>]
[-ThrottleLimit <Int32>]
[-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.
Parametereigenschaften
| Typ: | |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
CimSessionSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ComputerName
Gibt ein Array von Computernamen an. Das Cmdlet wendet die Konfigurationseinstellungen auf die Computer an, die dieser Parameter angibt.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | China, Servername |
Parametersätze
ComputerNameSet
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt einen Benutzernamen und ein Kennwort als PSCredential- -Objekt für den Zielcomputer an. Verwenden Sie das cmdlet , um ein Get-Credential-Objekt abzurufen. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ComputerNameSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
