Freigeben über

Start-DscConfiguration

  • Referenz
Modul:
PSDesiredStateConfiguration

Wendet die Konfiguration auf Knoten an.

Syntax

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet Start-DscConfiguration wendet die Konfiguration auf Knoten an. Bei Verwendung mit dem parameter UseExisting wird die vorhandene Konfiguration auf dem Zielcomputer angewendet. Geben Sie an, auf welche Computer Sie die Konfiguration anwenden möchten, indem Sie Computernamen oder cim-Sitzungen (Common Information Model) angeben.

Standardmäßig erstellt dieses Cmdlet einen Auftrag und gibt ein Job--Objekt zurück. Wenn Sie weitere Informationen zu Hintergrundaufträgen benötigen, geben Sie Get-Help about_Jobsein. Wenn Sie dieses Cmdlet interaktiv verwenden möchten, geben Sie den Parameter Wait an.

Geben Sie den parameter Verbose an, um Details darüber anzuzeigen, was das Cmdlet tut, wenn konfigurationseinstellungen angewendet werden.

Beispiele

Beispiel 1: Anwenden von Konfigurationseinstellungen

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Dieser Befehl wendet die Konfigurationseinstellungen von C:\DSC\Configurations\ auf jeden Computer mit Einstellungen in diesem Ordner an. Der Befehl gibt Auftrag Objekte für jeden Zielknoten zurück, der bereitgestellt wird.

Beispiel 2: Anwenden von Konfigurationseinstellungen und Warten auf den Abschluss der Konfiguration

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Dieser Befehl wendet die Konfiguration von C:\DSC\Configurations\ auf den lokalen Computer an. Der Befehl gibt Auftrag Objekte für jeden Zielknoten zurück, der in diesem Fall nur auf dem lokalen Computer bereitgestellt wird. In diesem Beispiel wird der parameter Verbose angegeben. Daher sendet der Befehl Nachrichten an die Konsole, während er fortgesetzt wird. Der Befehl enthält den Parameter Wait. Daher können Sie die Konsole erst verwenden, wenn der Befehl alle Konfigurationsaufgaben abgeschlossen hat.

Beispiel 3: Anwenden von Konfigurationseinstellungen mithilfe einer CIM-Sitzung

$Session = New-CimSession -ComputerName "Server01" -Credential ACCOUNTS\PattiFuller
Start-DscConfiguration -Path "C:\DSC\Configurations\" -CimSession $Session

In diesem Beispiel werden Konfigurationseinstellungen auf einen angegebenen Computer angewendet. Im Beispiel wird eine CIM-Sitzung für einen Computer namens Server01 für die Verwendung mit dem Cmdlet erstellt. Erstellen Sie alternativ ein Array von CIM-Sitzungen, um das Cmdlet auf mehrere angegebene Computer anzuwenden.

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 NewCimSessionein, um weitere Informationen zu erfahren.

Der zweite Befehl wendet die Konfigurationseinstellungen von C:\DSC\Configurations auf die Computer an, die durch die CimSession In der variablen $Session gespeicherten Objekte identifiziert werden. In diesem Beispiel enthält die variable $Session eine CIM-Sitzung nur für den Computer mit dem Namen Server01. Der Befehl wendet die Konfiguration an. Der Befehl erstellt Auftrag Objekte für jeden konfigurierten Computer.

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. Dieser Parameter schränkt die Computer mit Konfigurationsdokumenten im Path Parameter auf diejenigen ein, die im Array angegeben sind.

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

-Force

Beendet den derzeit auf dem Zielcomputer ausgeführten Konfigurationsvorgang und beginnt mit dem neuen Start-Configuration-Vorgang. Wenn die RefreshMode-Eigenschaft des lokalen Konfigurations-Managers auf Pull-festgelegt ist, ändert die Angabe dieses Parameters in Push-.

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

-Path

Gibt einen Dateipfad eines Ordners an, der Konfigurationseinstellungendateien enthält. Dieses Cmdlet veröffentlicht und wendet diese Konfigurationseinstellungen auf Computer mit Einstellungsdateien im angegebenen Pfad an. Jeder Zielknoten muss über eine Einstellungsdatei des folgenden Formats verfügen: <NetBIOS Name>.mof.

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

-UseExisting

Gibt an, dass dieses Cmdlet die vorhandene Konfiguration anwendet. Die Konfiguration kann auf dem Zielcomputer vorhanden sein, indem sie mithilfe von Start-DscConfiguration oder mithilfe des cmdlets Publish-DscConfiguration veröffentlicht wird.

Bevor Sie diesen Parameter für dieses Cmdlet angeben, überprüfen Sie die Informationen in What's New in Windows PowerShell 5.0.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
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