Citrix Hypervisor

Citrix VM Tools für Windows

Citrix VM Tools für Windows bieten Hochleistungs-E/A-Dienste ohne den Aufwand herkömmlicher Geräteemulation. Citrix VM Tools für Windows bestehen aus I/O-Treibern (auch bekannt als paravirtualisierte Treiber oder PV-Treiber) und dem Management Agent.

Citrix VM Tools für Windows müssen auf jeder Windows-VM installiert sein, damit die VM über eine vollständig unterstützte Konfiguration verfügt. Eine VM funktioniert ohne sie, aber die Leistung wird beeinträchtigt.

Die Version der Citrix VM Tools for Windows wird unabhängig von der Version von Citrix Hypervisor aktualisiert. Stellen Sie sicher, dass Ihre Citrix VM Tools for Windows regelmäßig auf die neueste Version aktualisiert werden, sowohl in Ihren VMs als auch in allen Vorlagen, die Sie zum Erstellen Ihrer VMs verwenden. Weitere Informationen zur neuesten Version der Tools finden Sie unter Updates für Citrix VM Tools für Windows oder Was ist neu.

Installieren Sie Citrix VM Tools

Hinweis:

Um Citrix VM Tools for Windows auf einer Windows-VM zu installieren, muss auf der VM Microsoft .NET Framework Version 4.0 oder höher ausgeführt werden.

Stellen Sie vor der Installation der Citrix VM Tools für Windows sicher, dass Ihre VM für den Empfang der E/A-Treiber von Windows Update konfiguriert ist. Windows Update ist die empfohlene Methode, um Updates für die I/O-Treiber zu erhalten. Wenn Windows Update jedoch keine verfügbare Option für Ihre VM ist, können Sie auch Aktualisierungen der E/A-Treiber über den Management Agent erhalten oder die Treiber manuell aktualisieren. Weitere Informationen finden Sie unter Aktualisieren der I/O-Treiber.

So installieren Sie Citrix VM Tools für Windows:

  1. Wir empfehlen, dass Sie einen Snapshot Ihrer VM erstellen, bevor Sie die Citrix VM Tools installieren oder aktualisieren.

  2. Laden Sie die Datei Citrix VM Tools für Windows von der Citrix Hypervisor Downloadseite herunter.

    1. Melden Sie sich bei Ihrem Citrix-Konto an, um auf die herunterladbaren Dateien zuzugreifen.
    2. Erweitern Sie die Produktabschnitte auf der Citrix Hypervisor-Downloadseite und klicken Sie auf eine beliebige unterstützte Version von Citrix Hypervisor.
    3. Gehen Sie auf der Produktseite zum Abschnitt Citrix Hypervisor Main Components.

      Die Citrix VM Tools für Windows sind in einer 32-Bit- und einer 64-Bit-Version verfügbar.

    4. Laden Sie die MSI-Datei herunter und überprüfen Sie Ihren Download anhand des angegebenen SHA256-Werts.
  3. Kopieren Sie die Datei auf Ihre Windows-VM oder auf ein freigegebenes Laufwerk, auf das die Windows-VM zugreifen kann.

  4. Führen Sie die Datei managementagentxXX.msi aus, um mit der Installation von Citrix VM Tools zu beginnen.

    Msiexec.exe /package managementagentxXX.msi
    
  5. Befolgen Sie die Anweisungen im Installationsprogramm.

    • Folgen Sie den Anweisungen des Assistenten, um die Lizenzvereinbarung zu akzeptieren, und wählen Sie einen Zielordner aus.

    • Passen Sie die Einstellungen auf der Seite Einstellungen für Installation und Updates an. Der Citrix Hypervisor Windows Management Agent Setup-Assistent zeigt die empfohlenen Einstellungen an. Standardmäßig zeigt der Assistent die folgenden Einstellungen an:

      • Installieren Sie jetzt I/O-Treiber
      • Automatische Aktualisierungen des Verwaltungsagenten zulassen
      • Verhindern Sie automatische I/O-Treiber-Updates durch den Verwaltungsagenten
      • Anonyme Nutzungsinformationen an Citrix senden

      Wenn Sie die automatische Aktualisierung des Management Agents nicht zulassen möchten, wählen Sie Automatische Management-Agent-Updates nicht zulassen aus der Liste aus.

      Wenn Sie möchten, dass der Management Agent die I/O-Treiber automatisch aktualisiert, wählen Sie Automatische I/O-Treiberaktualisierungen durch den Management-Agenten zulassenaus. Wir empfehlen jedoch, dass Sie Windows Update verwenden, um die I/O-Treiber zu aktualisieren, nicht den Management Agent.

      Hinweis:

      Wenn Sie ausgewählt haben, I/O-Treiberaktualisierungen über den Windows Update-Mechanismus zu erhalten, erlauben Sie dem Management Agent nicht, die E/A-Treiber automatisch zu aktualisieren.

      Wenn Sie keine anonymen Nutzungsinformationen mit Citrix teilen möchten, deaktivieren Sie das Kontrollkästchen Anonyme Nutzungsinformationen an Citrix senden . Die an Citrix übertragenen Informationen enthalten die UUID der VM, die das Update anfordert. Es werden keine weiteren Informationen in Bezug auf die VM gesammelt oder an Citrix übertragen.

    • Klicken Sie auf Weiter und dann auf Installieren, um den Installationsvorgang der Citrix VM Tools für Windows zu starten.

  6. Starten Sie die VM neu, wenn Sie aufgefordert werden, den Installationsvorgang abzuschließen.

