Documentation produit
XenServer
XenServer 9 XenServer 8.4
Voir PDF

XenServer® VM Tools pour Windows

August 1, 2026
Contributeur: 
X

Les XenServer VM Tools (anciennement Citrix VM Tools ou XenServer PV Tools) pour Windows fournissent des services d’E/S hautes performances sans la surcharge de l’émulation de périphérique traditionnelle. Les XenServer VM Tools pour Windows se composent de pilotes d’E/S (également appelés pilotes paravirtualisés ou pilotes PV) et de l’agent de gestion.

Les XenServer VM Tools pour Windows doivent être installés sur chaque machine virtuelle Windows pour que la machine virtuelle dispose d’une configuration entièrement prise en charge. Une machine virtuelle fonctionne sans eux, mais les performances sont altérées.

La version des XenServer VM Tools pour Windows est mise à jour indépendamment de la version de XenServer. Pour être pris en charge, assurez-vous que vos XenServer VM Tools pour Windows sont régulièrement mis à jour vers la dernière version, à la fois dans vos machines virtuelles et dans les modèles que vous utilisez pour créer vos machines virtuelles. Pour plus d’informations sur la dernière version des outils, consultez Nouveautés.

Installer les XenServer VM Tools

Remarque :

Pour installer les XenServer VM Tools pour Windows sur une machine virtuelle Windows, la machine virtuelle doit exécuter le Microsoft .NET Framework version 4.0 ou ultérieure.

Les XenServer VM Tools pour Windows sont installés par défaut dans le répertoire C:\Program Files\XenServer\XenTools sur la machine virtuelle.

Pour installer les XenServer VM Tools pour Windows :

  1. Nous vous recommandons de créer un instantané de votre machine virtuelle avant d’installer ou de mettre à jour les XenServer VM Tools.

  2. Téléchargez le fichier XenServer VM Tools pour Windows depuis la page de téléchargements XenServer.

  3. Vérifiez votre téléchargement par rapport à la valeur SHA-256 fournie.

  4. Copiez le fichier sur votre machine virtuelle Windows ou sur un lecteur partagé auquel la machine virtuelle Windows peut accéder.

  5. Exécutez le fichier managementagentx64.msi pour commencer l’installation des XenServer VM Tools.

    Msiexec.exe /package managementagentx64.msi

  6. Suivez les invites du programme d’installation.

    • Suivez les instructions de l’assistant pour accepter le contrat de licence et choisir un dossier de destination.

    • Personnalisez les paramètres sur la page Paramètres d’installation et de mises à jour.

      Par défaut, l’assistant affiche le paramètre recommandé suivant :

      • Maintenir les outils XenServer VM Tools pour Windows à jour automatiquement.

      Pour certains cas d’utilisation, des paramètres de mise à jour différents sont recommandés. Pour plus d’informations, consultez Mettre à jour les outils XenServer VM Tools.

      Pour configurer les paramètres de mise à jour, vous pouvez apporter les modifications suivantes :

      • Si vous ne souhaitez pas autoriser la mise à jour automatique de l’agent de gestion, décochez la case Maintenir les outils XenServer VM Tools pour Windows à jour automatiquement.

    • Cliquez sur Suivant, puis sur Installer pour démarrer le processus d’installation des outils XenServer VM Tools pour Windows.

  7. Redémarrez la machine virtuelle lorsque vous y êtes invité pour terminer le processus d’installation.

    Les clients qui installent les outils XenServer VM Tools pour Windows ou l’agent de gestion via RDP peuvent ne pas voir l’invite de redémarrage, car elle n’apparaît que sur la session de console Windows. Pour vous assurer de redémarrer votre machine virtuelle (si nécessaire) et de la faire passer à un état optimisé, spécifiez l’option de redémarrage forcé dans RDP. L’option de redémarrage forcé redémarre la machine virtuelle uniquement si cela est nécessaire pour la faire passer à un état optimisé.

Avertissement :

L’installation ou la mise à niveau des outils XenServer VM Tools pour Windows peut entraîner la modification du nom convivial et de l’identifiant de certains adaptateurs réseau. Tout logiciel configuré pour utiliser un adaptateur particulier pourrait devoir être reconfiguré après l’installation ou la mise à niveau des outils XenServer VM Tools pour Windows.

Installation silencieuse

Pour installer les outils XenServer VM Tools pour Windows en mode silencieux et empêcher le redémarrage du système, exécutez la commande suivante :

Msiexec.exe /package managementagentx64.msi /quiet /norestart
<!--NeedCopy-->

Une installation non interactive, mais non silencieuse peut être obtenue en exécutant :

Msiexec.exe managementagentx64.msi /passive
<!--NeedCopy-->

Remarques :

  • Le paramètre /quiet s’applique uniquement aux boîtes de dialogue d’installation, mais pas à l’installation du pilote de périphérique. Lorsque le paramètre /quiet est spécifié, l’installation du pilote de périphérique demande l’autorisation de redémarrer si nécessaire.
    • Lorsque /quiet /norestart est spécifié, le système ne redémarre pas une fois l’installation complète des outils terminée. Ce comportement est indépendant de ce que l’utilisateur spécifie dans la boîte de dialogue de redémarrage.
    • Lorsque /quiet /forcerestart est spécifié, le processus de mise à niveau ou d’installation peut déclencher plusieurs redémarrages. Ce comportement est indépendant de ce que l’utilisateur spécifie dans la boîte de dialogue de redémarrage.
    • Lorsque l’installation du pilote de périphérique demande l’autorisation de redémarrer, une installation des outils avec le paramètre quiet spécifié peut toujours être en cours. Utilisez le Gestionnaire des tâches pour confirmer si l’installateur est toujours en cours d’exécution.

Pour personnaliser les paramètres d’installation, utilisez les paramètres suivants avec les commandes d’installation silencieuse :

