PowerShell Background Job Memory Leak: Uncertain Automatic Cleanup Policy

Answer

By default, PowerShell does not automatically dispose of background job objects when the job finishes. Completed jobs stay in the session’s job table and retain a reference to the underlying process until you call Remove-Job (or the PowerShell session ends). In PowerShell 7+ you can use the -Autoremove switch on Start-Job to have the job object removed automatically after it completes.

Confirmed Facts

• Background jobs run as separate PowerShell processes; the OS frees that process’ memory when it exits.
• The job object that remains in the session holds only lightweight references; it does not keep the job process alive.
• Remove-Job deletes the job object from the session; it does not trigger a garbage collection, but the associated process has already terminated.
• The -Autoremove switch is available starting with PowerShell 7.0 and causes Start-Job to automatically call Remove-Job when the job reaches a completed state.
• There is no built‑in event that signals when a job object has been fully cleaned up; you can use the JobStateChanged event to detect completion and then call Remove-Job.

Likely Explanation

The uncertainty stems from the distinction between the job process (which ends when the script block finishes) and the job object that tracks the job in the session. Documentation focuses on the process lifetime, not on when the object is removed from the job table, leading to the impression of a leak when objects accumulate.

Steps Needed for This Case

1. If you are on PowerShell 7.0 or later and want automatic cleanup, start the job with Start-Job -ScriptBlock { ... } -Autoremove.
2. If you are using Windows PowerShell 5.1 or prefer manual control, after you have retrieved the output with Receive-Job, immediately run Remove-Job .
3. Optionally, verify that the underlying process has exited by checking Get-Process -Id $job.PSBase.InstanceId before and after Remove-Job; the process should disappear.

Missing Diagnostic Detail

To confirm whether the -Autoremove switch is available for your environment, please specify your PowerShell version (e.g., $PSVersionTable.PSVersion). This determines if you can rely on automatic removal or must use manual Remove-Job.