Partager via

Get-SCVMCheckpoint

  • Référence
Module:
VirtualMachineManager

Obtient des objets de point de contrôle de machine virtuelle à partir de la base de données VMM.

Syntax

Get-SCVMCheckpoint
   [-VMMServer <ServerConnection>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVMCheckpoint
   [-VM <VM>]
   [-VMMServer <ServerConnection>]
   [-MostRecent]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVMCheckpoint
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCVMCheckpoint obtient un ou plusieurs objets de point de contrôle de machine virtuelle à partir de la base de données VMM (Virtual Machine Manager).

Un point de contrôle de l’ordinateur virtuel est un « instantané » d’un ordinateur virtuel à un instant donné. Vous pouvez utiliser le point de contrôle pour rétablir une machine virtuelle à un état précédent. Pour plus d’informations sur les points de contrôle VMM, tapez Get-Help New-VMCheckpoint -Detailed.

Exemples

Exemple 1 : Obtenir tous les points de contrôle existants pour chaque machine virtuelle

PS C:\> Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"

Cette commande obtient tous les objets de point de contrôle existants pour chaque machine virtuelle gérée par VMMServer01 et affiche des informations sur ces objets de point de contrôle à l’utilisateur.

Exemple 2 : Obtenir tous les points de contrôle pour une ou plusieurs machines virtuelles avec un nom spécifique

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01" 
PS C:\> $Checkpoints

La première commande obtient tous les objets de point de contrôle pour la machine virtuelle VM01 et stocke les objets dans le tableau d’objets $Checkpoints.

La deuxième commande affiche des informations sur les objets de point de contrôle dans $Checkpoints.

Exemple 3 : Obtenir le profil matériel du point de contrôle le plus récemment créé sur une machine virtuelle déployée sur un hôte Hyper-V

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Checkpoint = $VM | Get-SCVMCheckpoint -MostRecent
PS C:\> $Checkpoint.CheckpointHWProfile

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.

La deuxième commande obtient l’objet de point de contrôle le plus récent créé pour VM01 et stocke l’objet dans la variable $Checkpoint.

La dernière commande affiche des informations sur le profil matériel du point de contrôle stocké dans $Checkpoint (l’objet de point de contrôle le plus récent créé pour VM01).

Exemple 4 : Afficher le type .NET, les événements, les méthodes et les propriétés pour les objets de point de contrôle

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Checkpoints | Get-Member
PS C:\> $Checkpoints | Get-Member | Format-List

La première commande obtient tous les objets de point de contrôle sur VMMServer01 et stocke les objets dans le tableau d’objets $Checkpoints.

La deuxième commande transmet chaque objet de point de contrôle dans $Checkpoints à l’applet de commande Get-Member , qui affiche .NET TypeName et name, MemberType et Definition pour chaque événement, méthode et propriété associée à ce type d’objet.

La dernière commande est identique à la deuxième commande, sauf qu’elle canalise la sortie vers l’applet de commande Format-List afin que vous puissiez voir la définition complète pour chaque événement, méthode et propriété pour le type d’objet de point de contrôle.

Paramètres

-ID

Spécifie l’identificateur numérique comme identificateur global unique ou GUID pour un objet spécifique.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MostRecent

Spécifie l’objet point de contrôle d’ordinateur virtuel VMM le plus récent.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Spécifie le nom d'un utilisateur. Cette applet de commande définit le nom de l’utilisateur comme utilisateur spécifié par ce paramètre.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Spécifie un objet ordinateur virtuel.

Type:VM
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Sorties

VMCheckpoint

Cette applet de commande retourne un objet VMCheckpoint .