Restaurer une VM Hyper-V

Ce que fait une restauration de VM Hyper-V

Une restauration de VM Hyper-V relit un point de restauration de VM et réécrit les disques et la configuration de la VM sur un hôte Hyper-V. Elle demande une politique VM Hyper-V avec au moins une sauvegarde réussie. Voir Sauvegarder les VM d'un hôte Hyper-V.

BaaStide propose deux modes :

Mode	Ce qu'il fait
Une nouvelle VM	Crée une copie de la VM, avec un nouvel identifiant, à côté de la VM actuelle. La VM actuelle ne change pas.
La VM actuelle	Ramène la VM au point de restauration. La VM garde son identifiant. Ses disques actuels sont supprimés quand la restauration réussit.

Le mode Une nouvelle VM s'exécute sur l'hôte d'origine, ou sur un autre hôte Hyper-V du même client. Le mode La VM actuelle s'exécute sur l'hôte d'origine seulement.

Une restauration de VM ne rend pas un fichier pris dans la VM. Pour restaurer des fichiers d'une VM, installez aussi l'agent BaaStide dans la VM.

Prérequis

• Au moins un point de restauration de la VM. Voir Trouver le bon point de restauration.
• Le rôle Technicien ou Administrateur. Un rôle Lecture seule n'ouvre pas la page de restauration : le portail écrit alors « Votre rôle ne permet pas cette action. »
• L'hôte cible en ligne, avec un agent qui exécute Hyper-V.
• Assez d'espace libre sur le volume cible : la taille des fichiers de disque, plus 10 %.
• Pour le mode La VM actuelle : une session du portail. Une clé API du MSP et un assistant IA reçoivent une réponse 403.

Une restauration n'a pas besoin d'une licence qui permet les sauvegardes.

Ouvrir la page de restauration d'une VM

1. Ouvrez le portail.
2. Ouvrez Endpoints, puis l'hôte Hyper-V.
3. Ouvrez l'onglet VM.
4. Cliquez Restaurer sur la ligne de la VM.

La page porte le titre Restaurer nom de la VM et le texte « Restaurez les disques et la configuration de la VM depuis un point de restauration. »

Le bouton Restaurer n'apparaît que lorsque la VM a un point de restauration. Sur la page de restauration, quand aucun point n'existe, le portail écrit « Cette VM n'a pas encore de point de restauration. » Quand la VM a quitté la liste de l'hôte, il écrit « Cette VM n'est pas dans la liste de l'hôte. »

Choisir le point de restauration

1. Lisez la liste Point de restauration. Elle donne les points de cette VM, du plus récent au plus ancien, avec leur date et leur taille.
2. Choisissez un point.
3. Cliquez Voir plus quand le point que vous cherchez n'est pas dans la liste.

Quand le point choisi est cohérent après plantage, le portail écrit « Ce point de restauration est cohérent après plantage : les applications de la VM n'ont pas été prévenues d'enregistrer leurs données. »

Restaurer comme une nouvelle VM

1. Ouvrez la page de restauration de la VM.
2. Choisissez le Point de restauration.
3. Dans Restaurer comme, gardez Une nouvelle VM.
4. Lisez la liste Hôte. Elle s'ouvre sur l'hôte d'origine. Voir Restaurer sur un autre hôte du client.
5. Lisez le Nom de la nouvelle VM. Le portail propose le nom de la VM suivi de -restore-<date du jour>. Changez-le si nécessaire. Le nom porte 100 caractères au plus.
6. Saisissez le Dossier sur l'hôte, ou laissez le champ vide. Vide, l'agent écrit dans le dossier de disques virtuels par défaut de l'hôte.
7. Choisissez le Commutateur virtuel de chaque carte réseau de la VM. Voir Choisir le commutateur virtuel.
8. Choisissez les Adresses MAC. Voir Choisir les adresses MAC.
9. Cochez Démarrer la VM après la restauration si la VM doit démarrer tout de suite.
10. Lisez les messages de la page : espace libre, TPM, commutateur.
11. Cliquez Restaurer comme nouvelle VM.

