Set-DscLocalConfigurationManager

  • Referenz
Modul:
PSDesiredStateConfiguration

Wendet LcM-Einstellungen (Local Configuration Manager) 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 Set-DscLocalConfigurationManager Cmdlet wendet LCM-Einstellungen oder Metakonfigurationen auf Knoten an. Geben Sie Computer an, indem Sie Computernamen angeben oder CIM-Sitzungen (Common Information Model) verwenden. Wenn Sie keinen Zielcomputer angeben, wendet das Cmdlet Einstellungen auf dem 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 Zielknoten an. Nachdem die Einstellungen empfangen wurden, verarbeitet LCM sie.

Warnung

Wenn mehrere Meta-Mofs für denselben Computer im angegebenen Ordner gespeichert sind, wird nur der 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. 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 New-CimSession.

Der zweite Befehl wendet LCM-Einstellungen für den Zielknoten von auf den Computer anC:\DSC\Configurations\, der durch die in der $Session Variablen gespeicherten CimSession-Objekte identifiziert wird. In diesem Beispiel enthält die $Session Variable nur eine CIM-Sitzung für den Computer mit dem Namen Server01. Der Befehl wendet die Einstellungen an. Nachdem die Einstellungen empfangen wurden, 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-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, die metakonfigurationsdokumente im Path-Parameter enthalten, auf die im Array angegebenen 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. Zum Abrufen eines PSCredential-Objekts verwenden Sie das Get-Credential-Cmdlet. 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

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Type:SwitchParameter
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. Das Cmdlet veröffentlicht und wendet diese LCM-Einstellungen auf Computer an, die über Einstellungsdateien im angegebenen Pfad verfügen. Jeder Zielknoten muss über eine Einstellungsdatei im folgenden Format verfügen: NetBIOS Name.meta.mof.

Type:String
Position:0
Default value:None
Required:True
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 der Wert eingegeben 0 wird, berechnet Windows PowerShell basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden, eine optimale Drosselungsgrenze für das Cmdlet. 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

-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