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 Start-DscConfiguration Cmdlet 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 ein Auftrag und gibt ein Job Objekt zurück. Um weitere Informationen zu Hintergrundaufträgen zu finden, geben Sie ein Get-Help about_Jobs. Geben Sie den Parameter Wait an, um dieses Cmdlet interaktiv zu verwenden.

Geben Sie den Parameter Verbose an, um Details dazu anzuzeigen, was das Cmdlet durchführt, wenn es Konfigurationseinstellungen anwendet.

Beispiele

Beispiel 1: Anwenden von Konfigurationseinstellungen

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

Mit diesem Befehl werden die Konfigurationseinstellungen C:\DSC\Configurations\ auf jeden Computer angewendet, der über Einstellungen in diesem Ordner verfügt. Der Befehl gibt Job-Objekte für jeden Zielknoten zurück, an den bereitgestellt wird.

Beispiel 2: Anwenden von Konfigurationseinstellungen und Warten, bis die Konfiguration abgeschlossen ist

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

Mit diesem Befehl wird die Konfiguration C:\DSC\Configurations\ auf den lokalen Computer angewendet. Der Befehl gibt Job-Objekte für jeden Zielknoten zurück, an den bereitgestellt wird, in diesem Fall nur für den lokalen Computer. In diesem Beispiel wird der Verbose-Parameter angegeben. Daher sendet der Befehl nachrichten an die Konsole, während er fortfährt. Der Befehl enthält den Wait-Parameter . 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 die Konfigurationseinstellungen für einen bestimmten Computer angewendet. 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 NewCimSession.

Mit dem zweiten Befehl werden die Konfigurationseinstellungen C:\DSC\Configurations auf die Computer angewendet, die durch die in der $Session Variablen gespeicherten CimSession-Objekte identifiziert werden. In diesem Beispiel enthält die $Session Variable nur eine CIM-Sitzung für den Computer mit dem Namen Server01. Der Befehl wendet die Konfiguration an. Der Befehl erstellt Job-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-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. Dieser Parameter schränkt die Computer mit Konfigurationsdokumenten im Path-Parameter auf die im Array angegebenen Computer ein.

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

-Force

Beendet den Konfigurationsvorgang, der derzeit auf dem Zielcomputer ausgeführt wird, und startet den neuen Start-Configuration Vorgang. Wenn die RefreshMode-Eigenschaft des Lokalen Configuration Manager auf Pull festgelegt ist, wird sie durch Angabe dieses Parameters in Push geändert.

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

-Path

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

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

-UseExisting

Gibt an, dass dieses Cmdlet die vorhandene Konfiguration anwendet. Die Konfiguration kann auf dem Zielcomputer vorhanden sein, indem sie mithilfe Start-DscConfiguration des Cmdlets Publish-DscConfiguration oder durch Veröffentlichung erlässt.

Bevor Sie diesen Parameter für dieses Cmdlet angeben, überprüfen Sie die Informationen unter Neuigkeiten in Windows PowerShell 5.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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