Le portail écrit « La restauration de nom a commencé. », puis il ouvre la page de suivi de la restauration.

Le Dossier sur l'hôte est un chemin complet sur un volume local NTFS ou ReFS, par exemple D:\Hyper-V. La racine d'un lecteur est refusée : le portail écrit « Tapez un chemin complet comme D:\Hyper-V, pas seulement un lecteur. » L'agent crée un sous-dossier au nom de la nouvelle VM.

Quand le volume cible n'a pas assez de place, le portail écrit « Le volume _X:_ de l'hôte a N libres. La restauration demande environ M. » C'est un avertissement : vous pouvez quand même lancer la restauration. L'agent échoue alors avec Pas assez d'espace libre sur le volume.

Restaurer sur un autre hôte du client

Le mode Une nouvelle VM accepte un autre hôte Hyper-V, à condition qu'il appartienne au même client que l'hôte d'origine.

1. Ouvrez la page de restauration de la VM.
2. Choisissez le Point de restauration.
3. Ouvrez la liste Hôte. Elle donne l'hôte d'origine, marqué (cet hôte), puis les autres hôtes du client, par nom.
4. Choisissez un hôte.
5. Le portail écrit « La VM est restaurée sur nom. La VM actuelle sur source ne change pas. »
6. Vérifiez le dossier et le commutateur : ils viennent maintenant de l'hôte choisi.
7. Lisez le message sur le TPM. Voir TPM virtuel et BitLocker.
8. Cliquez Restaurer comme nouvelle VM.

Un hôte qui ne peut pas recevoir cette VM est grisé. La liste écrit son nom, puis sa cause :

Cause	Texte du portail
Pas un hôte Hyper-V	« pas un hôte Hyper-V »
Version de configuration	« version de configuration trop récente pour cet hôte »
Agent trop ancien	« agent trop ancien »
Suppression demandée	« suppression en attente »
Agent hors ligne	« agent hors ligne »

Un hôte d'un autre client n'est jamais dans la liste. Quand une demande nomme un hôte d'un autre client, l'API répond 409 et le portail écrit « Cet hôte appartient à un autre client. Restaurez sur un hôte du même client. »

Quand la liste des hôtes ne se charge pas, le portail écrit « La liste des hôtes ne s'est pas chargée. Vous pouvez quand même restaurer sur cet hôte. »

Remplacer la VM actuelle

Ce mode supprime les disques en place. Lisez cette partie en entier avant de l'utiliser.

1. Ouvrez la page de restauration de la VM.
2. Choisissez le Point de restauration.
3. Dans Restaurer comme, choisissez La VM actuelle.
4. Saisissez le Dossier sur l'hôte, ou laissez le champ vide. Vide, l'agent écrit dans le dossier de la VM.
5. Choisissez le Commutateur virtuel. La VM garde ses adresses MAC.
6. Cochez Démarrer la VM après la restauration. La case est déjà cochée quand la VM est en marche.
7. Lisez la partie Arrêt de la VM : « L'agent demande à l'invité de s'arrêter, puis attend jusqu'à 10 minutes. »
8. Cochez Éteindre la VM si elle ne s'arrête pas à temps seulement si vous acceptez de perdre les données que l'invité n'a pas enregistrées. Sans cette option, la restauration s'arrête et la VM ne change pas.
9. Lisez l'avertissement : « L'agent arrête nom, importe la VM restaurée avec le même ID, puis supprime les disques actuels de la VM. Les disques actuels sont supprimés quand Hyper-V importe et démarre la VM restaurée. Si la restauration échoue, l'agent remet la VM actuelle. »
10. Tapez le nom de la VM dans le champ de confirmation, exactement comme il apparaît.
11. Cliquez Remplacer la VM.

Le portail refuse la confirmation quand le nom ne correspond pas : « Tapez le nom exactement comme il apparaît : nom ». L'API et l'agent vérifient ce nom une deuxième fois. Quand la VM a été renommée entre-temps, la réponse est 422 et le portail écrit « Le nom tapé n'est pas le nom de la VM. Tapez-le de nouveau. »

