Stop-Job

Syntaxe

Stop-Job
    [-PassThru]
    [-Id] <Int32[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-Job] <Job[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-PassThru]
    [-Name] <String[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-PassThru]
    [-InstanceId] <Guid[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-PassThru]
    [-State] <JobState>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Stop-Job
    [-PassThru]
    [-Filter] <Hashtable>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina Stop-Job zastaví probíhající úlohy PowerShellu na pozadí. Pomocí této rutiny můžete zastavit všechny úlohy nebo zastavit vybrané úlohy na základě jejich názvu, ID, ID instance nebo stavu nebo předáním objektu úlohy .Stop-Job

Úlohy na pozadí můžete Stop-Job zastavit, například úlohy, které byly spuštěny pomocí Start-Job rutiny nebo parametru AsJob jakékoli rutiny. Když zastavíte úlohu na pozadí, PowerShell dokončí všechny úkoly čekající ve frontě úlohy a pak úlohu ukončí. Po odeslání tohoto příkazu se do fronty nepřidají žádné nové úkoly.

Tato rutina neodstraní úlohy na pozadí. Pokud chcete odstranit úlohu, použijte rutinu Remove-Job .

Počínaje windows PowerShellem 3.0 Stop-Job také zastavíte vlastní typy úloh, jako jsou WorkflowJobs a instance ScheduledJobs. Pokud chcete povolit Stop-Job zastavení úlohy s vlastním typem úlohy, naimportujte modul, který podporuje vlastní typ úlohy, před spuštěním Stop-Job příkazu, buď pomocí rutiny Import-Module , nebo pomocí rutiny nebo získáním rutiny v modulu. Informace o konkrétním vlastním typu úlohy najdete v dokumentaci funkce vlastního typu úlohy.

Příklady

Příklad 1: Zastavení úlohy ve vzdáleném počítači pomocí příkazu Invoke-Command

$s = New-PSSession -ComputerName Server01 -Credential Domain01\Admin02
$j = Invoke-Command -Session $s -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Invoke-Command -Session $s -ScriptBlock { Stop-job -Job $Using:j }

Tento příklad ukazuje, jak pomocí rutiny Stop-Job zastavit úlohu spuštěnou na vzdáleném počítači.

Vzhledem k tomu, že úloha byla spuštěna s Invoke-Command rutinou ke vzdálenému Start-Job spuštění příkazu, je objekt úlohy uložen ve vzdáleném počítači. K vzdálenému Stop-Job spuštění příkazu musíte použít jiný Invoke-Command příkaz. Další informace o vzdálených úlohách na pozadí najdete v tématu about_Remote_Jobs.

První příkaz vytvoří relaci PowerShellu (PSSession) na počítači Server01 a pak uloží objekt relace do $s proměnné. Příkaz používá přihlašovací údaje správce domény.

Druhý příkaz používá rutinu Invoke-Command Start-Job ke spuštění příkazu v relaci. Příkaz v úloze získá všechny události v protokolu událostí systému. Výsledný objekt úlohy je uložen v $j proměnné.

Třetí příkaz zastaví úlohu. Používá rutinu Invoke-Command Stop-Job ke spuštění příkazu v PSSession na Serveru01. Vzhledem k tomu, že objekty úloh jsou uloženy v $j, což je proměnná v místním počítači, příkaz používá modifikátor Using oboru k identifikaci $j jako místní proměnnou. Další informace o modifikátoru oboru najdete v tématu about_Remote_Variables.

Po dokončení příkazu se úloha zastaví a příkaz PSSession je $s k dispozici pro použití.

Příklad 2: Zastavení úlohy na pozadí

Stop-Job -Name "Job1"

Tento příkaz zastaví Job1 úlohu na pozadí.

Příklad 3: Zastavení několika úloh na pozadí

Stop-Job -Id 1, 3, 4

Tento příkaz zastaví tři úlohy. Identifikuje je podle jejich ID.

