Sdílet prostřednictvím


Set-DscLocalConfigurationManager

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

Syntaxe

ComputerNameSet (Výchozí)

Set-DscLocalConfigurationManager
    [-Path] <String>
    [[-ComputerName] <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CimSessionSet

Set-DscLocalConfigurationManager
    [-Path] <String>
    -CimSession <CimSession[]>
    [-Force]
    [-ThrottleLimit <Int32>]
    [-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.

Výstraha

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. Pro více informací zadejte 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.

Vlastnosti parametru

Typ:

CimSession[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

CimSessionSet
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Čína, Název serveru

Sady parametrů

ComputerNameSet
Position:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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. Pro více informací zadejte Get-Help Get-Credential.

Vlastnosti parametru

Typ:PSCredential
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ComputerNameSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Force

Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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č.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.