Set-DscLocalConfigurationManager

  • Referentie
Module:
PSDesiredStateConfiguration

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

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

Description

De Set-DscLocalConfigurationManager cmdlet past LCM-instellingen of metaconfiguratie toe op knooppunten. Geef computers op door computernamen op te geven of door CIM-sessies (Common Information Model) te gebruiken. 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, worden deze door LCM verwerkt.

Waarschuwing

Als er meerdere meta-mofs voor dezelfde computer zijn opgeslagen in de opgegeven map, wordt alleen de eerste meta-mof 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 met 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 New-CimSession cmdlet en slaat u vervolgens het CimSession-object op in de $Session variabele. De opdracht vraagt u om een wachtwoord. Typ Get-Help New-CimSession voor meer informatie.

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

Parameters

-CimSession

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

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

-ComputerName

Hiermee geeft u een matrix met computernamen. Met deze parameter worden de computers met metaconfiguratiedocumenten in de path-parameter beperkt tot de computers die zijn opgegeven in de matrix.

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Hiermee geeft u een gebruikersnaam en wachtwoord, als een PSCredential-object , voor de doelcomputer. Gebruik de cmdlet Get-Credential om een PSCredential-object te verkrijgen. Typ Get-Help Get-Credential voor meer informatie.

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

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

-Path

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False