Suspend-Job
Stoppar tillfälligt arbetsflödesjobb.
Syntax
Suspend-Job
[-Force]
[-Wait]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Job
[-Job] <Job[]>
[-Force]
[-Wait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Job
[-Force]
[-Wait]
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Job
[-Force]
[-Wait]
[-InstanceId] <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Job
[-Force]
[-Wait]
[-Filter] <Hashtable>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Job
[-Force]
[-Wait]
[-State] <JobState>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdleten Suspend-Job
pausar arbetsflödesjobb. Pausa innebär att tillfälligt avbryta eller pausa ett arbetsflödesjobb. Med den här cmdleten kan användare som kör arbetsflöden pausa arbetsflödet. Den kompletterar aktiviteten Suspend-Workflowhttps://go.microsoft.com/fwlink/?LinkId=267141 , som är ett kommando i arbetsflödet som pausar arbetsflödet.
Cmdleten Suspend-Job
fungerar bara på arbetsflödesjobb. Det fungerar inte på standardbakgrundsjobb, till exempel de som startas med hjälp av cmdleten Start-Job
.
Om du vill identifiera ett arbetsflödesjobb letar du efter värdet PSWorkflowJob i psJobTypeName-egenskapen för jobbet. Information om huruvida en viss anpassad jobbtyp stöder cmdleten Suspend-Job
finns i hjälpavsnitten för den anpassade jobbtypen.
När du inaktiverar ett arbetsflödesjobb körs arbetsflödesjobbet till nästa kontrollpunkt, pausar och returnerar omedelbart ett arbetsflödesjobbobjekt. Om du vill vänta tills avstängningen har slutförts innan jobbet hämtas använder du parametern Suspend-Job
Wait i eller cmdletenWait-Job
. När arbetsflödesjobbet pausas pausas värdet för jobbets tillståndsegenskap .
Att pausa korrekt förlitar sig på kontrollpunkter. Det aktuella jobbtillståndet, metadata och utdata sparas i kontrollpunkten så att arbetsflödesjobbet kan återupptas utan förlust av tillstånd eller data. Om arbetsflödesjobbet inte har kontrollpunkter kan det inte pausas korrekt. Om du vill lägga till kontrollpunkter i ett arbetsflöde som du kör använder du den vanliga parametern PSPersist-arbetsflöde . Du kan använda force-parametern för att inaktivera alla arbetsflödesjobb omedelbart och pausa ett arbetsflödesjobb som inte har kontrollpunkter, men åtgärden kan orsaka förlust av tillstånd och data.
Innan du använder en jobb-cmdlet på en anpassad jobbtyp, till exempel ett arbetsflödesjobb (PSWorkflowJob) importerar du modulen som stöder den anpassade jobbtypen, antingen med hjälp av cmdleten Import-Module
eller med hjälp av en cmdlet i modulen.
Den här cmdleten introducerades i Windows PowerShell 3.0.
Exempel
Exempel 1: Inaktivera ett arbetsflödesjobb efter namn
Det här exemplet visar hur du pausar ett arbetsflödesjobb.
Det första kommandot skapar arbetsflödet Get-SystemLog
. Arbetsflödet använder CheckPoint-Workflow
aktiviteten för att definiera en kontrollpunkt i arbetsflödet.
Det andra kommandot använder parametern AsJob som är gemensam för alla arbetsflöden för att köra Get-SystemLog
arbetsflödet som ett bakgrundsjobb. Kommandot använder den vanliga parametern JobName-arbetsflöde för att ange ett eget namn för arbetsflödesjobbet.
Det tredje kommandot använder cmdleten Get-Job
för att hämta arbetsflödesjobbet Get-SystemLogJob
. Utdata visar att värdet för egenskapen PSJobTypeName är PSWorkflowJob.
Det fjärde kommandot använder cmdleten Suspend-Job
för att pausa Get-SystemLogJob
jobbet. Jobbet körs till kontrollpunkten och pausas sedan.
#Sample WorkflowWorkflow Get-SystemLog
{
$Events = Get-WinEvent -LogName System
CheckPoint-Workflow
InlineScript {\\Server01\Scripts\Analyze-SystemEvents.ps1 -Events $Events}
}
PS C:\> Get-SystemLog -AsJob -JobName "Get-SystemLogJob"
PS C:\> Get-Job -Name Get-SystemLogJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
4 Get-SystemLogJob PSWorkflowJob Running True localhost Get-SystemLog
PS C:\> Suspend-Job -Name Get-SystemLogJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
4 Get-SystemLogJob PSWorkflowJob Suspended True localhost Get-SystemLog
Exempel 2: Pausa och återuppta ett arbetsflödesjobb
Det här exemplet visar hur du pausar och återupptar ett arbetsflödesjobb.
Det första kommandot pausar LogWorkflowJob-jobbet. Kommandot returnerar omedelbart. Utdata visar att arbetsflödesjobbet fortfarande körs, även om det pausas.
Det andra kommandot använder cmdleten Get-Job
för att hämta LogWorkflowJob-jobbet. Utdata visar att arbetsflödesjobbet har pausats.
Det tredje kommandot använder cmdleten Get-Job
för att hämta LogWorkflowJob-jobbet och cmdleten Resume-Job
för att återuppta det. Utdata visar att arbetsflödesjobbet har återupptagits och körs nu.
PS C:\> Suspend-Job -Name LogWorkflowJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
67 LogflowJob PSWorkflowJob Running True localhost LogWorkflow
PS C:\> Get-Job -Name LogWorkflowJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
67 LogflowJob PSWorkflowJob Suspended True localhost LogWorkflow
PS C:\> Get-Job -Name LogWorkflowJob | Resume-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
67 LogflowJob PSWorkflowJob Running True localhost LogWorkflow
Exempel 3: Pausa ett arbetsflödesjobb på en fjärrdator
PS C:\> Invoke-Command -ComputerName Srv01 -Scriptblock {Suspend-Job -Filter @{CustomID="031589"}
Det här kommandot använder cmdleten Invoke-Command
för att pausa ett arbetsflödesjobb på fjärrdatorn Srv01. Värdet för filterparametern är en hash-tabell som anger ett CustomID-värde.
Detta CustomID är jobbmetadata (PSPrivateMetadata).
Exempel 4: Vänta tills arbetsflödesjobbet pausas
PS C:\> Suspend-Job VersionCheck -Wait
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
5 VersionCheck PSWorkflowJob Suspended True localhost LogWorkflow
Det här kommandot inaktiverar arbetsflödesjobbet VersionCheck. Kommandot använder parametern Wait för att vänta tills arbetsflödesjobbet har pausats. När arbetsflödesjobbet körs till nästa kontrollpunkt och pausas slutförs kommandot och returnerar jobbobjektet.
Exempel 5: Tvinga ett arbetsflödesjobb att pausa
PS C:\> Suspend-Job Maintenance -Force
Det här kommandot inaktiverar arbetsflödesjobbet underhåll med två två skäl. Underhållsjobbet har inga kontrollpunkter. Den kan inte pausas korrekt och kan inte återupptas korrekt.
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Anger en hash-tabell med villkor. Den här cmdleten pausar jobb som uppfyller alla villkor. Ange en hash-tabell där nycklarna är jobbegenskaper och värdena är jobbegenskapsvärden.
Type: | Hashtable |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Inaktiverar arbetsflödesjobbet omedelbart. Den här åtgärden kan orsaka förlust av tillstånd och data.
Som standard Suspend-Job
kan arbetsflödesjobbet köras till nästa kontrollpunkt och sedan pausa det.
Du kan också använda den här parametern för att pausa arbetsflödesjobb som inte har kontrollpunkter.
Type: | SwitchParameter |
Aliases: | F |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Anger ID:t för jobb som den här cmdleten pausar.
ID:t är ett heltal som unikt identifierar jobbet i den aktuella sessionen. Det är lättare att komma ihåg och skriva än instans-ID, men det är bara unikt i den aktuella sessionen. Du kan skriva ett eller flera ID:er, avgränsade med kommatecken. Om du vill hitta ID:t för ett jobb använder du cmdleten Get-Job
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Anger instans-ID:t för jobb som den här cmdleten pausar. Standardvärdet är alla jobb.
Ett instans-ID är ett GUID som unikt identifierar jobbet på datorn. Om du vill hitta instans-ID:t för ett jobb använder du Get-Job
.
Type: | Guid[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Job
Anger de arbetsflödesjobb som den här cmdleten stoppar. Ange en variabel som innehåller arbetsflödesjobben eller ett kommando som hämtar arbetsflödesjobben. Du kan också skicka arbetsflödesjobb till cmdleten Suspend-Job
.
Type: | Job[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Anger egna namn på jobb som den här cmdleten pausar. Ange ett eller flera arbetsflödesjobbnamn. Jokertecken stöds.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-State
Anger ett jobbtillstånd. Den här cmdleten stoppar endast jobb i det angivna tillståndet. De acceptabla värdena för den här parametern är:
- NotStarted
- Körs
- Slutförd
- Misslyckad
- Stoppat
- Spärrad
- Inaktiverad
- Frånkopplad
- Avbryter
- Stoppas
Suspend-Job
inaktiverar endast arbetsflödesjobb i tillståndet Körs .
Mer information om jobbtillstånd finns i JobState-uppräkning.
Type: | JobState |
Accepted values: | NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Wait
Anger att den här cmdleten undertrycker kommandotolken tills arbetsflödesjobbet är i pausat tillstånd. Som standard Suspend-Job
returneras omedelbart, även om arbetsflödesjobbet ännu inte är i pausat tillstånd.
Parametern Wait motsvarar att skicka ett Suspend-Job
kommando till cmdleten Wait-Job
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka alla typer av jobb till den här cmdleten. Men om Suspend-Job
hämtar ett jobb av en typ som inte stöds returneras ett avslutande fel.
Utdata
Den här cmdleten returnerar jobben som den pausade.
Kommentarer
Windows PowerShell innehåller följande alias för Suspend-Job
:
sujb
Mekanismen och platsen för att spara ett pausat jobb kan variera beroende på jobbtyp. Till exempel sparas pausade arbetsflödesjobb i ett platt filarkiv som standard, men kan också sparas i en databas.
Om du skickar ett arbetsflödesjobb som inte är i tillståndet Suspend-Job
Körs visas ett varningsmeddelande. Om du vill ignorera varningen använder du den vanliga parametern WarningAction med värdet SilentlyContinue.
Om ett jobb inte är av en typ som stöder pausning returnerar Suspend-Job
ett avslutande fel.
Om du vill hitta de arbetsflödesjobb som är pausade, inklusive de som har pausats av den här cmdleten, använder du parametern Tillstånd för cmdleten Get-Job
för att hämta arbetsflödesjobb i tillståndet Pausat.
Vissa jobbtyper har alternativ eller egenskaper som hindrar Windows PowerShell från att pausa jobbet. Om det inte går att pausa jobbet kontrollerar du att jobbalternativen och egenskaperna tillåter pausning.
Relaterade länkar
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för