Partager via

Restore-SCVMCheckpoint

  • Référence
Module:
VirtualMachineManager

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

Syntax

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 sur un point de contrôle spécifié. 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.

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, la cmdlet renvoie 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 auquel 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 (cet exemple suppose que vous disposez d’au moins deux points de contrôle). VMM conserve les points de contrôle créés après le point de contrôle que vous restaurez, ce qui vous permet de restaurer la machine virtuelle vers un point de contrôle ultérieur. Pour restaurer une machine virtuelle sur 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 demande une confirmation avant d’exécuter l’applet de commande.

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

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VMCheckpoint

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .