Dela via

Set-DscLocalConfigurationManager

  • Referens
Modul:
PSDesiredStateConfiguration

Tillämpar LCM-inställningar (Local Configuration Manager) på noder.

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

Cmdleten Set-DscLocalConfigurationManager tillämpar LCM-inställningar, eller metakonfiguration, på noder. Ange datorer genom att ange datornamn eller genom att använda CIM-sessioner (Common Information Model). Om du inte anger en måldator tillämpar cmdleten inställningar på den lokala datorn.

Exempel

Exempel 1: Tillämpa LCM-inställningar

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

Det här kommandot tillämpar LCM-inställningarna från C:\DSC\Configurations\ de riktade noderna. När inställningarna har tagits emot bearbetar LCM dem.

Varning

Om det finns flera metamofs för samma dator som lagras i den angivna mappen tillämpas endast den första meta-mof.

Exempel 2: Tillämpa LCM-inställningar med hjälp av en CIM-session

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

Det här exemplet tillämpar LCM-inställningar på en dator och tillämpar inställningarna. I exemplet skapas en CIM-session för en dator med namnet Server01 för användning med cmdleten. Du kan också skapa en matris med CIM-sessioner för att tillämpa cmdleten på flera angivna datorer.

Det första kommandot skapar en CIM-session med hjälp av cmdleten New-CimSession och lagrar sedan CimSession-objektet i variabeln $Session . Kommandot uppmanar dig att ange ett lösenord. För mer information ange Get-Help New-CimSession.

Det andra kommandot använder LCM-inställningar för målnoden från C:\DSC\Configurations\ den dator som identifieras av CimSession-objekten som lagras i variabeln $Session . I det här exemplet innehåller variabeln $Session endast en CIM-session för datorn med namnet Server01. Kommandot tillämpar inställningarna. När inställningarna har tagits emot bearbetar LCM dem.

Parametrar

-CimSession

Kör cmdleten i en fjärrsession eller på en fjärrdator. Ange ett datornamn eller ett sessionsobjekt, till exempel utdata från cmdleten New-CimSession eller Get-CimSession . Standardinställningen är den aktuella sessionen på den lokala datorn.

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

-ComputerName

Anger en matris med datornamn. Den här parametern begränsar de datorer som har metakonfigurationsdokument i parametern Path till de som anges i matrisen.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Credential

Anger ett användarnamn och lösenord som ett PSCredential-objekt för måldatorn. Om du vill hämta ett PSCredential-objekt använder du cmdleten Get-Credential. För mer information ange Get-Help Get-Credential.

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

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

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

-Path

Anger en filsökväg för en mapp som innehåller konfigurationsinställningsfiler. Cmdleten publicerar och tillämpar dessa LCM-inställningar på datorer som har inställningsfiler i den angivna sökvägen. Varje målnod måste ha en inställningsfil med följande format: NetBIOS Name.meta.mof.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Anger det maximala antalet samtidiga åtgärder som kan upprättas för att köra cmdleten. Om den här parametern utelämnas eller ett värde anges 0 beräknar Windows PowerShell en optimal begränsningsgräns för cmdleten baserat på antalet CIM-cmdletar som körs på datorn. Begränsningsgränsen gäller endast för den aktuella cmdleten, inte för sessionen eller datorn.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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