Partager via

Restore-SCVMCheckpoint

  • Référence
Module:
VirtualMachineManager

Restaure une machine virtuelle sur un point de contrôle spécifié.

Syntaxe

Restore-SCVMCheckpoint
       -VMCheckpoint <VMCheckpoint>
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [-WhatIf]
       [-Confirm]
       [-OnBehalfOfUser <String>]
       [-OnBehalfOfUserRole <UserRole>]
       [<CommonParameters>]

Description

L’applet de commande Restore-SCVMCheckpoint restaure une machine virtuelle à un point de contrôle spécifié. 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.

Si l’opération de restauration réussit, l’applet de commande Restore-VMCheckpoint retourne l’objet de point de contrôle. Si l’opération échoue, l’applet de commande retourne un message d’erreur.

La restauration d’une machine virtuelle vers un point de contrôle antérieur ignore toutes les modifications apportées à la machine virtuelle depuis la création du point de contrôle le plus récent. Toutefois, tous les points de contrôle, y compris ceux effectués après le point de contrôle sur lequel vous restaurez une machine virtuelle, restent disponibles. Par conséquent, une bonne pratique consiste à créer un point de contrôle avant de restaurer la machine virtuelle pour vous assurer que l’état actuel de la machine virtuelle est disponible après l’opération de restauration.

Exemples

Exemple 1 : Restaurer une machine virtuelle sur son point de contrôle le plus récent

PS C:\> Get-SCVMCheckpoint -VM "VM01" -MostRecent | Restore-SCVMCheckpoint

Cette commande obtient l’objet de point de contrôle le plus récent pour la machine virtuelle VM01 et restaure VM01 à l’état dans lequel il était au moment où son point de contrôle le plus récent a été créé.

Exemple 2 : Restaurer une machine virtuelle sur le point de contrôle spécifié

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM02"
PS C:\> Restore-SCVMCheckpoint -VMCheckpoint $Checkpoints[$Checkpoints.count - 2]

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

La deuxième commande restaure VM02 vers le deuxième point de contrôle du dernier point de contrôle (cet exemple suppose que vous avez au moins deux points de contrôle). VMM conserve les points de contrôle créés après le point de contrôle sur lequel vous effectuez la restauration, ce qui vous permet de restaurer la machine virtuelle vers un point de contrôle ultérieur. Pour restaurer une machine virtuelle à son point de contrôle le plus récent, consultez l’exemple 1.

Exemple 3 : Afficher le profil matériel du dernier point de contrôle restauré sur une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VM.LastRestoredVMCheckpoint.CheckpointHWProfile

La première commande obtient l’objet de machine virtuelle nommé VM02 et stocke l’objet dans la variable $VM. Cet exemple suppose que la machine virtuelle a été restaurée sur l’un de ses points de contrôle.

La deuxième commande affiche des informations sur le profil matériel du dernier point de contrôle restauré sur VM02.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée 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

-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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

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

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VMCheckpoint

Spécifie un objet de point de contrôle de machine virtuelle VMM (Virtual Machine Manager).

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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

Sorties

VMCheckpoint

Cette applet de commande retourne un objet VMCheckpoint.

Notes

  • Nécessite un objet de point de contrôle VMM, que vous pouvez récupérer à l’aide de l’applet de commande Get-SCVMCheckpoint Get-SCVMCheckpoint.