Hinweis:

Die Citrix VM Tools für Windows können einen Neustart mit /quiet /norestart anfordern oder /quiet /forcerestart angeben, nachdem die VM bereits einmal im Rahmen der Installation neu gestartet wurde.

E/A-Treiber werden automatisch auf einer Windows-VM installiert, die Updates von Windows Update erhalten kann. Wir empfehlen jedoch, dass Sie die Citrix VM Tools für Windows installieren, um den Management Agent zu installieren und eine unterstützte Konfiguration beizubehalten.

Kunden, die die Citrix VM Tools für Windows oder den Management Agent über RDP installieren, sehen die Neustartaufforderung möglicherweise nicht, da sie nur in der Windows-Konsolensitzung angezeigt wird. Um sicherzustellen, dass Sie Ihre VM neu starten (falls erforderlich) und um Ihre VM in einen optimierten Zustand zu versetzen, geben Sie die Option Neustart erzwingen in RDP an. Die Option Neustart erzwingen startet die VM nur dann neu, wenn sie erforderlich ist, um die VM in einen optimierten Zustand zu versetzen.

Automatische Installation

Führen Sie einen der folgenden Befehle aus, um die Citrix VM Tools für Windows im Hintergrund zu installieren und den Neustart des Systems zu verhindern:

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

oder

Setup.exe /quiet /norestart
<!--NeedCopy-->

Eine nicht interaktive, aber nicht stille Installation kann erhalten werden, indem Sie Folgendes ausführen:

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

Oder

Setup.exe /passive
<!--NeedCopy-->

Um die Installationseinstellungen anzupassen, verwenden Sie die folgenden Parameter mit den Befehlen für die unbeaufsichtigte Installation:

Parameter Zulässige Werte Standard Beschreibung
ALLOWAUTOUPDATE JA oder NEIN JA Automatische Aktualisierungen des Verwaltungsagenten zulassen
ALLOWDRIVERINSTALL JA oder NEIN JA Installieren Sie jetzt die I/O-Treiber
ALLOWDRIVERUPDATE JA oder NEIN NEIN Erlauben Sie den automatischen Management-Agent-Updates, aktualisierte Treiber zu installieren
IDENTIFYAUTOUPDATE JA oder NEIN JA Anonyme Nutzungsinformationen an Citrix senden

Führen Sie beispielsweise einen der folgenden Befehle aus, um eine unbeaufsichtigte Installation der Tools durchzuführen, die zukünftige automatische Management-Agent-Updates nicht zulassen und keine anonymen Informationen an Citrix senden:

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

Bei interaktiven, unbeaufsichtigten und passiven Installationen kann es nach dem nächsten Systemneustart zu mehreren automatisierten Neustarts kommen, bevor die Citrix VM Tools für Windows vollständig installiert sind. Dieses Verhalten ist auch bei Installationen mit dem angegebenen Flag /norestart der Fall. Bei Installationen, bei denen das Flag /norestart bereitgestellt wird, kann der erste Neustart jedoch manuell eingeleitet werden.

Die Citrix VM Tools für Windows werden standardmäßig im Verzeichnis C:\Program Files\Citrix\XenTools auf der VM installiert.

Hinweise:

  • Um Citrix VM Tools for Windows auf einer Windows-VM zu installieren, muss auf der VM Microsoft .NET Framework Version 4.0 oder höher ausgeführt werden.
  • Der Parameter /quiet gilt nur für die Installationsdialoge, aber nicht für die Installation des Gerätetreibers. Wenn der Parameter /quiet angegeben ist, fordert die Gerätetreiberinstallation bei Bedarf die Berechtigung zum Neustart an.
    • Wenn /quiet /norestart angegeben ist, wird das System nicht neu gestartet, nachdem die gesamte Tools-Installation abgeschlossen ist. Dieses Verhalten ist unabhängig davon, was der Benutzer im Reboot-Dialog angibt.
    • Wenn /quiet /forcerestart angegeben ist, wird das System neu gestartet, nachdem die gesamte Tools-Installation abgeschlossen ist. Dieses Verhalten ist unabhängig davon, was der Benutzer im Reboot-Dialog angibt.
    • Wenn die Gerätetreiberinstallation die Berechtigung zum Neustart anfordert, kann eine Tools-Installation mit dem angegebenen Parameter quiet weiterhin ausgeführt werden. Verwenden Sie den Task-Manager, um zu überprüfen, ob das Installationsprogramm noch läuft.