Paramètre Valeurs autorisées Par défaut Description
ALLOWAUTOUPDATE YES or NO YES Autoriser les mises à jour automatiques de l’agent de gestion

Par exemple, pour effectuer une installation silencieuse des outils qui n’autorise pas les futures mises à jour automatiques de l’agent de gestion, exécutez l’une des commandes suivantes :

Msiexec.exe /package managementagentx64.msi ALLOWAUTOUPDATE=NO /quiet /norestart
<!--NeedCopy-->

Pour les installations interactives, silencieuses et passives, après le prochain redémarrage du système, il peut y avoir plusieurs redémarrages automatiques avant que les XenServer VM Tools pour Windows ne soient entièrement installés. Ce comportement est également le cas pour les installations avec l’indicateur /norestart spécifié. Cependant, pour les installations où l’indicateur /norestart est fourni, le redémarrage initial peut être initié manuellement.

Mettre à jour les XenServer VM Tools

Assurez-vous que vos XenServer VM Tools pour Windows sont régulièrement mis à jour vers la dernière version, à la fois dans vos machines virtuelles et dans tous les modèles que vous utilisez pour créer vos machines virtuelles. Nous vous recommandons de prendre un instantané de votre machine virtuelle avant de mettre à jour les XenServer VM Tools. Pour plus d’informations sur la dernière version des outils, consultez Nouveautés.

Important :

Assurez-vous que tous les redémarrages de machines virtuelles demandés sont effectués dans le cadre de la mise à jour. Plusieurs redémarrages peuvent être nécessaires. Si tous les redémarrages demandés ne sont pas effectués, la machine virtuelle pourrait présenter un comportement inattendu.

XenServer fournit des mécanismes de mise à jour automatique pour chacun de ses composants :

  • L’agent de gestion peut se mettre à jour automatiquement ainsi que les pilotes d’E/S.
  • Les pilotes d’E/S peuvent également être mis à jour via Windows Update lors de la sélection d’un modèle de machine virtuelle dans l’assistant Nouvelle machine virtuelle de XenCenter. Cette approche n’est pas recommandée car les mises à jour fournies via Windows Update peuvent provoquer des redémarrages de machines virtuelles. Pour plus de détails sur l’activation des mises à jour des pilotes d’E/S via Windows Update, consultez Présentation des étapes de création de machines virtuelles.

Nous recommandons d’installer les outils avec le programme d’installation MSI et d’utiliser le mécanisme de mise à jour intégré de l’agent de gestion pour gérer les mises à jour. Lorsque vous installez les outils avec le programme d’installation, le mécanisme de mise à jour de l’agent de gestion détecte automatiquement les machines virtuelles provisionnées à l’aide des services de création de machines (MCS) ou de Citrix Provisioning, vous permettant d’appliquer des mises à jour sur l’image dorée sans affecter les machines provisionnées.

Alternativement, vous pouvez mettre à jour l’un ou l’autre de ces composants, ou les deux, avec le programme d’installation.

La méthode de mise à jour à choisir pour chaque composant des outils peut dépendre de votre environnement.

Paramètres de mise à jour recommandés

Pour la plupart des cas d’utilisation, nous recommandons d’installer les XenServer VM Tools pour Windows avec le programme d’installation MSI et d’utiliser l’agent de gestion pour maintenir à jour à la fois lui-même et les pilotes d’E/S. Cette approche évite les redémarrages de machines virtuelles qui peuvent se produire lorsque les mises à jour sont fournies via Windows Update.

Nous recommandons les paramètres suivants :

  1. Activer les mises à jour de l’agent de gestion.

  2. Désactiver les mises à jour des pilotes d’E/S via Windows Update.

Pendant l’installation :

Les valeurs par défaut des paramètres sont recommandées :

Programme d'installation des XenServer VM Tools avec les paramètres de mise à jour par défaut sélectionnés

Paramètres pour les cibles Citrix Provisioning™ ou les machines avec réinitialisation au démarrage

Si vous avez l’intention d’utiliser votre machine virtuelle Windows comme cible Citrix Provisioning ou avec l’indicateur de réinitialisation au démarrage activé, vous ne pouvez utiliser aucun des mécanismes de mise à jour automatisés. Nous vous recommandons de définir la configuration suivante sur le modèle maître que vous utilisez pour créer ces machines virtuelles :

  1. Lors de la création de la machine virtuelle, assurez-vous que l’indicateur has-vendor-device est défini sur false. Cela empêche Windows Update de mettre à jour automatiquement les pilotes d’E/S pour les XenServer VM Tools pour Windows. Vous pouvez définir cet indicateur en :

  2. Désactiver les mises à jour de l’agent de gestion.

Pendant l’installation :

Spécifiez cette configuration lors de la première installation des XenServer VM Tools :

Programme d'installation des XenServer VM Tools avec les paramètres de non-mise à jour automatique sélectionnés

Paramètres pour les mises à jour automatiques par l’agent de gestion uniquement

Vous pouvez configurer l’agent de gestion pour qu’il se mette à jour lui-même ainsi que les pilotes d’E/S.

Choisissez cette approche si votre organisation exige que vous examiniez toutes les mises à jour avant de les appliquer à vos machines virtuelles Windows. Si tel est le cas, vous devez également rediriger l’agent de gestion pour qu’il obtienne ses mises à jour à partir d’un serveur interne.

  1. Désactiver les mises à jour des pilotes d’E/S via Windows Update.

  2. (Facultatif) Rediriger les mises à jour de l’agent de gestion.

Pendant l’installation :

Spécifiez cette configuration lors de la première installation des outils XenServer VM :

Programme d'installation des outils XenServer VM avec les paramètres de non-mise à jour automatique sélectionnés

Mettre à jour l’agent de gestion