Le mode La VM actuelle est grisé dans ces cas :

Cas	Texte du portail
La VM a quitté l'hôte	« La VM n'est plus sur l'hôte. Restaurez-la comme une nouvelle VM. »
La VM ne peut pas être sauvegardée	« Cette VM ne peut pas être sauvegardée, donc elle ne peut pas être remplacée. »
La VM a des points de contrôle	« La VM a N points de contrôle. Supprimez-les d'abord dans le Gestionnaire Hyper-V. »

Le remplacement garde la définition de la VM : son identifiant, son état UEFI et son TPM ne changent pas.

Ce que l'agent fait en cas d'échec

L'agent note la configuration et les fichiers de disque de la VM avant de la changer. Quand la restauration échoue :

• il éteint la VM, remet la configuration et les disques notés, redémarre la VM si elle tournait, et supprime les fichiers restaurés. Le portail écrit « La restauration a échoué. L'agent a remis la VM précédente. » ;
• quand ce retour en arrière échoue aussi, rien n'est supprimé. Le portail écrit « La restauration a échoué et l'agent n'a pas pu remettre la VM précédente. Lisez le message de l'agent : il donne les chemins des fichiers. »

Les anciens fichiers de disque sont supprimés après le succès seulement. Un fichier utilisé par une autre VM n'est jamais supprimé.

Choisir le commutateur virtuel

La liste Commutateur virtuel règle le commutateur de chaque carte réseau de la VM. Elle a trois sortes de valeurs :

Valeur	Ce qu'elle fait
Même commutateur que la VM, s'il existe	Chaque carte garde le commutateur du point de restauration, quand l'hôte cible le porte. Sinon, la carte n'est pas connectée.
Un commutateur de l'hôte, avec son type (externe, interne, privé, NAT)	Toutes les cartes vont sur ce commutateur.
Non connectée	Aucune carte n'est connectée.

Quand vous choisissez le Default Switch de Windows, le portail écrit « Le Default Switch reçoit un nouveau réseau à chaque démarrage de l'hôte. Ne l'utilisez pas pour une VM que d'autres ordinateurs doivent joindre. »

Quand le commutateur du point de restauration n'existe pas sur l'hôte, la restauration réussit avec l'avertissement « Le commutateur de la VM n'existe pas sur l'hôte. Les cartes réseau ne sont pas connectées. »

Choisir les adresses MAC

Le mode Une nouvelle VM offre deux choix.

Choix	Ce qu'il fait
Nouvelles adresses MAC	Pas de conflit avec la VM actuelle. Une VM Linux dont les paramètres réseau suivent l'adresse MAC peut perdre son réseau.
Garder les adresses MAC	Les paramètres réseau de l'invité ne changent pas. Deux VM avec la même adresse MAC sur un réseau causent un conflit.

Quand vous gardez les adresses MAC sur l'hôte d'origine et que la VM actuelle est en marche, le portail écrit « La VM actuelle est en marche. Si la nouvelle VM démarre sur le même réseau avec les mêmes adresses MAC, les deux VM sont en conflit. »

Le mode La VM actuelle garde toujours les adresses MAC.

TPM virtuel et BitLocker

Une VM de génération 2 peut porter un TPM virtuel. BitLocker dans la VM s'appuie sur ce TPM. L'état du TPM est chiffré par le gardien de son hôte.

Sur l'hôte d'origine

Le portail écrit « Cette VM a un TPM virtuel. Sur cet hôte, le TPM et BitLocker fonctionnent après la restauration. »

Sur un autre hôte du client

Le portail lit le point de restauration et l'hôte choisi, puis il écrit l'un de ces trois messages :

Cas	Texte du portail
L'hôte cible a déjà le gardien	« TPM conservé : hôte a déjà le gardien TPM de source. BitLocker dans la VM ne demande pas sa clé de récupération. »
Le point de restauration contient le gardien	« TPM conservé : le point de restauration contient le gardien TPM de source. L'agent l'ajoute sur hôte, et BitLocker dans la VM ne demande pas sa clé de récupération. »
Le gardien manque	« Ce point de restauration ne contient pas le gardien TPM de source. Sur hôte, la VM reçoit un nouveau TPM vide : BitLocker dans la VM demande sa clé de récupération au premier démarrage. »