Warnung:

Das Installieren oder Aktualisieren der Citrix VM Tools für Windows kann dazu führen, dass sich der Anzeigename und die Kennung einiger Netzwerkadapter ändern. Jede Software, die für die Verwendung eines bestimmten Adapters konfiguriert ist, muss möglicherweise nach der Installation oder dem Upgrade von Citrix VM Tools für Windows neu konfiguriert werden.

Aktualisieren der Citrix VM Tools für Windows

Citrix Hypervisor verfügt über einen einfacheren Mechanismus zum automatischen Aktualisieren von E/A-Treibern (PV-Treiber) und den Management Agent für Windows-VMs. Dieser Mechanismus ermöglicht es Kunden, Updates zu installieren, sobald sie verfügbar sind.

Stellen Sie sicher, dass Ihre Citrix VM Tools for Windows regelmäßig auf die neueste Version aktualisiert werden, sowohl in Ihren VMs als auch in allen Vorlagen, die Sie zum Erstellen Ihrer VMs verwenden.

Wir empfehlen, dass Sie einen Snapshot Ihrer VM erstellen, bevor Sie die Citrix VM Tools installieren oder aktualisieren.

Wichtig:

Wenn Sie derzeit die 8.2.x.x-Treiber oder früher verwenden und die Management Agent-MSI-Datei verwenden möchten, um auf die neueste Version der Treiber zu aktualisieren, müssen Sie Device Manager verwenden, um die 8.2.x.x-Treiber von Ihrer VM zu deinstallieren, bevor Sie diese Treiber installieren. Wenn Sie diesen Schritt nicht abschließen, schlägt der MSI-Installationsvorgang fehl.

Wir empfehlen, die folgenden Einstellungen zum Aktualisieren der verschiedenen Komponenten der Citrix VM Tools für Windows zu verwenden:

  1. Stellen Sie den Wert des folgenden Registrierungsschlüssels auf einen REG_DWORD-Wert von ‘3’ ein: HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot
  2. Stellen Sie sicher, dass Ihre VM so konfiguriert ist, dass sie I/O-Treiber von Windows Update empfängt.
  3. Konfigurieren Sie den Management Agent so, dass er sich automatisch aktualisiert.

Der Abschnitt Virtualisierungsstatus auf der Registerkarte Allgemein einer VM in XenCenter gibt an, ob die VM Updates von Windows Update empfangen kann. Der Mechanismus zum Empfangen von E/A-Treiberupdates von Windows Update ist standardmäßig aktiviert. Wenn Sie keine I/O-Treiberupdates von Windows Update erhalten möchten, deaktivieren Sie Windows Update auf Ihrer VM oder geben Sie eine Gruppenrichtlinie an.

Wichtig:

Stellen Sie sicher, dass alle angeforderten VM-Neustarts im Rahmen des Updates abgeschlossen sind. Möglicherweise sind mehrere Neustarts erforderlich. Wenn alle angeforderten Neustarts nicht abgeschlossen sind, kann dies zu unerwartetem Verhalten führen.

Die folgenden Abschnitte enthalten Informationen zum automatischen Aktualisieren der I/O-Treiber und des Management Agents.

Aktualisieren Sie die I/O-Treiber

Sie können I/O-Treiber-Updates automatisch von Microsoft Windows Update erhalten, vorausgesetzt:

  • Sie führen Citrix Hypervisor 8.2 Premium Edition aus oder haben Zugriff auf Citrix Hypervisor über die Berechtigung Citrix Virtual Apps and Desktops oder Citrix DaaS-Berechtigung.

  • Sie haben eine Windows-VM mit XenCenter erstellt, das mit Citrix Hypervisor 8.2 ausgestellt wurde

  • Windows Update ist innerhalb der VM aktiviert

  • Die VM hat Zugriff auf das Internet oder kann eine Verbindung zu einem WSUS-Proxyserver herstellen.

Hinweis:

Windows Server Core unterstützt nicht die Verwendung von Windows Update zum Installieren oder Aktualisieren der I/O-Treiber. Verwenden Sie stattdessen das Installationsprogramm für Citrix VM Tools für Windows, das auf der Citrix Hypervisor-Downloadseite verfügbar ist. Die Citrix VM Tools sind als herunterladbare Komponente unter allen unterstützten Versionen von Citrix Hypervisor verfügbar. Sie müssen sich bei Ihrem Citrix-Konto anmelden, um auf diese Downloads zugreifen zu können.

Kunden können E/A-Treiber-Updates auch automatisch über den automatischen Management-Agent-Aktualisierungsmechanismus erhalten. Sie können diese Einstellung während der Installation von Citrix VM Tools für Windows konfigurieren. Weitere Informationen finden Sie unter Installieren von Citrix VM Tools für Windows.

Automatischer Neustart

Stellen Sie sicher, dass alle angeforderten VM-Neustarts im Rahmen des Updates abgeschlossen sind. Möglicherweise sind mehrere Neustarts erforderlich. Wenn alle angeforderten Neustarts nicht abgeschlossen sind, tritt möglicherweise ein unerwartetes Verhalten auf.

