Share via


Get-VHDSnapshot

Get-VHDSnapshot

Gets information about a checkpoint in a VHD set.

Syntaxe

Parameter Set: Default
Get-VHDSnapshot [-Path] <String[]> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-GetParentPaths] [-SnapshotId <Guid[]> ] [ <CommonParameters>]

Description détaillée

The Get-VHDSnapshot cmdlet gets information about a checkpoint in a virtual hard disk (VHD) set file.

Checkpoint replaces the previous term, snapshot.

Paramètres

-CimSession<CimSession[]>

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tels que le résultat d'une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts that run this command. 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

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Credential<PSCredential[]>

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

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-GetParentPaths

Gets the paths of all files on which this VHD checkpoint depends.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Path<String[]>

Specifies an array of paths of VHD set files from which this cmdlet gets checkpoints. If you specify a file name or relative path, the cmdlet determines the full path relative to the current working folder.

Alias

FullName

Requis ?

true

Position ?

1

Valeur par défaut

none

Accepter l'entrée de pipeline ?

true(ByValue,ByPropertyName)

Accepter les caractères génériques ?

false

-SnapshotId<Guid[]>

Specifies an array of unique IDs of VHD checkpoints that this cmdlet gets from a VHD set file.

Alias

none

Requis ?

false

Position ?

named

Valeur par défaut

none

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

  • Microsoft.Vhd.PowerShell.VHDSnapshotInfo

    This cmdlet returns a VHDSnapshotInfo object.

Exemples

Example 1: Get information about a checkpoint

This command gets information about the checkpoint that has the specified ID from the VHD set file named Data01.vhds in the current working folder.

PS C:\> Get-VHDSnapshot -Path "Data01.vhds" -SnapshotId 6c87351a-a39a-4581-b231-6d693b26485d 

Rubriques connexes

Export-VMSnapshot

Get-VMSnapshot

Rename-VMSnapshot

Restore-VMSnapshot

Get-VHDSet