Stop-Job

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

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

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

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

Stop-Job [-State {<NotStarted> | <Running> | <Completed> | <Failed> | <Stopped> | <Blocked>}] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>$s = new-pssession -computername Server01 -credential domain01\admin02

C:\PS> $j = invoke-command -session $s -scriptblock {start-job -scriptblock {get-eventlog system}} 

C:\PS> invoke-command -session $s -scriptblock {param($j) stop-job -job $j} -ArgumentList $j

Descrição
-----------
Esse exemplo mostra como usar o cmdlet Stop-Job para interromper um trabalho que está sendo executado em um computador remoto. 

Como o trabalho foi iniciado com o uso de Invoke-Command para executar um comando Start-Job remotamente, o objeto de trabalho é armazenado no computador remoto e você deve usar outro comando Invoke-Command para executar um comando Stop-Job remotamente. Para obter mais informações sobre trabalhos em segundo plano remotos, consulte about_Remote_Jobs.

O primeiro comando cria uma sessão do Windows PowerShell (PSSession) no computador Server01 e salva o objeto de sessão na variável $s. O comando usa as credenciais de um administrador de domínio. 

O segundo comando usa o cmdlet Invoke-Command para executar um comando Start-Job na sessão. O comando no trabalho obtém todos os eventos no log de eventos do sistema. O objeto de trabalho resultante é armazenado na variável $j. 

O terceiro comando interrompe o trabalho. Ele usa o cmdlet Invoke-Command para executar um comando Stop-Job na PSSession em Server01. Como os objetos de trabalho são armazenados em $j, que é uma variável no computador local, o comando usa a palavra-chave "param" para declarar as variáveis locais no comando e o parâmetro ArgumentList para fornecer valores para as variáveis. 

Quando o comando é concluído, o trabalho é interrompido e a PSSession em $s fica disponível para utilização.

C:\PS>stop-job -state failed

Descrição
-----------
Esse comando interrompe todos os trabalhos com um valor de estado igual a "Failed".

C:\PS>stop-job -name job1

Descrição
-----------
Esse comando interrompe o trabalho em segundo plano Job1.

C:\PS>stop-job -id 1, 3, 4

Descrição
-----------
Esse comando interrompe três trabalhos. Ele os identifica por suas IDs.

C:\PS>get-job | stop-job

Descrição
-----------
Esse comando interrompe todos os trabalhos em segundo plano na sessão atual.

C:\PS>stop-job -state blocked

Descrição
-----------
Esse comando interrompe todos os trabalhos com um status de trabalho igual a "Blocked".

C:\PS>get-job | format-table ID, Name, Command, @{Label="State";Expression={$_.jobstateinfo.state}}, I
nstanceID -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

C:\PS> stop-job -instanceid e3bbfed1-9c53-401a-a2c3-a8db34336adf

Descrição
-----------
Esses comandos mostram como interromper um trabalho com base em suas IDs de instância. 

O primeiro comando usa o comando Get-Job para obter os trabalhos na sessão atual. O comando usa um operador de pipeline (|) para enviar os trabalhos para um comando Format-Table, que exibe uma tabela de propriedades especificadas de cada trabalho. A tabela inclui a ID de instância de cada trabalho. Ela usa uma propriedade calculada para exibir o estado do trabalho.

O segundo comando usa um comando Stop-Job com o parâmetro InstanceID para interromper um trabalho selecionado.

C:\PS>$j = invoke-command -computername Server01 -scriptblock {get-eventlog system} -asjob

C:\PS> $j | stop-job -passthru

Id    Name    State      HasMoreData     Location         Command
--    ----    ----      -----------     --------          -------
5     Job5    Stopped    True            judithh-tablet   get-eventlog system

Descrição
-----------
Esse exemplo mostra como usar o cmdlet Stop-Job para interromper um trabalho que está sendo executado em um computador remoto. 

Como o trabalho foi iniciado com o uso do parâmetro AsJob de Invoke-Command, o objeto de trabalho está localizado no computador local, mesmo que o trabalho seja executado no computador remoto. Dessa forma, você pode usar um comando Stop-Job local para interromper o trabalho.

O primeiro comando usa o cmdlet Invoke-Command para iniciar um trabalho em segundo plano no computador Server01. O comando usa o parâmetro AsJob para executar o comando remoto como um trabalho em segundo plano. 

Esse comando retorna um objeto de trabalho, que é o mesmo que Start-Job retorna. O comando salva o objeto de trabalho na variável $j.

O segundo comando usa um operador de pipeline (|) para enviar o trabalho na variável $j para Stop-Job. O comando usa o parâmetro PassThru para direcionar Stop-Job para retornar um objeto de trabalho. A exibição do objeto de trabalho confirma que o estado do trabalho é "Stopped".

Para obter mais informações sobre trabalhos em segundo plano remotos, consulte about_Remote_Jobs.