Freigeben über

Set-DscLocalConfigurationManager

  • Referenz
Modul:
PSDesiredStateConfiguration

Wendet lokale Konfigurations-Manager-Einstellungen (LCM) auf Knoten an.

Syntax

Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [[-ComputerName] <String[]>]
   [-Credential <PSCredential>]
   [-ThrottleLimit <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DscLocalConfigurationManager
   [-Path] <String>
   [-Force]
   [-ThrottleLimit <Int32>]
   -CimSession <CimSession[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-DscLocalConfigurationManager wendet LCM-Einstellungen oder Metakonfigurationen auf Knoten an. Geben Sie Computer an, indem Sie Computernamen angeben oder Common Information Model (CIM)-Sitzungen verwenden. Wenn Sie keinen Zielcomputer angeben, wendet das Cmdlet Einstellungen auf den lokalen Computer an.

Beispiele

Beispiel 1: Anwenden von LCM-Einstellungen

Set-DscLocalConfigurationManager -Path "C:\DSC\Configurations\"

Dieser Befehl wendet die LCM-Einstellungen von C:\DSC\Configurations\ auf die zielbezogenen Knoten an. Nach Erhalt der Einstellungen verarbeitet LCM sie.

Warnung

Wenn mehrere Meta-Mofs für denselben Computer im angegebenen Ordner gespeichert sind, wird nur das erste Meta-Mof angewendet.

Beispiel 2: Anwenden von LCM-Einstellungen mithilfe einer CIM-Sitzung

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

In diesem Beispiel werden LCM-Einstellungen auf einen Computer angewendet und die Einstellungen 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 New-CimSessionein, um weitere Informationen zu erfahren.

Der zweite Befehl wendet LCM-Einstellungen für den Zielknoten von C:\DSC\Configurations\ auf den Computer an, der durch die CimSession- Objekte identifiziert wird, die in der variablen $Session gespeichert sind. In diesem Beispiel enthält die variable $Session eine CIM-Sitzung nur für den Computer mit dem Namen Server01. Der Befehl wendet die Einstellungen an. Nach Erhalt der Einstellungen verarbeitet LCM sie.

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 Metakonfigurationsdokumenten 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

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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

-Path

Gibt einen Dateipfad eines Ordners an, der Konfigurationseinstellungendateien enthält. Das Cmdlet veröffentlicht und wendet diese LCM-Einstellungen auf Computer an, auf denen Einstellungendateien im angegebenen Pfad enthalten sind. Jeder Zielknoten muss über eine Einstellungsdatei des folgenden Formats verfügen: NetBIOS Name.meta.mof.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
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

-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