Restore-SCVMCheckpoint
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 .