Suspend Job - PowerShell


The Suspend-Job cmdlet stops a running job and puts it into a suspended state. This can be useful if you need to temporarily stop a job from running without losing its progress. Once a job is suspended, you can resume it later using the Resume-Job cmdlet.


Suspend-Job [-JobName] <string[]> [-Confirm] [-StopAtJobEnd] [-WhatIf]


  • -JobName: Specifies the name of the job to suspend. You can specify multiple job names.
  • -Confirm: Prompts you to confirm the operation before suspending the job.
  • -StopAtJobEnd: If set to True, the current process will wait until the job finishes before it continues.
  • -WhatIf: Shows what would happen if the command were run without actually suspending the job.


Example 1: Suspend a single job

Suspend-Job -JobName "MyJob"

Example 2: Suspend multiple jobs

Suspend-Job -JobName "MyJob1", "MyJob2", "MyJob3"

Example 3: Suspend a job and wait for it to finish

Suspend-Job -JobName "MyJob" -StopAtJobEnd

Common Issues

One common issue that you may encounter when using the Suspend-Job cmdlet is that the job may not be in a state where it can be suspended. For example, if the job is already finished or has been removed, the Suspend-Job cmdlet will fail.


The Suspend-Job cmdlet can be used with other PowerShell cmdlets to create more complex scripts. For example, you could use the Suspend-Job cmdlet to temporarily stop a job that is running on a remote computer.