Start-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Použije konfiguraci na uzly.

Syntax

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 použije konfiguraci na uzly. Při použití s parametrem UseExisting se použije existují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í potřebujete zadáním Get-Help about_Jobs. Pokud chcete tuto rutinu používat interaktivně, zadejte parametr Wait .

Zadáním podrobného parametru 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 na C:\DSC\Configurations\ každý počítač, který má nastavení v této složce. Příkaz vrátí objekty úlohy pro každý cílový uzel nasazený do.

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í objekty Úlohy pro každý cílový uzel nasazený v tomto případě pouze do místního počítače. Tento příklad určuje parametr Verbose . Proto příkaz odesílá zprávy do konzoly, jak pokračuje. 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é 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 NewCimSession.

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

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

Zastaví operaci konfigurace, která je aktuálně spuštěna na cílovém počítači, a zahájí novou operaci Start-Configuration. Pokud je vlastnost RefreshMode místního Configuration Manager nastavená na Vyžádat, zadáním tohoto parametru se změní na Push.

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

-JobName

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

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

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

Type:String
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. Tato rutina publikuje a aplikuje tato nastavení konfigurace 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>.mof.

Type:String
Position:0
Default value:None
Required:False
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

-UseExisting

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

Před zadáním tohoto parametru pro tuto rutinu si projděte informace v tématu Co je nového v Windows PowerShell 5.0.

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

-Wait

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

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

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