PowerShell Genie

Find Hyper-V checkpoints

Script 2 min read Windows PowerShell 5.1 and PowerShell 7

Documentation: Microsoft Learn

Get-VM feeds each guest into Get-VMSnapshot, which returns the checkpoints belonging to that machine.

The script

1PS> Get-VM | Get-VMSnapshot | Select-Object VMName,Name,CreationTime

Script reader

Inspect before you run

Inspection only

Inspect the script below. It does not run in this browser.

Inspection only — no command has run.

    Show reference output
    1 VMName Name CreationTime
    2 ------ ---- ------------
    3 VM-WEB01 BeforePatch 9/01/2026 8:30:00 PM
    Inspect this example’s structure

    Read the command and its supplied arguments. This example requires real PowerShell or its module; this diagram does not execute it.

    Get-VM | Get-VMSnapshot | Select-Object VMName,Name,CreationTime
    1. Stage 1Get-VMPositional values or no named parameters
    2. Stage 2Get-VMSnapshotPositional values or no named parameters
    3. Stage 3Select-ObjectPositional values or no named parameters

      How it works

      Get-VM feeds each guest into Get-VMSnapshot, which returns the checkpoints belonging to that machine. The projection pairs VMName with the checkpoint name and CreationTime so age is visible per guest.

      Adapting it

      Filter CreationTime against a cutoff to reduce this to genuinely old checkpoints, and sort ascending so the oldest offender sits at the top rather than buried in the middle.

      Requirements

      Hyper-V PowerShell module and Hyper-V Administrators membership.

      If the result is unexpected

      A checkpoint report has unexpected ages or omits a VM.

      The selected host, VM scope and checkpoint type determine the returned set.

      1. Inspect checkpoints for one known VM and compare creation times and identifiers.

      Validate the result

      Each row identifies the host, VM and checkpoint rather than only a display name.

      Keep the check reliable

      Review checkpoint age with the workload owner before removal.

      Primary documentation

      Windows services and processes documentation

      Continue
      Genie guideFind Hyper-V checkpoints

      Get-VM feeds each guest into Get-VMSnapshot, which returns the checkpoints belonging to that machine.