XenServer vous permet de mettre à jour automatiquement l’agent de gestion sur les machines virtuelles Windows nouvelles et existantes. Par défaut, XenServer autorise la mise à jour automatique de l’agent de gestion. Vous pouvez personnaliser les paramètres de mise à jour de l’agent de gestion lors de l’installation des outils XenServer VM pour Windows. La mise à jour automatique de l’agent de gestion se déroule de manière transparente et ne redémarre pas votre machine virtuelle. Dans les scénarios où un redémarrage de la machine virtuelle est requis, un message apparaît dans l’onglet Console de la machine virtuelle, informant les utilisateurs de l’action requise.

Vous pouvez obtenir les mises à jour de l’agent de gestion automatiquement, à condition que la machine virtuelle Windows ait accès à Internet.

Gérer les mises à jour automatiques à l’aide de la CLI

XenServer vous permet d’utiliser la ligne de commande pour gérer la mise à jour automatique des pilotes d’E/S et de l’agent de gestion. Vous pouvez exécuter msiexec.exe avec les arguments listés dans le tableau suivant pour spécifier si les pilotes d’E/S et l’agent de gestion sont mis à jour automatiquement. Pour plus d’informations sur l’installation des outils XenServer VM pour Windows à l’aide de msiexec.exe, consultez Installation silencieuse.

Remarque :

Pour les machines virtuelles gérées à l’aide de PVS ou de MCS, l’agent de gestion détecte automatiquement les machines non persistantes et désactive les mises à jour automatiques sur celles-ci. Cela vous permet d’appliquer les mises à jour des outils sur l’image de référence sans affecter les machines provisionnées, et empêche les tentatives de mise à jour sur les machines virtuelles non persistantes qui seraient perdues lors de la réinitialisation.

Argument Valeurs Description
ALLOWAUTOUPDATE OUI/NON Autoriser/désactiver la mise à jour automatique de l’agent de gestion

Activer les mises à jour de l’agent de gestion

Pour activer la mise à jour automatique de l’agent de gestion par machine virtuelle :

  1. Sur la machine virtuelle, ouvrez une invite de commandes en tant qu’administrateur.

  2. Exécutez la commande suivante :

    reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate /t REG_DWORD /v DisableAutoUpdate /d 0
<!--NeedCopy-->

Pour activer la mise à jour automatique de l’agent de gestion par pool, exécutez la commande suivante dans la console de l’hôte :

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=true
<!--NeedCopy-->

Désactiver les mises à jour de l’agent de gestion

Pour désactiver la mise à jour automatique de l’agent de gestion par machine virtuelle :

  1. Sur la machine virtuelle, ouvrez une invite de commandes en tant qu’administrateur.

  2. Exécutez la commande suivante :

    reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools\AutoUpdate /t REG_DWORD /v DisableAutoUpdate /d 1
<!--NeedCopy-->

Pour désactiver la mise à jour automatique de l’agent de gestion par pool, exécutez la commande suivante dans la console de l’hôte :

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_enabled=false
<!--NeedCopy-->

Rediriger les mises à jour de l’agent de gestion

XenServer permet aux clients de rediriger les mises à jour de l’agent de gestion vers un serveur web interne avant leur installation. Cette redirection permet aux clients d’examiner les mises à jour avant qu’elles ne soient automatiquement installées sur la machine virtuelle.

L’agent de gestion utilise un fichier de mises à jour pour obtenir des informations sur les mises à jour disponibles. Le nom de ce fichier de mises à jour dépend de la version de l’agent de gestion que vous utilisez :

Nous vous recommandons fortement de passer à la dernière version de l’agent de gestion. Cependant, si vous utilisez une version plus ancienne de l’agent de gestion, nous fournissons les fichiers de mises à jour suivants à utiliser avec les versions plus anciennes :

Suivez les étapes suivantes pour rediriger les mises à jour de l’agent de gestion :

  1. Téléchargez le fichier de mises à jour.

  2. Téléchargez les fichiers MSI de l’agent de gestion référencés dans le fichier de mises à jour.

  3. Vérifiez que les hachages des fichiers MSI de l’agent de gestion correspondent à ceux référencés dans le fichier de mises à jour

  4. Chargez les fichiers MSI sur un serveur web interne auquel vos machines virtuelles peuvent accéder.

  5. Mettez à jour le fichier de mises à jour pour qu’il pointe vers les fichiers MSI sur le serveur web interne.

  6. Chargez le fichier de mises à jour sur le serveur web.

Les mises à jour automatiques peuvent également être redirigées par machine virtuelle ou par pool. Pour rediriger les mises à jour par machine virtuelle :

  1. Sur la machine virtuelle, ouvrez une invite de commandes en tant qu’administrateur.

  2. Exécutez la commande

    reg.exe ADD HKLM\SOFTWARE\XenServer\XenTools /t REG_SZ /v update_url /d \
    url of the update file on the web server
<!--NeedCopy-->

Pour rediriger la mise à jour automatique de l’Agent de gestion par pool, exécutez la commande suivante :

xe pool-param-set uuid=pooluuid guest-agent-config:auto_update_url=url of the update file on the web server
<!--NeedCopy-->

Mettre à jour les pilotes d’E/S

Vous pouvez mettre à jour les pilotes d’E/S via Windows Update ou en utilisant l’Agent de gestion. La section État de virtualisation de l’onglet Général d’une machine virtuelle dans XenCenter indique si la machine virtuelle est éligible pour recevoir des mises à jour de Windows Update. Vous pouvez également désactiver les mises à jour automatiques et gérer manuellement les mises à jour des pilotes d’E/S.

Chaque pilote d’E/S (tel que xennet, xenvif, xenvbd, xeniface et xenbus) a sa propre version. Pour plus de détails sur les dernières versions, consultez Nouveautés.

Activer les mises à jour des pilotes d’E/S via Windows Update

Pour obtenir automatiquement les mises à jour des pilotes d’E/S de Microsoft Windows Update, les conditions suivantes doivent être remplies :

  • Windows Update est activé sur la machine virtuelle.

  • La machine virtuelle a accès à Internet ou peut se connecter à un serveur proxy WSUS.

  • Vous n’exécutez pas la version Core de Windows Server, car Windows Server Core ne prend pas en charge l’utilisation de Windows Update pour installer ou mettre à jour les pilotes d’E/S.

