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.

Syntaxe

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 Get-SCVMCheckpoint obtient un ou plusieurs objets de point de contrôle de machine virtuelle à partir de la base de données Virtual Machine Manager (VMM).

Un point de contrôle de machine virtuelle est un « instantané » à un point dans le temps d’une machine virtuelle. Vous pouvez utiliser le point de contrôle pour rétablir un état précédent d’une machine virtuelle. 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 des 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 le nom, le type MemberType et la définition de chaque événement, méthode et propriété associés à 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 de 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 en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MostRecent

Spécifie l’objet de point de contrôle de machine virtuelle VMM le plus récent.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUser

Spécifie le nom d’un utilisateur. Cette applet de commande définit le compte de l’utilisateur en tant qu’utilisateur spécifié par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VM

Spécifie un objet de machine virtuelle.

Type:VM
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

VMCheckpoint

Cette applet de commande retourne un objet VMCheckpoint.