Sdílet prostřednictvím

Set-DscLocalConfigurationManager

  • Reference
Modul:
PSDesiredStateConfiguration

Použije nastavení nástroje Local Configuration Manager (LCM) na uzly.

Syntaxe

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

Rutina Set-DscLocalConfigurationManager použije nastavení LCM nebo meta-configuration na uzly. Zadejte počítače zadáním názvů počítačů nebo pomocí relací CIM (Common Information Model). Pokud cílovou počítač nezadáte, použije rutina nastavení na místní počítač.

Příklady

Příklad 1: Použití nastavení LCM

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

Tento příkaz použije nastavení LCM z C:\DSC\Configurations\ na cílové uzly. Po přijetí nastavení je LCM zpracuje.

Varování

Pokud je ve stejné složce uložené více metamů, použije se pouze první meta mof.

Příklad 2: Použití nastavení LCM pomocí relace CIM

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

Tento příklad použije nastavení LCM na počítač a použije nastavení. Příklad vytvoří relaci CIM pro počítač s názvem Server01 pro použití s rutinou. Případně můžete vytvořit pole relací CIM, které použije rutinu na více zadaných počítačů.

První příkaz vytvoří relaci CIM pomocí rutiny New-CimSession a pak uloží objekt CimSession do proměnné $Session. Příkaz vás vyzve k zadání hesla. Další informace potřebujete zadáním Get-Help New-CimSession.

Druhý příkaz použije nastavení LCM pro cílový uzel z C:\DSC\Configurations\ na počítač identifikovaný CimSession objekty uložené v proměnné $Session. V tomto příkladu proměnná $Session obsahuje relaci CIM pouze pro počítač s názvem Server01. Příkaz použije nastavení. Po přijetí nastavení je LCM zpracuje.

Parametry

-CimSession

Spustí rutinu ve vzdálené relaci nebo ve vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSes sion. Výchozí hodnota je aktuální relace na místním počítači.

Typ:CimSession[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje pole názvů počítačů. Tento parametr omezuje počítače s dokumenty meta-konfigurace v Path parametr na počítače zadané v poli.

Typ:String[]
Aliasy:CN, ServerName
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelské jméno a heslo, jako PSCredential objekt, pro cílový počítač. K získání objektu PSCredential použijte rutinu Get-Credential. Další informace potřebujete zadáním Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Určuje cestu k souboru složky, která obsahuje soubory nastavení konfigurace. Rutina publikuje a použije tato nastavení LCM na počítače, které mají soubory nastavení v zadané cestě. Každý cílový uzel musí mít soubor nastavení s následujícím formátem: NetBIOS Name.meta.mof.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ThrottleLimit

Určuje maximální počet souběžných operací, které lze navázat pro spuštění rutiny. Pokud tento parametr vynecháte nebo zadáte hodnotu 0, windows PowerShell vypočítá optimální limit omezení pro rutinu na základě počtu rutin CIM spuštěných v počítači. Omezení se vztahuje pouze na aktuální rutinu, ne na relaci nebo na počítač.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False