Vous pouvez activer les mises à jour des pilotes d’E/S via Windows Update lors de la sélection d’un modèle de machine virtuelle dans l’assistant Nouvelle machine virtuelle de XenCenter. Pour plus de détails sur l’activation des mises à jour des pilotes d’E/S via Windows Update, consultez Présentation des étapes de création de machine virtuelle.

Si vous ne souhaitez pas recevoir les mises à jour des pilotes d’E/S de Windows Update, désactivez Windows Update sur votre machine virtuelle ou spécifiez une stratégie de groupe.

Désactiver les mises à jour des pilotes d’E/S via Windows Update

Vous pouvez désactiver les mises à jour des pilotes d’E/S via Windows Update pour les machines virtuelles nouvelles et existantes :

  • Pour les nouvelles machines virtuelles : Lors de la création d’une nouvelle machine virtuelle à l’aide de l’assistant Nouvelle machine virtuelle dans XenCenter, vous pouvez désactiver les mises à jour automatiques des pilotes d’E/S en définissant un indicateur. Ceci est particulièrement important pour les cibles Citrix Provisioning ou les machines de réinitialisation au démarrage, où la désactivation des mises à jour automatiques assure la stabilité. Pour plus d’informations, consultez Présentation des étapes de création de machine virtuelle et Paramètres pour les cibles Citrix Provisioning ou les machines de réinitialisation au démarrage. Pour les utilisateurs avancés qui préfèrent gérer ces paramètres à l’aide de la ligne de commande, consultez Créer une machine virtuelle Windows à l’aide de la CLI.

  • Pour les machines virtuelles existantes : Si la machine virtuelle est déjà déployée, vous pouvez désactiver les mises à jour des pilotes d’E/S en configurant une stratégie de groupe. Cela garantit que la machine virtuelle ne reçoit pas de mises à jour automatiques de Windows Update.

Définir l’agent de gestion pour mettre à jour les pilotes d’E/S

Pour plus d’informations, consultez Installer les outils XenServer VM pour Windows.

Redémarrages automatiques

Assurez-vous que tous les redémarrages de VM demandés sont terminés dans le cadre de la mise à jour. Plusieurs redémarrages peuvent être nécessaires. Si tous les redémarrages demandés ne sont pas terminés, vous risquez d’observer un comportement inattendu.

Vous pouvez définir une clé de registre qui spécifie le nombre maximal de redémarrages automatiques effectués lors de l’installation des pilotes via le Gestionnaire de périphériques ou Windows Update. Après avoir installé le pilote xenbus version 9.1.1.8 ou ultérieure, les outils XenServer VM pour Windows utilisent les directives fournies par cette clé de registre. Si vous avez une version antérieure de xenbus, vous pourriez toujours rencontrer un comportement inattendu. Si cela se produit, redémarrez la VM depuis XenCenter.

Pour utiliser cette fonctionnalité, nous vous recommandons de définir la clé de registre suivante dès que possible : HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot. La valeur de la clé de registre doit être un entier positif. Nous vous recommandons de définir le nombre de redémarrages dans la clé de registre à 3.

Lorsque cette clé de registre est définie, les outils XenServer VM pour Windows effectuent autant de redémarrages que nécessaire pour terminer les mises à jour ou le nombre de redémarrages spécifié par la clé de registre, la valeur la plus basse étant retenue.

Avant chaque redémarrage, Windows peut afficher une alerte pendant 60 secondes pour avertir du redémarrage imminent. Vous pouvez ignorer l’alerte, mais cette action n’annule pas le redémarrage. En raison de ce délai entre les redémarrages, attendez quelques minutes après le redémarrage initial pour que le cycle de redémarrage se termine.

Remarques :

Ce paramètre est requis pour les serveurs sans tête avec des adresses IP statiques.

Cette fonctionnalité de redémarrage automatique s’applique uniquement aux mises à jour des pilotes d’E/S Windows via le Gestionnaire de périphériques ou Windows Update. Si vous utilisez l’installateur de l’agent de gestion pour déployer vos pilotes, l’installateur ignore cette clé de registre et gère les redémarrages de la VM selon ses propres paramètres.

Si, après avoir attendu que tous les redémarrages soient terminés, vous rencontrez toujours un comportement inattendu, lancez un redémarrage de la VM depuis XenCenter® pour tenter de restaurer la configuration.

Définition des redémarrages automatiques à l’aide de la ligne de commande

Sur votre VM Windows, ouvrez une invite de commandes en tant qu’administrateur et exécutez la commande suivante :

reg add HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->

Alternativement, si votre VM Windows est configurée pour autoriser l’accès à distance, vous pouvez exécuter la commande suivante à partir d’une invite de commandes d’administrateur sur un autre système :

reg add \\<windows-name>\HKLM\System\CurrentControlSet\Services\xenbus_monitor\Parameters /v Autoreboot /t REG_DWORD /d <number-of-reboots>
<!--NeedCopy-->

Pour plus d’informations, consultez la commande Windows reg add.

Définition des redémarrages automatiques à l’aide de l’Éditeur du Registre

  1. Dans le menu Démarrer de Windows, ouvrez l’Éditeur du Registre et accédez à la clé : HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters​.
  2. Créez une nouvelle sous-clé de type REG_DWORD avec le nom : Autoreboot.
  3. Définissez la valeur de Autoreboot sur un entier, par exemple, 3.

Autres configurations et requêtes

Rechercher la version du pilote d’E/S

Pour connaître la version des pilotes d’E/S installés sur la machine virtuelle :

  1. Accédez à C:\Windows\System32\drivers.

  2. Localisez le pilote dans la liste.

  3. Cliquez avec le bouton droit sur le pilote et sélectionnez Propriétés, puis Détails.

    Le champ Version du fichier affiche la version du pilote installé sur la machine virtuelle.