Sie können einen Registrierungsschlüssel festlegen, der die maximale Anzahl automatischer Neustarts angibt, die bei der Installation der Treiber über den Geräte-Manager oder Windows Update durchgeführt werden. Nachdem Sie die Xenbus-Treiberversion 9.1.1.8 oder höher installiert haben, verwenden die Citrix VM Tools für Windows die von diesem Registrierungsschlüssel bereitgestellte Anleitung.

Um diese Funktion zu nutzen, Wir empfehlen, dass Sie so schnell wie möglich den folgenden Registrierungsschlüssel festlegen: HLKM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot. Der Wert des Registrierungsschlüssels muss eine positive Ganzzahl sein. Es wird empfohlen, die Anzahl der Neustarts im Registrierungsschlüssel auf 3 festzulegen.

Wenn dieser Registrierungsschlüssel festgelegt ist, führen die Citrix VM Tools für Windows so viele Neustarts durch, wie erforderlich sind, um die Updates oder die Anzahl der durch den Registrierungsschlüssel angegebenen Neustarts abzuschließen - je nachdem, welcher Wert niedriger ist.

Vor jedem Neustart kann Windows 60 Sekunden lang eine Warnung anzeigen, die vor dem bevorstehenden Neustart warnt. Sie können die Warnung verwerfen, aber diese Aktion bricht den Neustart nicht ab. Warten Sie aufgrund dieser Verzögerung zwischen den Neustarts einige Minuten nach dem ersten Neustart, bis der Neustartzyklus abgeschlossen ist.

Hinweise:

Diese Einstellung ist für Headless-Server mit statischen IP-Adressen erforderlich.

Diese automatische Neustartfunktion gilt nur für Aktualisierungen der Windows I/O-Treiber über den Geräte-Manager oder Windows Update. Wenn Sie das Management Agent-Installationsprogramm zum Bereitstellen Ihrer Treiber verwenden, ignoriert das Installationsprogramm diesen Registrierungsschlüssel und verwaltet die Neustarts der VM gemäß seinen eigenen Einstellungen.

Finden der I/O-Treiberversion

Um die Version der auf der VM installierten I/O-Treiber herauszufinden:

  1. Navigieren Sie zu C:\Windows\System32\drivers.

  2. Suchen Sie den Treiber aus der Liste.

  3. Rechtsklicken Sie auf den Treiber und wählen Sie Eigenschaften und dann Details.

    Im Feld Dateiversion wird die Version des auf der VM installierten Treibers angezeigt.

Aktualisieren des Management-Agenten

Mit Citrix Hypervisor können Sie den Management Agent automatisch sowohl auf neuen als auch auf vorhandenen Windows-VMs aktualisieren. Standardmäßig ermöglicht Citrix Hypervisor die automatische Aktualisierung des Management Agents. Allerdings erlaubt es dem Management Agent nicht, die E/A-Treiber automatisch zu aktualisieren. Sie können die Update-Einstellungen des Management Agent während der Installation von Citrix VM Tools für Windows anpassen. Die automatische Aktualisierung des Management Agents erfolgt nahtlos und startet die VM nicht neu. In Szenarien, in denen ein Neustart der VM erforderlich ist, wird auf der Registerkarte Konsole der VM eine Meldung angezeigt, die Benutzer über die erforderliche Aktion informiert.

Sie können die Management Agent-Updates automatisch abrufen, vorausgesetzt:

  • Sie führen Citrix Hypervisor 8.2 Premium Edition aus oder haben Zugriff auf Citrix Hypervisor über die Berechtigung Citrix Virtual Apps and Desktops oder Citrix DaaS-Berechtigung.

  • Sie haben Citrix VM Tools für Windows installiert, die mit Citrix Hypervisor 7.0 oder höher ausgestellt wurden

  • Die Windows VM hat Zugriff auf das Internet

Finden Sie die Version des Management Agents

So ermitteln Sie die Version des Management Agents, der auf der VM installiert ist:

  1. Navigieren Sie zu C:\Program Files\Citrix\XenTools.

  2. Klicken Sie mit der rechten Maustaste auf XenGuestAgent aus der Liste und klicken Sie auf Eigenschaften und dann Details.

    Im Feld Dateiversion wird die Version des Management Agents angezeigt, der auf der VM installiert ist.

Verwalten automatischer Updates über die CLI

Mit Citrix Hypervisor können Sie die Befehlszeile verwenden, um die automatische Aktualisierung der I/O-Treiber und des Management Agents zu verwalten. Sie können msiexec.exe mit den in der folgenden Tabelle aufgeführten Argumenten ausführen, um anzugeben, ob die I/O-Treiber und der Management Agent automatisch aktualisiert werden. Informationen zum Installieren von Citrix VM Tools für Windows mithilfe msiexec.exevon finden Sie unter Installation ohne Benutzereingriffe.

Hinweis:

