Set-DscLocalConfigurationManager
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-CimSession
ein, 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-Credential
ein, 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 |