PowerShell Logo Small

Remove-VMSnapshot



This is the built-in help made by Microsoft for the command 'Remove-VMSnapshot', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Deletes a virtual machine checkpoint.

SYNTAX


Remove-VMSnapshot [-VMName] <String[]> [[-Name] <String[]>] [-AsJob] [-ComputerName <String[]>] [-IncludeAllChildSnapshots] [-Passthru] [-Confirm] [-WhatIf]
[<CommonParameters>]
Remove-VMSnapshot [-VM] <VirtualMachine[]> [[-Name] <String[]>] [-AsJob] [-IncludeAllChildSnapshots] [-Passthru] [-Confirm] [-WhatIf] [<CommonParameters>]
Remove-VMSnapshot [-VMSnapshot] <VMSnapshot[]> [-AsJob] [-IncludeAllChildSnapshots] [-Passthru] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Remove-VMSnapshot deletes a virtual machine checkpoint.


Note: In Windows Server 2012 R2, virtual machine snapshots were renamed to virtual machine checkpoints. For clarity, this document will refer to virtual machine snapshots as
checkpoints.



<

RELATED LINKS


Online Version: http://go.microsoft.com/fwlink/?LinkID=306916

REMARKS

<

Examples


Example 1

PS C:\>Get-VM TestVM | Remove-VMSnapshot –Name Experiment*



Deletes all checkpoints of virtual machine TestVM whose names starts with Experiment.




Example 2

PS C:\>Get-VMSnapshot -VMName TestVM | Where-Object {$_.CreationTime -lt (Get-Date).AddDays(-90) } | Remove-VMSnapshot



Deletes all checkpoints of virtual machine TestVM older than 90 days.