Get-VMSnapshot

Get-VMSnapshot

Gets the checkpoints associated with a virtual machine or checkpoint.

Sintaxis

Parameter Set: Child
Get-VMSnapshot [[-Name] <String> ] -ChildOf <VMSnapshot> [-SnapshotType <SnapshotType> {Standard | Recovery | Planned | Missing | Replica | AppConsistentReplica | SyncedReplica} ] [ <CommonParameters>]

Parameter Set: Id
Get-VMSnapshot [-Id] <Guid]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [ <CommonParameters>]

Parameter Set: Parent
Get-VMSnapshot [[-Name] <String> ] -ParentOf <VirtualMachineBase> [-SnapshotType <SnapshotType> {Standard | Recovery | Planned | Missing | Replica | AppConsistentReplica | SyncedReplica} ] [ <CommonParameters>]

Parameter Set: VMName
Get-VMSnapshot [-VMName] <String[]> [[-Name] <String> ] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-SnapshotType <SnapshotType> {Standard | Recovery | Planned | Missing | Replica | AppConsistentReplica | SyncedReplica} ] [ <CommonParameters>]

Parameter Set: VMObject
Get-VMSnapshot [-VM] <VirtualMachine[]> [[-Name] <String> ] [-SnapshotType <SnapshotType> {Standard | Recovery | Planned | Missing | Replica | AppConsistentReplica | SyncedReplica} ] [ <CommonParameters>]

Descripción detallada

The Get-VMSnapshot cmdlet gets the checkpoints associated with a virtual machine or 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.

Parámetros

-ChildOf<VMSnapshot>

Specifies the checkpoint whose child checkpoints are to be retrieved. This retrieves immediate children only.

Alias	none
¿Necesario?	true
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which checkpoints are to be retrieved. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

Alias	none
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Id<Guid]>

Specifies the unique identifier of the virtual machine whose checkpoints are to be retrieved.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	True (ByValue, ByPropertyName)
¿Aceptar caracteres comodín?	false

-Name<String>

Specifies the name of the checkpoint to be retrieved.

Alias	none
¿Necesario?	false
¿Posición?	2
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-ParentOf<VirtualMachineBase>

Specifies the checkpoint whose immediate parent checkpoint is to be retrieved.

Alias	none
¿Necesario?	true
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-SnapshotType<SnapshotType>

Specifies the type of the checkpoints to be retrieved. Allowed values are Standard, Recovery, Planned, Missing, Replica, AppConsistentReplica, and SyncedReplica.

Alias	VMRecoveryCheckpoint
¿Necesario?	false
¿Posición?	named
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-VM<VirtualMachine[]>

Specifies the virtual machine whose checkpoints are to be retrieved.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	True (ByValue)
¿Aceptar caracteres comodín?	false

-VMName<String[]>

Specifies the name of the virtual machine whose checkpoints are to be retrieved.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	True (ByValue)
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

• Microsoft.HyperV.PowerShell.Snapshot

Ejemplos

Example 1

Gets all checkpoints of virtual machine TestVM.

PS C:\> Get-VMSnapshot –VMName TestVM

Example 2

Gets all standard checkpoints of virtual machine TestVM.

PS C:\> Get-VM –Name TestVM | Get-VMSnapshot –SnapshotType Standard

Example 3

Gets the immediate parent of checkpoint Before applying updates of virtual machine TestVM.

PS C:\> $snapshot = Get-VMSnapshot –Name 'Before applying updates' –VMName TestVM

PS C:\> Get-VMSnapshot –ParentOf $snapshot

Example 4

Gets the immediate child checkpoints of checkpoint Before applying updates of virtual machine TestVM.

PS C:\> $snapshot = Get-VMSnapshot –Name 'Before applying updates' –VMName TestVM

PS C:\> Get-VMSnapshot –ChildOf $snapshot