Rechercher la version de l’agent de gestion

Pour connaître la version de l’agent de gestion installé sur la machine virtuelle :

  1. Accédez à C:\Program Files\XenServer\XenTools.

  2. Cliquez avec le bouton droit sur XenGuestAgent dans la liste, puis cliquez sur Propriétés, puis sur Détails.

    Le champ Version du fichier affiche la version de l’agent de gestion installé sur la machine virtuelle.

Modifications de comportement dans la version 9.6.0.19

À partir de XenServer VM Tools pour Windows 9.6.0.19, le comportement d’activation des périphériques a été modifié pour améliorer la fiabilité lorsque le paramètre has-vendor-device de la machine virtuelle change.

XenServer VM Tools pour Windows désormais :

  • Utilise l’activation de périphérique basée sur la priorité
  • Gère automatiquement les modifications de configuration
  • Utilise des identifiants de périphérique enfant cohérents lors des transitions de périphérique
  • Passe automatiquement au périphérique PV correct après le redémarrage

Ces améliorations sont particulièrement importantes pour les environnements MCS et PVS qui utilisent des images dorées partagées.

Aucun nettoyage manuel de périphérique ou cycle de redémarrage supplémentaire n’est requis après la modification du paramètre has-vendor-device.

Un arrêt et un redémarrage sont toujours nécessaires pour que la modification du paramètre prenne effet.

Dépannage de XenServer VM Tools pour Windows

Nous fournissons un outil, xtbugtool, qui capture les informations de diagnostic pour les XenServer VM Tools. Pour plus d’informations, consultez Dépanner les problèmes de machine virtuelle.

Changement du paramètre has-vendor-device

La modification du paramètre has-vendor-device de la VM nécessite l’arrêt et le redémarrage de la VM.

Remarque :

Il n’est pas recommandé de changer has-vendor-device une fois l’image déployée, car les images reset-on-boot reconstruisent la configuration à chaque démarrage, ce qui entraîne des modifications des configurations réseau.

Dans XenServer VM Tools pour Windows 9.6.0.19 et versions ultérieures :

  • Le bon périphérique PV est automatiquement sélectionné au démarrage
  • Les connexions backend en double sont évitées
  • Les incohérences de configuration des périphériques sont automatiquement résolues

Aucun cycle de redémarrage supplémentaire ni intervention manuelle à l’intérieur de la VM ne devrait être nécessaire après le redémarrage.

Si des versions plus anciennes de XenServer VM Tools pour Windows sont installées, des redémarrages supplémentaires ou un nettoyage manuel des périphériques pourraient encore être nécessaires.

Désinstaller XenServer VM Tools

Nous ne recommandons pas de supprimer les XenServer VM Tools de vos VM Windows. Ces outils sont nécessaires pour que vos VM Windows soient entièrement prises en charge. Leur suppression peut entraîner un comportement inattendu. Désinstallez manuellement vos XenServer VM Tools uniquement en dernier recours.

Désinstallation standard

Pour effectuer une désinstallation standard des XenServer VM Tools, vous pouvez utiliser la fonctionnalité Windows Ajouter ou supprimer des programmes :

  1. Créez un instantané de la VM avant de commencer.
  2. Dans la VM Windows, accédez à Ajouter ou supprimer des programmes.
  3. Sélectionnez XenServer VM Tools et cliquez sur Désinstaller.
  4. Redémarrez la VM.

La commande uninstall.exe

La désinstallation des XenServer VM Tools à l’aide de la fonctionnalité Windows Ajouter ou supprimer des programmes appelle le fichier <tools-install-directory>\uninstall.exe pour effectuer les actions de désinstallation. Vous pouvez également choisir d’appeler cette commande à partir d’un terminal PowerShell ou d’une invite de commandes avec des privilèges d’administrateur.

  1. Créez un instantané de la VM avant de commencer.
  2. En tant qu’administrateur, ouvrez une invite de commandes ou un terminal PowerShell.
  3. Exécutez la commande <tools-install-directory>\uninstall.exe.
  4. Redémarrez la VM.

Options de commande

La commande uninstall.exe accepte les paramètres suivants :

  • help - Affiche les informations d’utilisation de la commande.
  • log - Génère un fichier journal qui indique ce que la commande a fait.
  • verbose - Affiche sur la console ce que la commande a fait.
  • disable - Désactive les pilotes installés par le programme d’installation MSI.
  • force-disable - Désactive les pilotes dans toutes les situations.
  • hidden - Supprime les périphériques cachés. Ces périphériques sont inutilisés et ont été remplacés, mais peuvent avoir laissé des entrées de registre obsolètes.
  • cleanup - Supprime les anciens désinstallateurs de Ajout/Suppression de programmes. Ces désinstallateurs peuvent inclure des entrées en double provenant d’anciennes versions des outils.
  • purge - (9.3.1 et versions ultérieures) Réinitialise la VM à un état propre, tel qu’elle était avant l’installation de toute partie des XenServer VM Tools. Pour plus d’informations, consultez Désinstallation complète de tous les composants des XenServer VM Tools.
  • install - (9.3.1 et versions ultérieures) Installe l’ensemble actuel de pilotes d’E/S et invite à redémarrer la VM si nécessaire.
  • reboot - Redémarre la VM une fois que toutes les autres opérations de commande sont terminées.

Désinstallation complète de tous les composants des XenServer VM Tools

La dernière version des XenServer VM Tools pour Windows (9.3.1 et versions ultérieures) inclut la commande uninstall.exe purge. L’option purge de l’application uninstall.exe réinitialise une VM à l’état où elle se trouvait avant l’installation des pilotes d’E/S. Si vous rencontrez des problèmes lors de la mise à niveau de vos outils vers une version plus récente ou si vous avez besoin d’un état propre pour installer un ensemble d’outils ultérieur sur votre VM, utilisez cet utilitaire.

  1. Créez un instantané de la VM avant de commencer.
  2. En tant qu’administrateur, ouvrez une invite de commandes ou un terminal PowerShell.
  3. Exécutez la commande <tools-install-directory>\uninstall.exe purge verbose
  4. Redémarrez la VM.

