Sdílet prostřednictvím

Start-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Použije konfiguraci na uzly.

Syntaxe

Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-Path] <String>]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     [[-ComputerName] <String[]>]
     [-Credential <PSCredential>]
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-DscConfiguration
     [-Wait]
     [-Force]
     -CimSession <CimSession[]>
     [-ThrottleLimit <Int32>]
     [-UseExisting]
     [-JobName <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Rutina Start-DscConfiguration aplikuje konfiguraci na uzly. Při použití s parametrem UseExisting se použije stávající konfigurace v cílovém počítači. Určete, na které počítače chcete použít konfiguraci, zadáním názvů počítačů nebo pomocí relací MODELU CIM (Common Information Model).

Ve výchozím nastavení tato rutina vytvoří úlohu a vrátí objekt Job. Další informace o úlohách na pozadí zadejte Get-Help about_Jobs. Pokud chcete tuto rutinu používat interaktivně, zadejte parametr Wait.

Zadáním parametru Podrobné zobrazíte podrobnosti o tom, co rutina dělá, když použije nastavení konfigurace.

Příklady

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

Start-DscConfiguration -Path "C:\DSC\Configurations\"

Tento příkaz použije nastavení konfigurace z C:\DSC\Configurations\ na každý počítač, který má nastavení v dané složce. Příkaz vrátí Job objekty pro každý cílový uzel nasazený.

Příklad 2: Použití nastavení konfigurace a čekání na dokončení konfigurace

Start-DscConfiguration -Path "C:\DSC\Configurations\" -Wait -Verbose

Tento příkaz použije konfiguraci z C:\DSC\Configurations\ na místní počítač. Příkaz vrátí Úlohy objekty pro každý cílový uzel nasazený v tomto případě pouze v místním počítači. Tento příklad určuje parametr Podrobné. Proto příkaz odesílá zprávy do konzoly, jakmile bude pokračovat. Příkaz obsahuje parametr Wait. Proto nelze konzolu použít, dokud příkaz nedokončí všechny úlohy konfigurace.

Příklad 3: Použití nastavení konfigurace pomocí relace CIM

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

Tento příklad použije nastavení konfigurace na zadaný počítač. 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 NewCimSession.

Druhý příkaz použije nastavení konfigurace z C:\DSC\Configurations na počítače 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 konfiguraci. Příkaz vytvoří Úlohy objekty pro každý nakonfigurovaný počítač.

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 konfiguračními dokumenty v parametru Path 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

Zastaví operaci konfigurace, která je aktuálně spuštěná v cílovém počítači, a zahájí novou operaci Start-Configuration. Pokud je vlastnost RefreshMode local Configuration Manageru nastavená na pull, zadáním tohoto parametru ho změníte na Push.

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

-JobName

Určuje popisný název úlohy. Pokud zadáte tento parametr, rutina se spustí jako úloha a vrátí Job objekt.

Windows PowerShell ve výchozím nastavení přiřadí název JobN, kde N je celé číslo.

Pokud zadáte parametr Wait, nezadávejte tento parametr.

Typ:String
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. Tato rutina publikuje a použije tato nastavení konfigurace 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>.mof.

Typ:String
Position:0
Default value:None
Vyžadováno:False
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

-UseExisting

Označuje, že tato rutina použije existující konfiguraci. Konfigurace může existovat v cílovém počítači provedením Start-DscConfiguration nebo publikováním pomocí rutiny Publish-DscConfiguration.

Před zadáním tohoto parametru pro tuto rutinu zkontrolujte informace v Co je nového v prostředí Windows PowerShell 5.0.

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

-Wait

Označuje, že rutina blokuje konzolu, dokud nedokončí všechny úlohy konfigurace.

Pokud zadáte tento parametr, nezadávejte parametr JobName.

Typ:SwitchParameter
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