Bei VMs, die entweder mit PVS oder MCS verwaltet werden, werden automatisierte Updates automatisch ausgeschaltet, wenn der Citrix Virtual Desktops VDA vorhanden ist und meldet, dass die Maschine nicht persistent ist.

Argument Werte Beschreibung
ALLOWAUTOUPDATE JA/NEIN Zulassen/Verbieten der automatischen Aktualisierung des Management Agents
ALLOWDRIVERINSTALL JA/NEIN Erlauben/verbieten Sie dem Installationsprogramm von Citrix VM Tools for Windows, I/O-Treiber zu installieren
ALLOWDRIVERUPDATE JA/NEIN Erlauben/verbieten dem Management Agent, die I/O-Treiber automatisch zu aktualisieren
IDENTIFYAUTOUPDATE JA/NEIN Zulassen/Verbieten des automatischen Aktualisierungsmechanismus, um anonyme Nutzungsinformationen an Citrix zu senden

Beispiel:

setup.exe  /passive /forcerestart ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
     ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

Oder

msiexec.exe /i managementagentx64.msi ALLOWAUTOUPDATE=YES ALLOWDRIVERINSTALL=NO \
    ALLOWDRIVERUPDATE=NO IDENTIFYAUTOUPDATE=YES
<!--NeedCopy-->

Umleiten der Management Agent-Aktualisierungen

Mit Citrix Hypervisor können Kunden Management Agent-Updates vor der Installation auf einen internen Webserver umleiten. Mit dieser Umleitung können Kunden die Updates überprüfen, bevor sie automatisch auf der VM installiert werden.

So leiten Sie die Management Agent-Aktualisierungen um:

Der Management Agent verwendet eine Aktualisierungsdatei, um Informationen über die verfügbaren Updates abzurufen. Der Name dieser Update-Datei hängt von der Version des Management Agents ab, die Sie verwenden:

Führen Sie die folgenden Schritte aus, um die Management Agent-Updates umzuleiten:

  1. Laden Sie die Update-Datei herunter.

  2. Laden Sie die Management Agent MSI-Dateien herunter, auf die in der Update-Datei

  3. Laden Sie die MSI-Dateien auf einen internen Webserver hoch, auf den Ihre virtuellen Maschinen zugreifen können.

  4. Aktualisieren Sie die Update-Datei, sodass sie auf die MSI-Dateien auf dem internen Webserver verweist.

  5. Laden Sie die Update-Datei auf den Webserver hoch.

Automatische Updates können auch pro VM oder pro Pool umgeleitet werden. So leiten Sie Aktualisierungen auf einer Pro-VM-Basis um:

  1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

  2. Führen Sie auf dem Computer, auf dem das Problem auftritt, den Befehl

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

Führen Sie den folgenden Befehl aus, um die automatische Aktualisierung des Management Agents pro Pool umzuleiten:

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

Deaktivieren der Management Agent-Updates

So deaktivieren Sie die automatische Aktualisierung des Management Agents pro VM:

  1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

  2. Führen Sie den folgenden Befehl aus:

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

Um die automatische Aktualisierung des Management Agents pro Pool zu deaktivieren, führen Sie den folgenden Befehl aus:

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

Ändern der automatischen I/O-Treiber-Update-Einstellungen

Während der Installation von Citrix VM Tools für Windows können Sie angeben, ob Sie dem Management Agent erlauben möchten, die I/O-Treiber automatisch zu aktualisieren. Wenn Sie diese Einstellung lieber aktualisieren möchten, nachdem Sie den Installationsvorgang für Citrix VM Tools for Windows abgeschlossen haben, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

  2. Führen Sie den folgenden Befehl aus:

    reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate /t REG_SZ /v \
        InstallDrivers /d YES/NO
    <!--NeedCopy-->
    

So senden Sie anonyme Nutzungsinformationen an Citrix:

Während der Installation von Citrix VM Tools für Windows können Sie angeben, ob Sie anonyme Nutzungsinformationen an Citrix senden möchten. Wenn Sie diese Einstellung nach Abschluss des Installationsvorgangs von Citrix VM Tools für Windows aktualisieren möchten, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie auf der VM als Administrator eine Eingabeaufforderung.

  2. Führen Sie den folgenden Befehl aus:

    reg.exe ADD HKLM\SOFTWARE\Citrix\XenTools\AutoUpdate REG_SZ /v \
        IDENTIFYAUTOUPDATE /d YES/NO
    <!--NeedCopy-->
    

Deinstallieren Sie Citrix VM Tools für Windows

Wir empfehlen nicht, die Citrix VM Tools von Ihren Windows-VMs zu entfernen. Diese Tools sind erforderlich, damit Ihre Windows-VMs vollständig unterstützt werden. Wenn Sie sie entfernen, kann dies zu unerwartetem Verhalten führen. Manuelles Deinstallieren Sie Ihre Citrix VM Tools nur als letzten Ausweg.

Standarddeinstallation

