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 UseExisting-Parameter wird die vorhandene Konfiguration auf dem Zielcomputer angewendet. Geben Sie an, auf welche Computer Sie Konfiguration anwenden möchten, indem Sie Computernamen oder mithilfe von Common Information Model (CIM)-Sitzungen angeben.

Standardmäßig erstellt dieses Cmdlet ein Auftrag und gibt ein Job Objekt zurück. Weitere Informationen zu Hintergrundaufträgen 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\"

Dieser Befehl wendet die Konfigurationseinstellungen auf C:\DSC\Configurations\ jeden Computer an, der Einstellungen in diesem Ordner enthält. 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

Dieser Befehl wendet die Konfiguration auf den lokalen Computer an C:\DSC\Configurations\ . 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 fortgeht. Der Befehl enthält den Parameter "Warten ". 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 eine CIM-Sitzung mithilfe des New-CimSession Cmdlets 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.

Der zweite Befehl wendet die Konfigurationseinstellungen auf C:\DSC\Configurations die Computer an, die von den In der $Session Variablen gespeicherten CimSession-Objekten identifiziert werden. In diesem Beispiel enthält die $Session Variable nur eine CIM-Sitzung für den Computer namens 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 Cmdlets "New-CimSession " oder "Get-CimSession ". Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Type:	CimSession[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Gibt ein Array von Computernamen an. Dieser Parameter beschränkt die Computer mit Konfigurationsdokumenten im Pfadparameter auf diejenigen, die im Array angegeben sind.

Type:	String[]
Aliases:	CN, ServerName
Position:	1
Default value:	None
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
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 zum Abrufen eines PSCredential-Objekts das Get-Credential Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Type:	PSCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 Configuration Manager auf Pull festgelegt ist, wird dieser Parameter in Push geändert.

Type:	SwitchParameter
Position:	Named
Default value:	None
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
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 Einstellungendateien im angegebenen Pfad verfügen. Jeder Zielknoten muss über eine Einstellungsdatei des folgenden Formats verfügen: <NetBIOS Name>.mof

Type:	String
Position:	0
Default value:	None
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 nicht angegeben wird oder ein Wert 0 eingegeben wird, berechnet Windows PowerShell eine optimale Drosselungsgrenze für das Cmdlet basierend auf der Anzahl von 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
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 sie mithilfe Start-DscConfiguration des Cmdlets Publish-DscConfiguration verwenden oder veröffentlichen.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Wait

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False