Delen via

Set-DscLocalConfigurationManager

  • Referentie
Module:
PSDesiredStateConfiguration

Past LCM-instellingen (Local Configuration Manager) toe op knooppunten.

Syntaxis

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

Description

De Set-DscLocalConfigurationManager cmdlet past LCM-instellingen of metaconfiguratie toe op knooppunten. Geef computers op door computernamen of CIM-sessies (Common Information Model) op te geven. Als u geen doelcomputer opgeeft, past de cmdlet instellingen toe op de lokale computer.

Voorbeelden

Voorbeeld 1: LCM-instellingen toepassen

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

Met deze opdracht worden de LCM-instellingen van C:\DSC\Configurations\ toegepast op de doelknooppunten. Nadat de instellingen zijn ontvangen, verwerkt LCM deze.

Waarschuwing

Als er meerdere meta-mofs zijn voor dezelfde computer die is opgeslagen in de opgegeven map, wordt alleen de eerste metamof toegepast.

Voorbeeld 2: LCM-instellingen toepassen met behulp van een CIM-sessie

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

In dit voorbeeld worden LCM-instellingen toegepast op een computer en worden de instellingen toegepast. In het voorbeeld wordt een CIM-sessie gemaakt voor een computer met de naam Server01 voor gebruik met de cmdlet. U kunt ook een matrix van CIM-sessies maken om de cmdlet toe te passen op meerdere opgegeven computers.

Met de eerste opdracht maakt u een CIM-sessie met behulp van de cmdlet New-CimSession en slaat u vervolgens het CimSession--object op in de variabele $Session. De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSessionvoor meer informatie.

Met de tweede opdracht worden LCM-instellingen voor het doelknooppunt van C:\DSC\Configurations\ toegepast op de computer die is geïdentificeerd door de CimSession objecten die zijn opgeslagen in de $Session variabele. In dit voorbeeld bevat de variabele $Session alleen een CIM-sessie voor de computer met de naam Server01. Met de opdracht worden de instellingen toegepast. Nadat de instellingen zijn ontvangen, verwerkt LCM deze.

Parameters

-CimSession

De cmdlet wordt uitgevoerd in een externe sessie of op een externe computer. Voer een computernaam of een sessieobject in, zoals de uitvoer van een New-CimSession of Get-CimSession cmdlet. De standaardwaarde is de huidige sessie op de lokale computer.

Type:CimSession[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van computernamen. Met deze parameter worden de computers met metagegevensconfiguratiedocumenten in de parameter Path beperkt tot computers die zijn opgegeven in de matrix.

Type:String[]
Aliassen:CN, ServerName
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een gebruikersnaam en wachtwoord, als een PSCredential-object, voor de doelcomputer. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u een bestandspad op van een map die configuratie-instellingenbestanden bevat. De cmdlet publiceert en past deze LCM-instellingen toe op computers met instellingenbestanden in het opgegeven pad. Elk doelknooppunt moet een instellingenbestand van de volgende indeling hebben: NetBIOS Name.meta.mof.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ThrottleLimit

Hiermee geeft u het maximum aantal gelijktijdige bewerkingen op dat kan worden ingesteld om de cmdlet uit te voeren. Als deze parameter wordt weggelaten of als er een waarde van 0 wordt ingevoerd, berekent Windows PowerShell een optimale beperkingslimiet voor de cmdlet op basis van het aantal CIM-cmdlets dat op de computer wordt uitgevoerd. De beperkingslimiet is alleen van toepassing op de huidige cmdlet, niet op de sessie of op de computer.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False