Sdílet prostřednictvím


Start-DscConfiguration

Použije konfiguraci na uzly.

Syntaxe

ComputerNameAndPathSet (Výchozí)

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

CimSessionAndPathSet

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

ComputerNameAndUseExistingSet

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

CimSessionAndUseExistingSet

Start-DscConfiguration
    -CimSession <CimSession[]>
    [-Wait]
    [-Force]
    [-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. Pro více informací zadejte 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.

Vlastnosti parametru

Typ:

CimSession[]

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

Sady parametrů

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

ComputerNameAndPathSet
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
ComputerNameAndUseExistingSet
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ů

ComputerNameAndPathSet
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
ComputerNameAndUseExistingSet
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

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.

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

-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.

Vlastnosti parametru

Typ:String
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. 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.

Vlastnosti parametru

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

Sady parametrů

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

-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.

Vlastnosti parametru

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

Sady parametrů

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

-Wait

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

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

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

-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.