Sdílet prostřednictvím

Stop-DscConfiguration

  • Reference
Modul:
PSDesiredStateConfiguration

Zastaví spuštěnou úlohu konfigurace.

Syntax

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Stop-DscConfiguration zastaví spuštěnou úlohu konfigurace. Pomocí relací MODELU CIM (Common Information Model) určete, na které počítače se tato rutina vztahuje. Pokud není spuštěná žádná úloha konfigurace, vrátí tato rutina zprávu upozornění.

Stop-DscConfigurationje k dispozici pouze jako součást kumulativní aktualizace z listopadu 2014 pro Windows RT 8.1, Windows 8.1 a Windows Server 2012 R2 z knihovny podpora Microsoftu. Před použitím této rutiny si projděte informace v tématu Co je nového v Windows PowerShell 5.0.

Příklady

Příklad 1: Zastavení úlohy konfigurace

V tomto příkladu se relace CIM vytvoří pomocí rutiny .New-CimSession Objekt CimSession se používá k zastavení spuštěné úlohy konfigurace.

$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session

New-CimSession používá parametr ComputerName k určení počítače Server01. Parametr Credential určuje uživatelský účet. Objekt CimSession je uložen v $Session proměnné . Po spuštění příkazu se zobrazí výzva k zadání hesla uživatelského účtu.

Stop-DscConfiguration pomocí parametru CimSession a objektu uloženého v $Session nástroji zastaví úlohu konfigurace.

Parametry

-AsJob

Označuje, že tato rutina spustí příkaz jako úlohu na pozadí. Další informace o úlohách PowerShellu na pozadí 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. V systému Windows Vista a novějších verzích operačního systému Windows musíte otevřít PowerShell pomocí možnosti Spustit jako správce . Další informace najdete v tématu about_Remote_Requirements.

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

-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 z New-CimSession nebo Get-CimSession.

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

-Confirm

Stop-DscConfiguration nepodporuje parametr Confirm . Pokud se použije parametr Confirm , zobrazí se chyba.

V případě rutin PowerShellu, které podporují příkaz Confirm, vás použití parametru vyzve k ověření před spuštěním příkazu.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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:False
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 , 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, 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 se nespustí.

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

Vstupy

None

Výstupy

None