Příklad 4: Zastavení všech úloh na pozadí

Get-Job | Stop-Job

Tento příkaz zastaví všechny úlohy na pozadí v aktuální relaci.

Příklad 5: Zastavení všech blokovaných úloh na pozadí

Stop-Job -State Blocked

Tento příkaz zastaví všechny blokované úlohy.

Příklad 6: Zastavení úlohy podle ID instance

Get-Job | Format-Table ID, Name, Command, @{Label="State";Expression={$_.JobStateInfo.State}},
InstanceID -Auto

Id Name Command                 State  InstanceId
-- ---- -------                 -----  ----------
1 Job1 start-service schedule Running 05abb67a-2932-4bd5-b331-c0254b8d9146
3 Job3 start-service schedule Running c03cbd45-19f3-4558-ba94-ebe41b68ad03
5 Job5 get-service s*         Blocked e3bbfed1-9c53-401a-a2c3-a8db34336adf

Stop-Job -InstanceId e3bbfed1-9c53-401a-a2c3-a8db34336adf

Tyto příkazy ukazují, jak zastavit úlohu na základě id instance.

První příkaz pomocí rutiny Get-Job získá úlohy v aktuální relaci. Příkaz používá operátor kanálu (|) k odeslání úloh do Format-Table příkazu, který zobrazí tabulku zadaných vlastností každé úlohy. Tabulka obsahuje ID instance každé úlohy. Používá počítanou vlastnost k zobrazení stavu úlohy.

Druhý příkaz používá Stop-Job příkaz, který má parametr InstanceID k zastavení vybrané úlohy.

Příklad 7: Zastavení úlohy ve vzdáleném počítači

$j = Invoke-Command -ComputerName Server01 -ScriptBlock {Get-EventLog -LogName System} -AsJob
$j | Stop-Job -PassThru

Id    Name    State      HasMoreData     Location         Command
--    ----    ----       -----------     --------         -------
5     Job5    Stopped    True            user01-tablet    Get-EventLog -LogName Sy...

Tento příklad ukazuje, jak pomocí rutiny Stop-Job zastavit úlohu spuštěnou na vzdáleném počítači.

Vzhledem k tomu, že úloha byla spuštěna s parametrem Invoke-Command AsJob rutiny, objekt Job se nachází v místním počítači, i když úloha běží na vzdáleném počítači. Proto můžete k zastavení úlohy použít místní Stop-Job příkaz.

První příkaz pomocí rutiny Invoke-Command spustí úlohu na pozadí na počítači se serverem Server01. Příkaz používá parametr AsJob ke spuštění vzdáleného příkazu jako úlohu na pozadí.

Tento příkaz vrátí objekt úlohy, což je stejný objekt úlohy, který vrací rutina Start-Job . Příkaz uloží objekt úlohy do $j proměnné.

Druhý příkaz používá operátor kanálu k odeslání úlohy v $j proměnné do Stop-Job. Příkaz pomocí parametru PassThru nasměruje Stop-Job na vrácení objektu úlohy. Zobrazení objektu úlohy potvrzuje, že stav úlohy je Zastaveno.

Další informace o vzdálených úlohách na pozadí najdete v tématu about_Remote_Jobs.

Parametry

-Confirm

-Filter

-Id

-InstanceId

-Job

-Name

-PassThru

-State

-WhatIf

Vstupy

System.Management.Automation.RemotingJob

Objekt úlohy můžete do této rutiny převést.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

System.Management.Automation.PSRemotingJob

Pokud použijete parametr PassThru , vrátí tato rutina objekt úlohy.

Poznámky

PowerShell obsahuje následující aliasy pro Stop-Job:

• Všechny platformy:
  • spjb

Související odkazy

• Get-Job
• Invoke-Command
• Receive-Job
• Remove-Job
• Start-Job
• Wait-Job
• about_Job_Details
• about_Remote_Jobs
• about_Remote_Variables
• about_Jobs
• about_Scopes