Um eine Standarddeinstallation der Citrix VM Tools durchzuführen, können Sie die Windows-Funktion Programme hinzufügen oder entfernen verwenden:

  1. Erstellen Sie einen Snapshot der VM, bevor Sie beginnen.
  2. Gehen Sie in der Windows-VM zu Programme hinzufügen oder entfernen.
  3. Wählen Sie Citrix Hypervisor PV Tools aus und klicken Sie auf Deinstallieren.
  4. Starten Sie die VM neu.

Der Befehl uninstall.exe

Bei der Deinstallation der Citrix VM Tools mithilfe der Windows-Funktion Programme hinzufügen oder entfernen wird die Datei <tools-install-directory>\uninstall.exe aufgerufen, um die Deinstallationsaktionen auszuführen. Sie können diesen Befehl stattdessen von einem PowerShell-Terminal oder einer Befehlszeile mit Administratorrechten aufrufen.

  1. Erstellen Sie einen Snapshot der VM, bevor Sie beginnen.
  2. Öffnen Sie als Administrator eine Eingabeaufforderung oder ein PowerShell-Terminal.
  3. Führen Sie den Befehl <tools-install-directory>\uninstall.exe aus.
  4. Starten Sie die VM neu.

Befehlsoptionen

Der Befehl uninstall.exe akzeptiert die folgenden Parameter:

  • help - Zeigt Verwendungsinformationen für den Befehl an.
  • log - Generiert eine Protokolldatei, die angibt, was der Befehl getan hat.
  • verbose - Druckt auf die Konsole, was der Befehl bewirkt hat.
  • disable - Deaktiviert Treiber, die vom Installationsprogramm MSI installiert wurden.
  • force-disable - Deaktiviert die Treiber in allen Situationen.
  • hidden - Löscht versteckte Geräte. Diese Geräte sind unbenutzt und wurden ersetzt, haben aber möglicherweise veraltete Registrierungseinträge hinterlassen.
  • cleanup - Entfernt alte Deinstallationsprogramme aus dem Bereich Programme hinzufügen oder entfernen. Diese Deinstallationsprogramme können doppelte Einträge aus älteren Versionen der Tools enthalten.
  • purge - (9.3.1 und höher) Setzt die VM in einen sauberen Zustand zurück, in dem sie sich befand, bevor ein Teil der Citrix VM Tools installiert wurde. Weitere Informationen finden Sie unter Vollständige Deinstallation aller Citrix VM Tools-Komponenten.
  • install - (9.3.1 und höher) Installiert den aktuellen Satz von I/O-Treibern und fordert bei Bedarf einen VM-Neustart auf.
  • reboot- Startet die VM neu, nachdem alle anderen Befehlsoperationen abgeschlossen sind.

Vollständige Deinstallation aller Citrix VM Tools-Komponenten

Die neueste Version von Citrix VM Tools für Windows (9.3.1 und höher) enthält den Befehl uninstall.exe purge. Die Option purge in der Anwendung uninstall.exe setzt eine VM auf den Zustand zurück, bevor einer der I/O-Treiber installiert wurde. Wenn beim Upgrade Ihrer Tools auf eine neuere Version Probleme auftreten oder wenn Sie einen sauberen Status benötigen, um einen späteren Satz von Tools auf Ihrer VM zu installieren, verwenden Sie dieses Tool.

  1. Erstellen Sie einen Snapshot der VM, bevor Sie beginnen.
  2. Öffnen Sie als Administrator eine Eingabeaufforderung oder ein PowerShell-Terminal.
  3. Führen Sie den Befehl aus <tools-install-directory>\uninstall.exe purge verbose
  4. Starten Sie die VM neu.

Nachdem Sie diesen Befehl verwendet haben, müssen Sie keine manuellen Bereinigungsschritte ausführen, wie Sie es möglicherweise bei früheren Versionen der Citrix VM Tools getan haben. Alle Änderungen im Zusammenhang mit den Citrix VM Tools wurden entfernt.

Was entfernt die Option purge?