Dans le dernier cas, le portail demande une confirmation : cochez J'ai la clé de récupération BitLocker de cette VM. Sans cette case, le portail refuse l'envoi et écrit « Confirmez que vous avez la clé de récupération BitLocker, ou restaurez sur cet hôte. »

Quand l'agent ajoute le gardien sur l'hôte cible, la page de suivi écrit « L'agent a importé le gardien TPM de source sur l'hôte cible. Cet hôte peut maintenant ouvrir le TPM des VM de source. » Elle donne le nom du gardien et l'empreinte de son certificat de chiffrement. Le journal d'audit garde cette opération. Voir Journal d'audit.

L'agent n'écrase jamais le gardien existant de l'hôte cible. Il ajoute le gardien de l'hôte source à côté, sous le nom BaaStide-<nom de l'hôte source>, avec une clé privée non exportable. Ce gardien reste sur l'hôte cible, même quand la restauration échoue ou est annulée.

Suivre la restauration

Le portail ouvre la page de la restauration dès l'envoi. Vous y suivez l'avancement et vous pouvez annuler. Voir Suivre et arrêter une restauration.

La carte Machine virtuelle résume la demande et la réponse de l'agent :

Ligne	Ce qu'elle donne
Restaurer comme	Nouvelle VM ou Remplacement.
VM	Le nom de la VM restaurée.
Dossier	Le dossier sur l'hôte. Un rôle Lecture seule et une clé API sans droit de parcours lisent Masqué.
Commutateur	Le commutateur choisi, Même commutateur que la VM, ou Non connectée.
Adresses MAC	Gardées ou Nouvelles.
Démarrer après la restauration	Oui ou Non.
VM restaurée	La taille restaurée, une fois la restauration terminée.
Gardien TPM importé	Le gardien ajouté sur l'hôte cible, avec son empreinte.
Paramètres retirés	Les réglages que l'agent n'a pas remis.

Les avertissements

Avertissement	Texte du portail
Paramètres retirés	« Des paramètres de la VM ont été retirés : ils ne sont pas dans la liste des paramètres autorisés. »
Configuration non importée	« Hyper-V n'a pas pu importer la configuration. La VM a été créée depuis le résumé : pas d'état UEFI. »
Configuration non importée, sans TPM	« Hyper-V n'a pas pu importer la configuration. La VM a été créée depuis le résumé : pas d'état UEFI et pas de TPM. »
TPM remis à zéro	« La VM a un nouveau TPM vide. BitLocker dans la VM demande sa clé de récupération. »
Commutateur absent	« Le commutateur de la VM n'existe pas sur l'hôte. Les cartes réseau ne sont pas connectées. »

Les paramètres retirés

L'agent remet la configuration de la VM à partir d'une liste de réglages autorisés. Il retire les réglages qui dépendent du matériel de l'hôte ou d'un média. La carte les nomme : Disque non sauvegardé, Disque pass-through, Disque partagé, Média DVD, Média de disquette, Port COM, Fibre Channel virtuel, Périphérique attribué (DDA), Partition de GPU, Pool de ressources, Chemin de l'hôte et Autre réglage.

Vérifiez ces réglages sur la VM restaurée, dans le Gestionnaire Hyper-V.

Les causes d'échec