Après avoir utilisé cette commande, vous n’avez pas besoin d’effectuer de nettoyage manuel comme vous auriez pu le faire avec les versions précédentes des XenServer VM Tools. Toutes les modifications liées aux XenServer VM Tools ont été supprimées.

Que supprime l’option purge ?

Si vous utilisez la commande uninstall.exe purge, toutes les traces des XenServer VM Tools sont supprimées de votre VM Windows. La liste des actions effectuées par cette commande est la suivante :

  • Services :
    • Désactive tous les services XenServer VM Tools, ce qui empêche les pilotes et services installés de démarrer au redémarrage.
    • Arrête tous les services XenServer VM Tools en cours d’exécution.
  • Pilotes :
    • Désinstalle les pilotes d’E/S de tous les nœuds de périphérique.
    • Désinstalle les périphériques cachés. Cette action est la même que celle effectuée par l’option de ligne de commande hidden.
    • Désinstalle les packages de pilotes mis en cache, ce qui les supprime du magasin de pilotes. Par conséquent, les pilotes d’E/S ne sont pas automatiquement réinstallés.
  • Registre :
    • Supprime les informations de registre obsolètes utilisées par les versions de pilotes non prises en charge.
    • Supprime les clés liées aux outils de HKLM\System\CurrentControlSet\Control\Class\...
    • Supprime les clés liées aux outils de HKLM\System\CurrentControlSet\Services.
    • Supprime les clés liées aux outils de HKLM\System\CurrentControlSet\Enum\...
  • Fichiers :
    • Supprime tous les fichiers de pilotes XenServer VM Tools de C:\Windows\System32 et C:\Windows\System32\drivers.
    • Supprime les fichiers INF de XenServer VM Tools de C:\Windows\INF.
    • Supprime tous les fichiers obsolètes laissés par les versions non prises en charge des outils de C:\Program Files\Citrix\XenTools et C:\Program Files\XenServer\XenTools.
  • Autre :
    • Supprime les anciennes entrées dans Ajout/Suppression de programmes. Cette action est la même que celle effectuée par l’option de ligne de commande cleanup.
    • Efface certaines informations d’état obsolètes de l’InstallAgent.
    • Supprime xenfilt.sys des filtres supérieurs. Cette modification empêche xenfilt.sys de se charger sur les nœuds de pilote.
    • Supprime les clés unplug, ce qui entraîne le retour de la VM aux périphériques émulés au redémarrage.
    • Supprime le StartOverride de StorNvme. Cette modification force stornvme.sys à démarrer au démarrage et permet aux périphériques de démarrage NVMe (UEFI) émulés de fonctionner.

Bonnes pratiques

Version recommandée pour les déploiements MCS et PVS

Utilisez XenServer VM Tools pour Windows 9.6.0.19 ou version ultérieure pour les environnements où les VM passent de has-vendor-device=true à has-vendor-device=false.

Cette version améliore la fiabilité de la transition des périphériques PV et réduit les incohérences de configuration pour les déploiements d’images dorées partagées.

Nouveautés

La version des XenServer VM Tools pour Windows est mise à jour indépendamment de la version de XenServer. Assurez-vous que vos XenServer VM Tools pour Windows sont régulièrement mis à jour vers la dernière version, à la fois dans vos VM et dans tous les modèles que vous utilisez pour créer vos VM.

La dernière version des XenServer VM Tools pour Windows est disponible sur la page de téléchargements de XenServer.

XenServer VM Tools pour Windows 9.6.0

Publié le 13 mai 2026

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.6.0
  • Agent de gestion 9.6.0.12
  • xenbus version 9.1.13.23
  • xeniface version 9.1.14.6
  • xennet version 9.1.8.6
  • xenvbd version 9.1.11.5
  • xenvif version 9.1.15.8

Modifications dans la version 9.6.0

  • Résilience améliorée aux modifications de configuration de la VM.

  • Notifications améliorées de l’icône de la barre d’état système.

Corrigé dans la version 9.6.0

  • Correction d’un problème où le trafic réseau RSS n’était pas distribué entre les processeurs.

  • Correction d’un bugcheck lors de la mise à jour des XenServer VM Tools pour Windows, dans certaines configurations.

Versions antérieures

9.4.2

Publié le 24 sept. 2025

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.4.2
  • Agent de gestion 9.3.2.95
  • Bus Xen 9.1.12.120
  • Interface Xen 9.1.13.96
  • xennet 9.1.7.65
  • xenvbd 9.1.10.84
  • Version xenvif 9.1.14.109

Modifications dans la version 9.4.2

  • Options d’installation simplifiées
  • Icône de la barre d’état système, fournissant des notifications pour les XenServer VM Tools pour Windows

Cette version inclut également des mises à jour pour la collecte de télémétrie.

Correctifs dans la version 9.4.2

  • Distribution améliorée de la charge de travail réseau sur les processeurs

9.4.1

Publié le 27 mai 2025

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.4.1
  • Agent de gestion : 9.3.1.80
  • xenbus : 9.1.11.115
  • xeniface : 9.1.12.94
  • xennet : 9.1.7.65
  • xenvbd : 9.1.9.82
  • xenvif : 9.1.13.107

Tous les clients concernés par les problèmes décrits dans CTX692748 - Bulletin de sécurité XenServer et Citrix Hypervisor doivent effectuer une mise à jour vers cette version des outils ou une version ultérieure.

Cette version inclut également des mises à jour de la télémétrie collectée.

Problèmes résolus dans la version 9.4.1

