Sdílet prostřednictvím

Set-DscLocalConfigurationManager

  • Reference
Modul:
PSDesiredStateConfiguration

Použije na uzly nastavení místního Configuration Manager (LCM).

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

Rutina Set-DscLocalConfigurationManager použije nastavení LCM neboli metakongurace na uzly. Počítače můžete určit zadáním názvů počítačů nebo pomocí relací MODELU CIM (Common Information Model). Pokud nezadáte cílový počítač, rutina použije 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.

Upozornění

Pokud je v zadané složce pro stejný počítač uložených více metadat mofs, 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é rutinu použijí na více určených počítačů.

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

Druhý příkaz použije nastavení LCM cílového uzlu z C:\DSC\Configurations\ na počítač identifikovaný objekty CimSession uložené v $Session proměnné. V tomto příkladu $Session proměnná 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 na vzdáleném počítači. Zadejte název počítače nebo objekt relace, například výstup rutiny New-CimSession nebo Get-CimSession . Výchozí hodnota je aktuální relace v místním počítači.

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

-ComputerName

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

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

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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í v následujícím formátu: NetBIOS Name.meta.mof.

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

-ThrottleLimit

Určuje maximální počet souběžných operací, které je možné vytvořit pro spuštění rutiny. Pokud je tento parametr vynechán nebo je zadána hodnota 0 , vypočítá Windows PowerShell 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, nikoli na relaci nebo na počítač.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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