PowerShell Logo Small

Checkpoint-VM



This is the built-in help made by Microsoft for the command 'Checkpoint-VM', 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

Creates a checkpoint of a virtual machine.

SYNTAX


Checkpoint-VM [-Name] <String[]> [[-SnapshotName] <String>] [-AsJob] [-ComputerName <String[]>] [-Passthru] [<CommonParameters>]
Checkpoint-VM [-VM] <VirtualMachine[]> [[-SnapshotName] <String>] [-AsJob] [-Passthru] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Checkpoint-VM cmdlet creates a checkpoint of a virtual machine.


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=306820

REMARKS

<

Examples


Example 1

PS C:\> Checkpoint-VM -Name Test -SnapshotName BeforeInstallingUpdates



Checkpoints virtual machine Test, creating a checkpoint of it named BeforeInstallingUpdates.




Example 2

PS C:\> Get-VM Test –ComputerName Server1 | Checkpoint-VM



Checkpoints virtual machine Test on Hyper-V host Server1.