Cette version contient des correctifs pour les problèmes suivants :

  • Dans certains cas, avec les XenServer VM Tools 9.4.0 installés, Windows 11 ne peut pas être mis à niveau de 23H2 vers 24H2.
  • L’agent de gestion peut parfois planter lors du redémarrage ou du démarrage de la VM.
  • Certaines VM Windows peuvent subir des redémarrages forcés inattendus.

9.4.0

Publié le 22 octobre 2024

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.4.0
  • Agent de gestion : 9.3.0.65
  • xenbus : 9.1.9.105
  • xeniface : 9.1.10.87
  • xennet : 9.1.7.65
  • xenvbd : 9.1.8.79
  • xenvif : 9.1.12.101

Cette version contient des correctifs pour les problèmes suivants :

  • La version des XenServer VM Tools pour Windows n’est pas correctement signalée à Citrix Hypervisor™ car l’agent de gestion vérifie la valeur InstallStatus incorrecte dans le registre.
  • En raison d’une gestion incomplète des clés de registre StartOverride de StorNvme, vous pourriez rencontrer un écran bleu de la mort (BSOD) avec l’erreur “Inaccessible Boot Device” après le redémarrage de votre VM Windows lors d’une mise à jour des XenServer VM Tools via Windows Update.
  • Parfois, lors de la mise à jour des XenServer VM Tools pour Windows, les paramètres d’adresse IP statique sont perdus et les paramètres réseau passent en DHCP. Ce problème est résolu si vous effectuez une mise à jour à partir de la version 9.3.3 ou ultérieure (par exemple, de 9.4.0 vers une version plus récente). Cependant, si vous effectuez une mise à jour à partir d’une version antérieure à 9.3.3 (par exemple, de 9.3.2 vers 9.4.0), le problème se produira une fois pendant la mise à jour, mais n’affectera pas les futures mises à jour. Pour plus d’informations, consultez l’article de support Perte d’IP statique lors de la mise à jour vers VM Tools pour Windows 9.3.3 ou version antérieure.

Cette version contient les problèmes connus suivants :

  • Si vous comptez sur l’Agent de gestion pour les mises à jour automatiques, vous devez effectuer une mise à jour manuelle vers la version 9.4.0 ou ultérieure, car la version 9.3.3 ne se met pas à jour automatiquement vers la version 9.4.0 en raison de problèmes de vérification de certificat. Pour résoudre ce problème, installez manuellement les XenServer VM Tools pour Windows 9.4.0 ou une version plus récente sur chaque VM.

9.3.3

Publié le 4 juin 2024

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.3.3
  • Agent de gestion : 9.2.3.60
  • xenbus : 9.1.8.88
  • xeniface : 9.1.9.78
  • xennet : 9.1.6.60
  • xenvbd : 9.1.7.66
  • xenvif : 9.1.11.92

Cette version inclut des correctifs pour les problèmes suivants :

  • Parfois, l’agent de gestion peut planter avec une ManagementException lorsque la VM est fortement sollicitée.
  • Sur les serveurs Windows 2022, un seul vCPU peut consommer 100 % du CPU. En conséquence, le serveur ne répond plus.
  • Les VM Windows hébergées dans un pool qui utilise la mise en réseau OpenVSwitch et des trames Ethernet étiquetées VLAN peuvent avoir une connectivité réseau incohérente.

9.3.2

Publié le 27 novembre 2023

Cette version renomme les outils VM Citrix® en outils VM XenServer.

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.3.2
  • Agent de gestion : 9.2.2.435
  • xenbus : 9.1.7.80
  • xeniface : 9.1.8.69
  • xennet : 9.1.5.51
  • xenvbd : 9.1.6.58
  • xenvif : 9.1.10.83

Cette version contient également les améliorations suivantes :

  • Améliorations de la commande uninstall.exe.
  • Modifications pour permettre à certaines machines virtuelles Windows d’utiliser jusqu’à 64 vCPU lorsque votre version de XenServer et le système d’exploitation Windows le prennent en charge.

Cette version inclut un correctif pour le problème suivant :

  • Parfois, lors de l’installation des outils XenServer VM Tools, une erreur non fatale peut entraîner l’échec de l’installation.

9.3.1

Publié le 25 janvier 2023

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.3.1
  • Agent de gestion : 9.2.1.35
  • xenbus : 9.1.5.54
  • xeniface : 9.1.5.42
  • xennet : 9.1.3.34
  • xenvbd : 9.1.4.37
  • xenvif : 9.1.8.58

Cette version inclut les améliorations suivantes :

  • Améliorations de l’utilitaire uninstall.exe, y compris le paramètre purge. Pour plus d’informations, consultez Désinstaller les outils XenServer VM.
  • Améliorations générales de l’installateur des outils XenServer VM.
  • Améliorations générales de la gestion des chaînes de clés de registre.

Cette version contient des correctifs pour les problèmes suivants :

  • Parfois, lorsque les outils XenServer VM sont mis à jour via Windows Update, les paramètres IP statiques sont perdus et les paramètres réseau passent en DHCP.
  • Sur les machines virtuelles Windows, les tables d’octroi peuvent facilement être épuisées. Lorsque cela se produit, les requêtes de lecture et d’écriture peuvent échouer ou des VIF supplémentaires ne sont pas activés correctement et ne démarrent pas.
  • Dans de rares occasions, lors de la mise à niveau des outils XenServer VM pour Windows, l’agent de gestion existant peut ne pas s’arrêter et empêcher la mise à niveau de réussir.
  • Sur une machine virtuelle Windows, vous pourriez voir à la fois la version précédente et une version ultérieure des outils ou de l’agent de gestion répertoriées dans vos programmes installés.
    • (PRÉCÉDENT) Citrix XenServer Windows Management Agent
    • (ULTÉRIEUR) Outils PV Citrix Hypervisor.

    Après la mise à jour vers la dernière version des outils, aucun de ces noms précédents n’est répertorié. Seuls les outils XenServer VM sont répertoriés dans vos programmes installés.

