Stop-DscConfiguration
Zastaví úlohu konfigurace, která je spuštěná.
Syntaxe
All
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Stop-DscConfiguration zastaví úlohu konfigurace, která je spuštěná. Určete počítače, na které se tato rutina vztahuje, pomocí relací MODELU CIM (Common Information Model). Pokud není spuštěná žádná úloha konfigurace, vrátí tato rutina zprávu s upozorněním.
Stop-DscConfiguration je k dispozici pouze v rámci kumulativní aktualizace z listopadu 2014 pro Windows RT 8.1, Windows 8.1 a Windows Server 2012 R2 z knihovny podpory Microsoftu. Než použijete tuto rutinu, projděte si informace v Co je nového ve Windows PowerShellu 5.0
Příklady
Příklad 1: Zastavení úlohy konfigurace
V tomto příkladu se vytvoří relace CIM pomocí rutiny New-CimSession. Objekt CimSession slouží k zastavení spuštěné úlohy konfigurace.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession k určení počítače Server01 používá parametr ComputerName. Parametr přihlašovacích údajů $Session. Po spuštění příkazu se zobrazí výzva k zadání hesla uživatelského účtu.
Stop-DscConfiguration k zastavení úlohy konfigurace používá parametr CimSession a objekt uložený v $Session.
Parametry
-AsJob
Označuje, že tato rutina spouští příkaz jako úlohu na pozadí. Další informace o úlohách na pozadí PowerShellu najdete v tématu about_Jobs a about_Remote_Jobs.
Pokud chcete použít parametr AsJob, musí být místní a vzdálené počítače nakonfigurované pro vzdálenou komunikace. Ve Windows Vista a novějších verzích operačního systému Windows musíte otevřít PowerShell s možností Spustit jako správce. Další informace naleznete v tématu about_Remote_Requirements.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| 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 |
-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 z New-CimSession nebo Get-CimSession.
Vlastnosti parametru
| Typ: | |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Sezení |
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 |
-Confirm
Stop-DscConfiguration nepodporuje parametr Confirm. Pokud se použije parametr Potvrdit, zobrazí se chyba.
Pro rutiny PowerShellu, které podporují Potvrdit, pomocí parametru se zobrazí výzva k ověření před spuštěním příkazu.
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 |
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| 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 |
-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, PowerShell vypočítá optimální limit omezení 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í. Cmdlet se nespustil.
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.
