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\ på målnoderna. 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 det första meta-mof-objektet.

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 objektet CimSession i variabeln $Session. Kommandot uppmanar dig att ange ett lösenord. Om du vill ha mer information skriver du Get-Help New-CimSession.

Det andra kommandot tillämpar LCM-inställningar för målnoden från C:\DSC\Configurations\ på datorn som identifieras av CimSession objekt 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 en New-CimSession- eller Get-CimSession cmdlet. Standardvärdet är den aktuella sessionen på den lokala datorn.

Typ:CimSession[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String[]
Alias:CN, ServerName
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en filsökväg för en mapp som innehåller konfigurationsinställningar. 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.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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 på 0 anges 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 på datorn.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False