9.3.0

Publié le 26 juillet 2022

Cet ensemble d’outils contient les versions de composants suivantes :

  • Installateur : 9.3.0
  • Agent de gestion : 9.2.0.27
  • xenbus : 9.1.4.49
  • xeniface : 9.1.4.34
  • xennet : 9.1.3.34
  • xenvbd : 9.1.3.33
  • xenvif : 9.1.6.52

Cette version inclut les améliorations suivantes :

  • Améliorations générales de l’installateur des outils XenServer VM.

Cette version contient des correctifs pour les problèmes suivants :

  • Un logiciel de sécurité bloquait l’exposition au système d’exploitation des disques secondaires marqués comme amovibles, en tant que mesure de prévention de l’exfiltration de données. Cette mise à jour vous permet de marquer un VBD comme non amovible et de le faire exposer correctement via le système d’exploitation.
  • Sur une VM Windows, l’adresse IP d’une VIF SR-IOV n’est parfois pas visible dans XenCenter.

9.2.3

Publié le 28 avril 2022

Cet ensemble d’outils contient les versions de composants suivantes :

  • Installateur : 9.2.3
  • Agent de gestion : 9.1.1.13
  • xenbus : 9.1.3.30
  • xeniface : 9.1.4.34
  • xennet :
    • 9.1.1.8 (pour Windows Server 2012 et Windows Server 2012 R2)
    • 9.1.2.23 (pour tous les autres systèmes d’exploitation Windows pris en charge)
  • xenvbd : 9.1.2.20
  • xenvif : 9.1.5.48

Cette version contient des correctifs pour les problèmes suivants :

  • Dans XenServer VM Tools for Windows version 9.2.2, les options de synchronisation de l’heure ne sont pas disponibles.
  • Une condition de concurrence peut entraîner l’affichage d’un écran bleu d’erreur sur les machines virtuelles Windows après une migration en direct sur Citrix Hypervisor 8.2 Cumulative Update 1.
  • Les machines virtuelles Windows sur lesquelles la version 9.2.1 ou 9.2.2 de XenServer VM Tools est installée et qui sont des cibles PVS peuvent parfois se figer avec un écran noir. Le message « Guest Rx stalled » est présent dans les journaux du noyau dom0. Ce problème se produit plus souvent sur les coordinateurs de pool que sur les autres membres du pool.
  • Sur les machines virtuelles Windows avec plus de 8 vCPU, la mise à l’échelle côté réception pourrait ne pas fonctionner car le pilote xenvif ne parvient pas à configurer la table d’indirection.

9.2.2

Publié le 14 janvier 2022

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.2.2
  • Agent de gestion : 9.1.1.13
  • xenbus : 9.1.3.30
  • xeniface : 9.1.2.22
  • xennet :
    • 9.1.1.8 (pour Windows Server 2012 et Windows Server 2012 R2)
    • 9.1.2.23 (pour tous les autres systèmes d’exploitation Windows pris en charge)
  • xenvbd : 9.1.2.20
  • xenvif : 9.1.3.31

Cette version contient des correctifs pour les problèmes suivants :

  • Lors d’une mise à jour des outils, le pilote xenbus peut demander un redémarrage avant la fin de l’installation du pilote. Accepter le redémarrage peut provoquer une erreur d’écran bleu dans votre machine virtuelle Windows.
  • Lors de la compression des informations de diagnostic collectées, l’outil de diagnostic xt-bugtool expire après 20 secondes. Ce comportement peut entraîner la création incorrecte du fichier zip de diagnostic.
  • Le partage du presse-papiers VNC ne fonctionne pas.
  • Les versions précédentes des pilotes n’ont pas été publiées via Windows Update.

9.2.1

Publié le 24 juin 2021

Cet ensemble d’outils contient les versions de composants suivantes :

  • Programme d’installation : 9.2.1
  • Agent de gestion : 9.1.0.10
  • xenbus : 9.1.2.14
  • xeniface : 9.1.1.11
  • xennet : 9.1.1.8
  • xenvbd : 9.1.1.8
  • xenvif : 9.1.2.16

Remarque :

Cet ensemble de pilotes n’a pas été fourni via Windows Update.

Cette version contient des correctifs pour les problèmes suivants :

  • Dans certains cas, l’état Ordinateur portable/Tablette de la VM ne peut pas être modifié.
  • Après le redémarrage d’une VM, celle-ci peut parfois commencer à envoyer un nombre excessif de messages de journalisation au fichier daemon.log.
  • Une condition de concurrence dans les dépendances de chargement des pilotes après une mise à niveau du système d’exploitation peut empêcher la mise à niveau des XenServer VM Tools.
  • Une erreur de stockage peut provoquer le blocage des machines virtuelles Windows.
  • Parfois, l’adresse IP d’un VIF SR-IOV n’est pas visible dans XenCenter. Pour résoudre le problème, redémarrez l’agent de gestion depuis le gestionnaire de services de la machine virtuelle.
  • Sous une charge réseau et système élevée et avec des ressources faibles, les machines virtuelles peuvent rencontrer des erreurs fatales dans les pilotes Citrix et tiers, généralement avec le code IRQL_NOT_LESS_OR_EQUAL. Ce correctif améliore la mise en mémoire tampon réseau pour éviter ces erreurs fatales.
  • La mise à niveau des pilotes d’E/S Windows peut empêcher les machines virtuelles UEFI de démarrer, en signalant « 0xC000000E. Un périphérique requis n’est pas connecté ou n’est pas accessible. »
  • Un problème peut survenir lors de l’installation des XenServer VM Tools après la désinstallation d’une version précédente des XenServer VM Tools, qui renvoie le message d’erreur suivant : « Ce périphérique ne peut pas démarrer (code 10) (Opération échouée) L’opération demandée a échoué ».
XenServer® VM Tools pour Windows
August 1, 2026
Contributeur: 
X
August 1, 2026
Contributeur: 
X

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.