Wenn Sie den Befehl verwenden uninstall.exe purge, werden alle Spuren der Citrix VM Tools von Ihrer Windows-VM entfernt. Die Liste der mit diesem Befehl ausgeführten Aktionen lautet wie folgt:

  • Dienstleistungen:
    • Deaktiviert alle Citrix VM Tools-Dienste, wodurch verhindert wird, dass installierte Treiber und Dienste beim Neustart gestartet werden.
    • Stoppt alle laufenden Citrix VM Tools-Dienste.
  • Treiber:
    • Deinstalliert I/O-Treiber von allen Geräteknoten.
    • Deinstalliert versteckte Geräte. Diese Aktion entspricht der Aktion, die die Befehlszeilenoption hidden ausgeführt hat.
    • Deinstalliert zwischengespeicherte Treiberpakete, wodurch sie aus dem Treiberspeicher entfernt werden. Daher werden die I/O-Treiber nicht automatisch neu installiert.
  • Registrierung:
    • Entfernt veraltete Registrierungsinformationen, die von Versionen der Treiber verwendet wurden, die nicht mehr unterstützt werden.
    • Löscht Schlüssel, die sich auf Tools beziehen, aus HKLM\System\CurrentControlSet\Control\Class\...
    • Löscht Schlüssel, die sich auf Werkzeuge beziehen, von HKLM\System\CurrentControlSet\Services.
    • Löscht Schlüssel, die sich auf Tools beziehen, aus HKLM\System\CurrentControlSet\Enum\...
  • Dateien:
    • Löscht alle Citrix VM Tools-Treiberdateien von C:\Windows\System32 und C:\Windows\System32\drivers.
    • Löscht Citrix VM Tools INF-Dateien von C:\Windows\INF.
    • Löscht alle veralteten Dateien, die von Versionen der Tools übrig geblieben sind, die nicht mehr unterstützt C:\Program Files\Citrix\XenToolswerden.
  • Andere:
    • Löscht alte Einträge unter Programme hinzufügen oder entfernen. Diese Aktion entspricht der Aktion, die die Befehlszeilenoption cleanup ausgeführt hat.
    • Löscht einige der veralteten Statusinformationen des InstallAgents.
    • Entfernt xenfilt.sys aus den oberen Filtern. Diese Änderung verhindert, dass xenfilt.sys auf Treiberknoten geladen wird.
    • Entfernt die unplug-Schlüssel, wodurch die VM beim Neustart zu emulierten Geräten zurückkehrt.
    • Entfernt StartOverride von StorNvME. Diese Änderung erzwingt den Start von stornvme.sys beim Booten und ermöglicht die Funktion emulierter NVMe-Startgeräte (UEFI).

Was ist neu

Die Version der Citrix VM Tools for Windows wird unabhängig von der Version von Citrix Hypervisor aktualisiert. Stellen Sie sicher, dass Ihre Citrix VM Tools for Windows regelmäßig auf die neueste Version aktualisiert werden, sowohl in Ihren VMs als auch in allen Vorlagen, die Sie zum Erstellen Ihrer VMs verwenden.

Citrix VM Tools für Windows 9.3.1

Veröffentlicht am 25. Januar 2023

Dieses Toolset enthält die folgenden Komponentenversionen:

  • Installationsprogramm: 9.3.1
  • Verwaltungsagent: 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

Verbesserungen in 9.3.1

Diese Version beinhaltet die folgenden Verbesserungen:

  • Verbesserungen des Hilfsprogramms uninstall.exe, einschließlich des Parameters purge. Weitere Informationen finden Sie unter Deinstallieren von Citrix VM Tools für Windows.
  • Allgemeine Verbesserungen des Citrix VM Tools-Installers.
  • Allgemeine Verbesserungen der Zeichenkettenbehandlung von Registrierungsschlüsseln.

Behobene Probleme in 9.3.1

Diese Version enthält Korrekturen für die folgenden Probleme:

  • Wenn die Citrix VM Tools über Windows Update aktualisiert werden, gehen manchmal die statischen IP-Einstellungen verloren und die Netzwerkeinstellungen werden geändert, um DHCP zu verwenden.
  • Auf Windows-VMs können die Grant-Tabellen leicht erschöpft sein. In diesem Fall können Lese- und Schreibanforderungen fehlschlagen oder zusätzliche VIFs werden nicht korrekt aktiviert und können nicht gestartet werden.
  • In seltenen Fällen kann es vorkommen, dass beim Upgrade der Citrix VM Tools für Windows der vorhandene Management Agent nicht heruntergefahren wird und das Upgrade nicht erfolgreich ist.
  • Auf einer virtuellen Windows-Maschine sehen Sie möglicherweise sowohl die vorherige als auch die neueste Version der Tools oder des Management-Agents, die in Ihren installierten Programmen aufgeführt sind.
    • (VORHERIGE) Citrix XenServer Windows Management-Agent
    • (AKTUELLE) Citrix Hypervisor PV-Tools.

Frühere Releases

9.3.0

Veröffentlicht am 26. Juli 2022

Dieses Toolset enthält die folgenden Komponentenversionen:

  • Installationsprogramm: 9.3.0
  • Management-Agent: 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

Diese Version beinhaltet die folgenden Verbesserungen:

  • Allgemeine Verbesserungen des Citrix VM Tools-Installers.

Diese Version enthält Korrekturen für die folgenden Probleme:

  • Sicherheitssoftware blockierte sekundäre Datenträger, die als austauschbar gekennzeichnet sind, daran, dem Betriebssystem ausgesetzt zu werden, um die Datenexfiltration zu verhindern. Mit diesem Update können Sie eine VBD als nicht entfernbar kennzeichnen und diese über das Betriebssystem korrekt verfügbar machen.
  • Auf einer Windows-VM ist manchmal die IP-Adresse eines SR-IOV-VIF in XenCenter nicht sichtbar.

9.2.3

Veröffentlicht am 28. April 2022

