Remove-Job

Remove-Job
    [-Id] <Int32[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Job
    [-Job] <Job[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Job
    [-Name] <String[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Job
    [-InstanceId] <Guid[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Job
    [-Filter] <Hashtable>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Job
    [-State] <JobState>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-Job
    [-Command <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Cmdleten Remove-Job tar bort PowerShell-bakgrundsjobb som startades av cmdleten Start-Job eller cmdletar som Invoke-Command som stöder parametern AsJob.

Du kan använda Remove-Job för att ta bort alla jobb eller ta bort markerade jobb. Jobben identifieras med deras Name, ID, InstanceId, Commandeller State. Eller så kan ett jobbobjekt skickas ned i pipelinen till Remove-Job. Utan parametrar eller parametervärden har Remove-Job ingen effekt.

Eftersom PowerShell 3.0 kan Remove-Job ta bort anpassade jobbtyper, till exempel schemalagda jobb och arbetsflödesjobb. Till exempel tar Remove-Job bort det schemalagda jobbet, alla instanser av det schemalagda jobbet på disken och resultatet av alla utlösta jobbinstanser.

Om du försöker ta bort ett jobb som körs misslyckas Remove-Job. Använd cmdleten Stop-Job för att stoppa ett jobb som körs. Du kan också använda Remove-Job med parametern Force för att ta bort ett jobb som körs.

Jobben finns kvar i det globala jobbcachen tills du tar bort bakgrundsjobbet eller stänger PowerShell-sessionen.

I det här exemplet används en variabel och pipelinen för att ta bort ett jobb med namn.

$batch = Get-Job -Name BatchJob
$batch | Remove-Job

Get-Job använder parametern Name för att ange jobbet BatchJob. Jobbobjektet lagras i variabeln $batch. Objektet i $batch skickas ned i pipelinen till Remove-Job.

Ett alternativ är att använda parametern Job, till exempel Remove-Job -Job $batch.

I det här exemplet tas alla jobb i den aktuella PowerShell-sessionen bort.

Get-Job | Remove-Job

Get-Job får alla jobb i den aktuella PowerShell-sessionen. Jobbobjekten skickas ned i pipeline till Remove-Job.

I det här exemplet tas alla jobb bort från den aktuella PowerShell-sessionen som inte har startats.

Remove-Job -State NotStarted

Remove-Job använder parametern State för att ange jobbstatus.

Det här exemplet tar bort alla jobb från den aktuella sessionen med vänliga namn som slutar med batch, inklusive jobb som körs.

Remove-Job -Name *batch -Force

Remove-Job använder parametern Name för att ange ett jobbnamnsmönster. Mönstret innehåller jokertecknet asterisk (*) för att hitta alla jobbnamn som slutar med batch. Parametern Force tar bort jobb som för närvarande körs.

Det här exemplet tar bort ett jobb som startades på en fjärrdator med hjälp av Invoke-Command med parametern AsJob.

Eftersom exemplet använder parametern AsJob skapas jobbobjektet på den lokala datorn. Men jobbet körs på en fjärrdator. Därför använder du lokala kommandon för att hantera jobbet.

$job = Invoke-Command -ComputerName Server01 -ScriptBlock {Get-Process} -AsJob
$job | Remove-Job

Invoke-Command kör ett jobb på datorn Server01. Parametern AsJob kör ScriptBlock- som ett bakgrundsjobb. Jobbobjektet lagras i variabeln $job. Variabelobjektet $job skickas genom pipelinen till Remove-Job.

Det här exemplet visar hur du tar bort ett jobb på en fjärrdator som startades med hjälp av Invoke-Command för att köra Start-Job. Jobbobjektet skapas på fjärrdatorn och fjärrkommandon används för att hantera jobbet. En beständig anslutning krävs när du kör ett fjärrkommando för Start-Job.

$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S -ScriptBlock {Start-Job -ScriptBlock {Get-Process} -Name MyJob}
Invoke-Command -Session $S -ScriptBlock {Remove-Job -Name MyJob}

New-PSSession skapar en PSSession, en beständig anslutning, till datorn Server01. Anslutningen sparas i variabeln $S.

Invoke-Command ansluter till sessionen som sparats i $S. ScriptBlock använder Start-Job för att starta ett fjärrjobb. Jobbet kör ett Get-Process-kommando och använder parametern Name för att ange ett jobbnamn, MyJob.

Invoke-Command använder $S-sessionen och kör Remove-Job. Parametern Name anger att jobbet med namnet MyJob tas bort.

Det här exemplet tar bort ett jobb baserat på dess InstanceId.

$job = Start-Job -ScriptBlock {Get-Process powershell}
$job | Format-List -Property *
Remove-Job -InstanceId ad02b942-8007-4407-87f3-d23e71955872

State         : Completed
HasMoreData   : True
StatusMessage :
Location      : localhost
Command       : Get-Process powershell
JobStateInfo  : Completed
Finished      : System.Threading.ManualResetEvent
InstanceId    : ad02b942-8007-4407-87f3-d23e71955872
Id            : 3
Name          : Job3
ChildJobs     : {Job4}
PSBeginTime   : 7/26/2019 11:36:56
PSEndTime     : 7/26/2019 11:36:57
PSJobTypeName : BackgroundJob
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
Information   : {}

Start-Job startar ett bakgrundsjobb och jobbobjektet sparas i variabeln $job.

Objektet i $job skickas ned i pipelinen till Format-List. Parametern Property använder en asterisk (*) för att ange att alla objektets egenskaper visas i en lista.

Remove-Job använder parametern InstanceId för att ange jobbet som ska tas bort.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka ett Job-objekt till den här cmdleten.

Den här cmdleten returnerar inga utdata.

PowerShell innehåller följande alias för Remove-Job:

• Alla plattformar:
  • rjb

Ett PowerShell-jobb skapar en ny process. När jobbet är klart avslutas processen. När Remove-Job körs, tas jobbtillståndet bort.

Om ett jobb stoppas före slutförandet och dess process inte har avslutats, tvingas processen avslutas.