Cause	Texte du portail
target_not_hyperv	« La machine n'est pas un hôte Hyper-V. »
config_version_unsupported	« L'hôte ne peut pas exécuter la version de configuration de la VM. »
confirm_name_mismatch	« Le nom tapé n'est pas le nom de la VM. »
vm_not_found	« La VM n'est pas sur l'hôte. »
vm_has_checkpoints	« La VM a des points de contrôle. Supprimez-les dans le Gestionnaire Hyper-V, puis relancez la restauration. »
vm_stop_timeout	« La VM ne s'est pas arrêtée à temps. Rien n'a changé. »
target_path_invalid	« Le dossier n'est pas sur un volume local NTFS ou ReFS. »
restore_no_space	« Pas assez d'espace libre sur le volume. »
restore_checksum_mismatch	« Un fichier restauré n'est pas identique au fichier sauvegardé. »
restore_config_rejected	« La configuration de la VM a un réglage non autorisé. »
restore_rolled_back	« La restauration a échoué. L'agent a remis la VM précédente. »
rollback_failed	« La restauration a échoué et l'agent n'a pas pu remettre la VM précédente. Lisez le message de l'agent : il donne les chemins des fichiers. »
read_failed	« Le point de restauration n'a pas pu être lu. »
internal	« Erreur de l'agent. »

Prévisualiser une restauration par l'API ou un assistant IA

Le portail vérifie lui-même l'hôte, le dossier et l'espace libre pendant que vous remplissez le formulaire. Une clé API du MSP et un assistant IA utilisent pour cela un aperçu : POST /endpoints/{id}/vm-restores/preview.

L'aperçu ne restaure rien. Il donne :

• les contrôles de l'hôte cible : hyperviseur, version de configuration, agent en ligne ;
• les totaux : la taille des fichiers de disque lus à la sauvegarde, l'espace libre du volume cible, et si cet espace suffit avec une marge de 10 % ;
• l'état du TPM après la restauration, et sa raison ;
• les avertissements, par exemple le gardien TPM absent ou la VM source en marche avec les mêmes adresses MAC.

Pour un assistant IA, l'aperçu donne aussi un jeton de confirmation. Ce jeton sert une seule fois, reste valable 10 minutes, et ne vaut que pour cette demande exacte. Le lancement de la restauration par un assistant IA le demande. Le portail et une clé API du MSP n'en ont pas besoin : l'aperçu reste alors facultatif.

Un assistant IA et une clé API du MSP créent toujours une nouvelle VM. Ils ne remplacent jamais une VM : cette action demande une personne connectée au portail.

Limites et précautions

• Le mode La VM actuelle supprime les disques en place quand la restauration réussit. Préférez Une nouvelle VM quand vous voulez garder la VM actuelle.
• Le remplacement d'une VM se fait dans le portail seulement. Une clé API du MSP et un assistant IA reçoivent 403.
• Une restauration de VM reste dans le même client. Un hôte d'un autre client est refusé, sans confirmation possible.
• Supprimez les points de contrôle de la VM avant un remplacement. Hyper-V n'importe pas une VM qui porte des points de contrôle.
• Une VM restaurée depuis un point cohérent après plantage démarre comme après une coupure de courant. Vérifiez les applications de la VM.
• Sur un autre hôte, une VM avec un TPM garde son TPM seulement quand le gardien est dans le point de restauration, ou déjà sur l'hôte cible. Sinon, BitLocker dans la VM demande sa clé de récupération. Gardez cette clé hors de l'hôte.
• Une VM de génération 2 créée sans l'état UEFI de la source démarre depuis son disque, pas depuis l'entrée « Windows Boot Manager » d'origine.
• Le dossier cible doit être sur un volume local NTFS ou ReFS de l'hôte. Un partage réseau est refusé.
• Une machine exécute une seule restauration à la fois.
• La restauration demande la taille des fichiers de disque plus 10 % sur le volume cible.
• Les réglages liés au matériel de l'hôte ne sont pas remis. Relisez la liste Paramètres retirés.
• Une restauration de VM ne donne pas un fichier de la VM. Installez un agent dans la VM pour sauvegarder et restaurer ses fichiers.
• Un assistant IA ne restaure pas vers une machine qu'un assistant IA a enrôlée, pendant 24 heures. Voir Choisir la bonne restauration.

Référence

• API : Lister les hôtes d'une restauration de VM.
• API : Prévisualiser une restauration de VM.
• API : Créer une restauration de VM.
• API : Annuler une restauration.
• API : Lister les VM d'un endpoint.
• Outils MCP : preview_vm_restore, start_vm_restore et cancel_vm_restore.
• Outils MCP : list_vm_snapshots et list_vm_restore_targets.