Dieses Toolset enthält die folgenden Komponentenversionen:

  • Installationsprogramm: 9.2.3
  • Management-Agent: 9.1.1.13
  • xenbus: 9.1.3.30
  • xeniface: 9.1.4.34
  • xennet:
    • 9.1.1.8 (für Windows Server 2012 und Windows Server 2012 R2)
    • 9.1.2.23 (für alle anderen unterstützten Windows-Betriebssysteme)
  • xenvbd: 9.1.2.20
  • xenvif: 9.1.5.48

Diese Version enthält Korrekturen für die folgenden Probleme:

  • In Citrix VM Tools für Windows Version 9.2.2 sind Zeitsynchronisierungsoptionen nicht verfügbar.
  • Eine Rennbedingung kann dazu führen, dass Windows-VMs nach der Live-Migration auf Citrix Hypervisor 8.2 Cumulative Update 1 einen Bluescreen-Fehler anzeigen.
  • Windows-VMs, auf denen Version 9.2.1 oder 9.2.2 der Citrix VM Tools installiert ist und die PVS-Ziele sind, können manchmal mit einem schwarzen Bildschirm einfrieren. Die Meldung “Guest Rx stalled” ist in den dom0-Kernelprotokollen enthalten. Dieses Problem tritt häufiger bei Poolmastern auf als bei anderen Poolmitgliedern.
  • Auf einer Windows-VM mit mehr als 8 vCPUs funktioniert Receive Side Scaling möglicherweise nicht, da der Xenvif-Treiber die Umleitungstabelle nicht einrichten kann.

9.2.2

Veröffentlicht am 14. Januar 2022

Dieses Toolset enthält die folgenden Komponentenversionen:

  • Installationsprogramm: 9.2.2
  • Management-Agent: 9.1.1.13
  • xenbus: 9.1.3.30
  • xeniface: 9.1.2.22
  • xennet:
    • 9.1.1.8 (für Windows Server 2012 und Windows Server 2012 R2)
    • 9.1.2.23 (für alle anderen unterstützten Windows-Betriebssysteme)
  • xenvbd: 9.1.2.20
  • xenvif: 9.1.3.31

Diese Version enthält Korrekturen für die folgenden Probleme:

  • Während des Updates der Tools kann der Xenbus-Treiber einen Neustart veranlassen, bevor die Treiberinstallation abgeschlossen ist. Das Akzeptieren des Neustarts kann zu einem Bluescreen-Fehler in Ihrer Windows-VM führen.
  • Beim Komprimieren gesammelter Diagnoseinformationen läuft das xt-bugtool-Diagnosetool nach 20 Sekunden ab. Dieses Verhalten kann dazu führen, dass die Diagnose-ZIP-Datei nicht korrekt erstellt wird.
  • Das Teilen der VNC-Zwischenablage funktioniert nicht.
  • Die vorherigen Versionen der Treiber wurden nicht über Windows Update veröffentlicht.

9.2.1

Veröffentlicht am 24. Juni 2021

Dieses Toolset enthält die folgenden Komponentenversionen:

  • Installationsprogramm: 9.2.1
  • Management-Agent: 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

Hinweis:

Dieser Treibersatz wurde nicht über Windows Update bereitgestellt.

Diese Version enthält Korrekturen für die folgenden Probleme:

  • In einigen Fällen kann der Laptop/Slate-Status der VM nicht geändert werden.
  • Nach dem Neustart einer VM kann es manchmal vorkommen, dass übermäßig viele Protokollmeldungen an die Datei daemon.log gesendet werden.
  • Wenn die Abhängigkeit von der Treiberlast nach einem Betriebssystem-Upgrade nicht mehr funktioniert, kann ein Upgrade der Citrix VM Tools verhindert werden.
  • Ein Speicherfehler kann zum Absturz von Windows-VMs führen.
  • Manchmal ist die IP-Adresse eines SR-IOV-VIF in XenCenter nicht sichtbar. Um das Problem zu beheben, starten Sie den Management-Agenten im Service Manager der VM neu.
  • Bei hoher Netzwerk- und Systemlast und geringen Ressourcen können bei virtuellen Computern sowohl in Citrix als auch in Treibern von Drittanbietern Bugchecks durchgeführt werden, in der Regel mit dem Code IRQL_NOT_LESS_OR_EQUAL. Dieser Fix verbessert die Netzwerkpufferung, um diese Bugchecks zu verhindern.
  • Ein Upgrade der Windows-I/O-Treiber kann dazu führen, dass UEFI-VMs nicht gestartet werden und “0xC000000E” gemeldet werden. Ein erforderliches Gerät ist nicht angeschlossen oder es kann nicht darauf zugegriffen werden.””
  • Bei der Installation der Citrix VM Tools nach der Deinstallation einer früheren Version der Citrix VM Tools kann ein Problem auftreten, das die folgende Fehlermeldung zurückgibt: “Dieses Gerät kann nicht gestartet werden (Code 10) (Vorgang fehlgeschlagen) Der angeforderte Vorgang war nicht erfolgreich”.
Citrix VM Tools für Windows