製品ドキュメント
XenServer
XenServer 9 XenServer 8.4
PDFを表示

XenServer VM Tools for Windows

June 2, 2025
寄稿者: 
X

Windows 用 XenServer VM Tools (旧称 Citrix VM Tools または XenServer PV Tools) は、従来のデバイスエミュレーションのオーバーヘッドなしに、高性能な I/O サービスを提供します。Windows 用 XenServer VM Tools は、I/O ドライバー (準仮想化ドライバーまたは PV ドライバーとも呼ばれます) と管理エージェントで構成されます。

VM が完全にサポートされる構成であるためには、各 Windows VM に Windows 用 XenServer VM Tools をインストールする必要があります。VM はこれらなしでも機能しますが、パフォーマンスが低下します。

Windows 用 XenServer VM Tools のバージョンは、XenServer のバージョンとは独立して更新されます。サポート対象となるには、VM および VM の作成に使用するテンプレートの両方で、Windows 用 XenServer VM Tools を常に最新バージョンに更新してください。ツールの最新バージョンについては、「新機能」を参照してください。

XenServer VM Tools のインストール

注記:

Windows VM に Windows 用 XenServer VM Tools をインストールするには、VM で Microsoft .NET Framework Version 4.0 以降が実行されている必要があります。

Windows 用 XenServer VM Tools は、デフォルトで VM 上の C:\Program Files\XenServer\XenTools ディレクトリにインストールされます。

Windows 用 XenServer VM Tools のインストール手順:

  1. XenServer VM Tools をインストールまたは更新する前に、VM のスナップショットを作成することをお勧めします。

  2. XenServer ダウンロードページから Windows 用 XenServer VM Tools ファイルをダウンロードします。

  3. 提供されている SHA256 値に対してダウンロードを検証します。

  4. ファイルを Windows VM または Windows VM がアクセスできる共有ドライブにコピーします。

  5. managementagentx64.msi ファイルを実行して、XenServer VM Tools のインストールを開始します。

    Msiexec.exe /package managementagentx64.msi

  6. インストーラーのプロンプトに従います。

    • ウィザードの指示に従って、ライセンス契約に同意し、インストール先フォルダーを選択します。

    • インストールと更新の設定ページで設定をカスタマイズします。

      デフォルトでは、ウィザードに次の推奨設定が表示されます。

      • I/O ドライバーを今すぐインストール
        • VM に has-vendor-device=true が設定されている場合、I/O ドライバーは Windows Update によってすでにインストールされているため、このオプションは選択解除されます。
        • VM に has-vendor-device=false が設定されている場合、このオプションは選択されます。
      • 管理エージェントの自動更新を許可
      • 管理エージェントによる I/O ドライバーの自動更新を禁止
      • 匿名使用状況情報を Cloud Software Group, Inc. に送信

      一部のユースケースでは、異なる更新設定が推奨されます。詳細については、「XenServer VM Tools の更新」を参照してください。

      更新設定を構成するには、次の変更を行うことができます。

      • 管理エージェントの自動更新を許可しない場合は、リストから [管理エージェントの自動更新を禁止] を選択します。

      • 管理エージェントによる I/O ドライバーの自動更新を許可する場合は、[管理エージェントによる I/O ドライバーの自動更新を許可] を選択します。ただし、I/O ドライバーの更新には管理エージェントではなく Windows Update を使用することをお勧めします。Windows Update メカニズムを介して I/O ドライバーの更新を受け取ることを選択している場合は、管理エージェントによる I/O ドライバーの自動更新を許可しないでください。

      • 匿名使用状況情報を弊社と共有しない場合は、[匿名使用状況情報を Cloud Software Group, Inc. に送信] チェックボックスをオフにします。Cloud Software Group に送信される情報には、更新を要求している VM の UUID の最初の 4 文字が含まれます。VM に関連するその他の情報は収集または送信されません。

    • [次へ]、次に [インストール] をクリックして、Windows 用 XenServer VM Tools のインストールプロセスを開始します。

  7. インストールプロセスを完了するためにプロンプトが表示されたら、VM を再起動します。

    RDP を介して Windows 用 XenServer VM Tools または管理エージェントをインストールするお客様は、再起動のプロンプトが表示されない場合があります。これは、プロンプトが Windows コンソールセッションにのみ表示されるためです。VM を再起動し (必要な場合)、VM を最適化された状態にするには、RDP で強制再起動オプションを指定します。強制再起動オプションは、VM を最適化された状態にするために必要な場合にのみ VM を再起動します。

警告:

Windows 用 XenServer VM Tools をインストールまたはアップグレードすると、一部のネットワークアダプターのフレンドリ名と識別子が変更される可能性があります。特定のネットワークアダプターを使用するように構成されているソフトウェアは、Windows 用 XenServer VM Tools のインストールまたはアップグレード後に再構成する必要がある場合があります。

サイレントインストール

Windows 用 XenServer VM Tools をサイレントインストールし、システムの再起動を防ぐには、次のコマンドを実行します。

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

非対話型ではあるが非サイレントインストールは、次のコマンドを実行することで実行できます。

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

注記:

  • /quiet パラメーターはインストールダイアログにのみ適用され、デバイスドライバーのインストールには適用されません。/quiet パラメーターが指定されている場合、デバイスドライバーのインストールは必要に応じて再起動の許可を要求します。
    • /quiet /norestart が指定されている場合、ツール全体のインストールが完了してもシステムは再起動しません。この動作は、ユーザーが再起動ダイアログで指定する内容とは独立しています。
    • /quiet /forcerestart が指定されている場合、アップグレードまたはインストールプロセスによって複数の再起動がトリガーされる可能性があります。この動作は、ユーザーが再起動ダイアログで指定する内容とは独立しています。
    • デバイスドライバーのインストールが再起動の許可を要求する場合、quiet パラメーターが指定されたツールのインストールはまだ進行中である可能性があります。インストーラーがまだ実行されているかどうかは、タスクマネージャーを使用して確認してください。

インストール設定をカスタマイズするには、サイレントインストールコマンドで次のパラメーターを使用します。

パラメーター 許可される値 デフォルト 説明
ALLOWAUTOUPDATE YES または NO YES 管理エージェントの自動更新を許可
ALLOWDRIVERINSTALL YES または NO YES I/O ドライバーを今すぐインストール
ALLOWDRIVERUPDATE YES または NO NO 管理エージェントの自動更新による更新済みドライバーのインストールを許可
IDENTIFYAUTOUPDATE YES または NO YES 匿名使用状況情報を弊社に送信

たとえば、将来の管理エージェントの自動更新を許可せず、Cloud Software Group, Inc. に匿名情報を送信しないツールのサイレントインストールを行うには、次のいずれかのコマンドを実行します。

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

対話型、サイレント、およびパッシブインストールの場合、次回のシステム再起動後、Windows 用 XenServer VM Tools が完全にインストールされるまでに、いくつかの自動再起動が発生する可能性があります。この動作は、/norestart フラグが指定されたインストールの場合も同様です。ただし、/norestart フラグが指定されているインストールの場合、最初の再起動は手動で開始される可能性があります。

XenServer VM Tools の更新

VM および VM の作成に使用するテンプレートの両方で、Windows 用 XenServer VM Tools を常に最新バージョンに更新してください。XenServer VM Tools を更新する前に、VM のスナップショットを作成することをお勧めします。ツールの最新バージョンについては、「新機能」を参照してください。

重要:

更新の一環として、要求されたすべての VM 再起動が完了していることを確認してください。複数の再起動が必要になる場合があります。要求されたすべての再起動が完了しない場合、VM が予期しない動作を示す可能性があります。

XenServer は、各コンポーネントの自動更新メカニズムを提供します。

  • 管理エージェントは自動的に自身を更新できます

  • I/O ドライバーは、管理エージェントまたは Windows Update を介して更新できます。

    XenCenter の [新規 VM] ウィザードで VM テンプレートを選択する際に、Windows Update を介した I/O ドライバーの更新を有効にできます。Windows Update を介した I/O ドライバーの更新を有効にする方法の詳細については、「VM 作成手順の概要」を参照してください。

または、これらのコンポーネントのいずれかまたは両方を手動で更新できます。

ツールの各コンポーネントに選択する更新方法は、お使いの環境によって異なります。

推奨される更新設定

ほとんどのユースケースでは、Windows 用 XenServer VM Tools のさまざまなコンポーネントを更新するために、次の設定を使用することをお勧めします。

  1. 管理エージェントの更新を有効にする。

  2. 管理エージェントによる I/O ドライバーの更新を停止する。

  3. 次のレジストリキーの値を REG_DWORD 値「3」に設定します: HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot。

    詳細については、「自動再起動」を参照してください。

  4. Windows Update を介した I/O ドライバーの更新を有効にする。

インストール時:

インストーラーを実行すると、最初の 2 つの設定がデフォルトになります。

デフォルトの更新設定が選択された XenServer VM Tools インストーラー

Citrix Provisioning ターゲットまたは起動時にリセットされるマシンの設定

Windows VM を Citrix Provisioning ターゲットとして使用する場合、または起動時にリセットするフラグを有効にして使用する場合、自動更新メカニズムは使用できません。これらの VM の作成に使用するマスターテンプレートで、次の構成を設定することをお勧めします。

  1. VM の作成時に、has-vendor-device フラグが false に設定されていることを確認します。これにより、Windows Update が Windows 用 XenServer VM Tools の I/O ドライバーを自動的に更新するのを防ぎます。このフラグは、次の方法で設定できます。

    • CLI を使用します。詳細については、「CLI を使用した Windows VM の作成」を参照してください。
    • XenCenter の [新規 VM] ウィザードで VM テンプレートを選択する際に、[Windows Update による I/O ドライバーの提供を許可] チェックボックスを無効にします。詳細については、「VM 作成手順の概要」を参照してください。

  2. 管理エージェントの更新を無効にする。

インストール時:

XenServer VM Tools を初めてインストールする際に、この構成を指定します。

自動更新設定が選択されていない XenServer VM Tools インストーラー

管理エージェントのみによる自動更新の設定

管理エージェントが自身と I/O ドライバーの両方を更新するように構成できます。この構成を使用する場合は、VM が Windows Update を介して I/O ドライバーを更新しないようにしてください。両方のメカニズムが I/O ドライバーの更新を試みると、不要な更新が発生する可能性があります。

組織が Windows VM に更新を適用する前にレビューすることを要求する場合は、このアプローチを選択してください。この場合、管理エージェントが内部サーバーから更新を取得するようにリダイレクトする必要もあります。

  1. Windows Update を介した I/O ドライバーの更新を無効にする。

  2. 管理エージェントが I/O ドライバーを更新するように設定する。

  3. (オプション) 管理エージェントの更新をリダイレクトする。

インストール時:

XenServer VM Tools を初めてインストールする際に、この構成を指定します。

自動更新設定が選択されていない XenServer VM Tools インストーラー

管理エージェントの更新

XenServer を使用すると、新規および既存の Windows VM の両方で管理エージェントを自動的に更新できます。デフォルトでは、XenServer は管理エージェントの自動更新を許可します。ただし、管理エージェントが I/O ドライバーを自動的に更新することは許可しません。Windows 用 XenServer VM Tools のインストール中に、管理エージェントの更新設定をカスタマイズできます。管理エージェントの自動更新はシームレスに行われ、VM を再起動しません。VM の再起動が必要なシナリオでは、VM のコンソールタブに、必要なアクションについてユーザーに通知するメッセージが表示されます。

Windows VM がインターネットにアクセスできる場合、管理エージェントの更新を自動的に取得できます。

CLI を使用した自動更新の管理

XenServer を使用すると、コマンドラインを使用して I/O ドライバーと管理エージェントの自動更新を管理できます。次の表にリストされている引数とともに msiexec.exe を実行して、I/O ドライバーと管理エージェントが自動的に更新されるかどうかを指定できます。msiexec.exe を使用した Windows 用 XenServer VM Tools のインストールについては、「サイレントインストール」を参照してください。

注記:

PVS または MCS のいずれかを使用して管理されている VM の場合、Citrix Virtual Desktops VDA が存在し、マシンが非永続的であると報告すると、自動更新は自動的にオフになります。

引数 値 説明
ALLOWAUTOUPDATE YES/NO 管理エージェントの自動更新を許可/禁止
ALLOWDRIVERINSTALL YES/NO Windows 用 XenServer VM Tools インストーラーによる I/O ドライバーのインストールを許可/禁止
ALLOWDRIVERUPDATE YES/NO 管理エージェントによる I/O ドライバーの自動更新を許可/禁止
IDENTIFYAUTOUPDATE YES/NO 自動更新メカニズムによる匿名使用状況情報の弊社への送信を許可/禁止

管理エージェントの更新の有効化

VM ごとに管理エージェントの自動更新を有効にするには:

  1. VM で、管理者としてコマンドプロンプトを開きます。

  2. 次のコマンドを実行します。

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

プールごとに管理エージェントの自動更新を有効にするには、ホストコンソールで次のコマンドを実行します。

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

管理エージェントの更新の無効化

VM ごとに管理エージェントの自動更新を無効にするには:

  1. VM で、管理者としてコマンドプロンプトを開きます。

  2. 次のコマンドを実行します。

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

プールごとに管理エージェントの自動更新を無効にするには、ホストコンソールで次のコマンドを実行します。

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

管理エージェントの更新のリダイレクト

XenServer を使用すると、お客様は管理エージェントの更新がインストールされる前に、内部 Web サーバーにリダイレクトできます。このリダイレクトにより、お客様は更新が VM に自動的にインストールされる前にレビューできます。

管理エージェントは、利用可能な更新に関する情報を取得するために更新ファイルを使用します。この更新ファイルの名前は、使用している管理エージェントのバージョンによって異なります。

管理エージェントを最新バージョンにアップグレードすることを強くお勧めします。ただし、古いバージョンの管理エージェントを使用している場合は、古いバージョンで使用するための次の更新ファイルを提供しています。

管理エージェントの更新をリダイレクトするには、次の手順を完了します。

  1. 更新ファイルをダウンロードします。

  2. 更新ファイルで参照されている管理エージェントの MSI ファイルをダウンロードします。

  3. MSI ファイルを、VM がアクセスできる内部 Web サーバーにアップロードします。

  4. 更新ファイルを更新して、内部 Web サーバー上の MSI ファイルを指すようにします。

  5. 更新ファイルを Web サーバーにアップロードします。

自動更新は、VM ごとまたはプールごとにリダイレクトすることもできます。VM ごとに更新をリダイレクトするには、次の手順を実行します。

  1. VM で、管理者としてコマンドプロンプトを開きます。

  2. 次のコマンドを実行します。

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

プールごとに管理エージェントの自動更新をリダイレクトするには、次のコマンドを実行します。

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

I/O ドライバーの更新

I/O ドライバーは、Windows Update または管理エージェントを使用して更新できます。XenCenter の VM の [全般] タブにある [仮想化の状態] セクションは、VM が Windows Update から更新を受け取る資格があるかどうかを示します。または、自動更新をオフにして、I/O ドライバーの更新を手動で管理することもできます。

各 I/O ドライバー (xennet、xenvif、xenvbd、xeniface、xenbus など) には独自のバージョンがあります。最新バージョンの詳細については、「新機能」を参照してください。

Windows Update を介した I/O ドライバーの更新の有効化

Microsoft Windows Update から I/O ドライバーの更新を自動的に取得するには、次の条件を満たす必要があります。

  • VM で Windows Update が有効になっていること。

  • VM がインターネットにアクセスできるか、WSUS プロキシサーバーに接続できること。

  • Windows Server Core は Windows Update を使用した I/O ドライバーのインストールまたは更新をサポートしていないため、Windows Server の Core バージョンを実行していないこと。

XenCenter の [新規 VM] ウィザードで VM テンプレートを選択する際に、Windows Update を介した I/O ドライバーの更新を有効にできます。Windows Update を介した I/O ドライバーの更新を有効にする方法の詳細については、「VM 作成手順の概要」を参照してください。

Windows Update から I/O ドライバーの更新を受け取りたくない場合は、VM で Windows Update を無効にするか、グループポリシーを指定します。

Windows Update を介した I/O ドライバーの更新の無効化

新規および既存の VM の両方で、Windows Update を介した I/O ドライバーの更新を無効にできます。

  • 新規 VM の場合: XenCenter の [新規 VM] ウィザードを使用して新しい VM を作成する際に、フラグを設定することで I/O ドライバーの自動更新を無効にできます。これは、Citrix Provisioning ターゲットまたは起動時にリセットされるマシンにとって特に重要であり、自動更新を無効にすることで安定性が確保されます。詳細については、「VM 作成手順の概要」および「Citrix Provisioning ターゲットまたは起動時にリセットされるマシンの設定」を参照してください。コマンドラインを使用してこれらの設定を管理することを好む上級ユーザーについては、「CLI を使用した Windows VM の作成」を参照してください。

  • 既存 VM の場合: VM がすでに展開されている場合、グループポリシーを構成することで I/O ドライバーの更新を無効にできます。これにより、VM が Windows Update から自動更新を受け取らないようにします。

管理エージェントが I/O ドライバーを更新するように設定

Windows 用 XenServer VM Tools のインストール中に、管理エージェントが I/O ドライバーを自動的に更新するように構成できます。詳細については、「Windows 用 XenServer VM Tools のインストール」を参照してください。

インストール完了後にこの設定を有効にする場合は、次の手順に従います。

  1. VM で、管理者としてコマンドプロンプトを開きます。

  2. I/O ドライバーの自動更新を許可するには、次のコマンドを実行します。

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

管理エージェントによる I/O ドライバーの更新の停止

管理エージェントによる I/O ドライバーの更新を防ぐには、次の手順を実行します。

  1. VM で、管理者としてコマンドプロンプトを開きます。

  2. 次のコマンドを実行します。

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

自動再起動

更新の一環として、要求されたすべての VM 再起動が完了していることを確認してください。複数の再起動が必要になる場合があります。要求されたすべての再起動が完了しない場合、予期しない動作を示す可能性があります。

デバイスマネージャーまたは Windows Update を介してドライバーをインストールする際に実行される自動再起動の最大数を指定するレジストリキーを設定できます。xenbus ドライバーバージョン 9.1.1.8 以降をインストールすると、Windows 用 XenServer VM Tools はこのレジストリキーによって提供されるガイダンスを使用します。以前のバージョンの xenbus を使用している場合、予期しない動作が発生する可能性があります。この場合、XenCenter から VM を再起動します。

この機能を使用するには、できるだけ早く次のレジストリキーを設定することをお勧めします: HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters\Autoreboot。レジストリキーの値は正の整数である必要があります。レジストリキーの再起動回数を 3 に設定することをお勧めします。

このレジストリキーが設定されている場合、Windows 用 XenServer VM Tools は、更新を完了するために必要な再起動回数、またはレジストリキーで指定された再起動回数のいずれか少ない方の回数だけ再起動を実行します。

各再起動の前に、Windows は今後の再起動を警告する 60 秒間のアラートを表示できます。このアラートを閉じることができますが、このアクションによって再起動がキャンセルされることはありません。再起動間のこの遅延のため、最初の再起動後数分間待ってから再起動サイクルが完了するのを待ちます。

注記:

  • この設定は、静的 IP アドレスを持つヘッドレスサーバーに必要です。

  • この自動再起動機能は、デバイスマネージャーまたは Windows Update を介した Windows I/O ドライバーの更新にのみ適用されます。管理エージェントインストーラーを使用してドライバーを展開している場合、インストーラーはこのレジストリキーを無視し、独自の構成に従って VM の再起動を管理します。

  • すべての再起動が完了するのを待っても予期しない動作が引き続き発生する場合は、XenCenter から VM の再起動を開始して、構成を復元してみてください。

コマンドラインを使用した自動再起動の設定

Windows VM で、管理者としてコマンドプロンプトを開き、次のコマンドを実行します。

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

または、Windows VM がリモートアクセスを許可するように構成されている場合は、別のシステムで管理者コマンドプロンプトから次のコマンドを実行できます。

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

詳細については、「reg add Windows コマンド」を参照してください。

レジストリエディターを使用した自動再起動の設定

  1. Windows のスタートメニューからレジストリエディターを開き、キー HKLM\System\CurrentControlSet\services\xenbus_monitor\Parameters​ に移動します。
  2. REG_DWORD 型の新しいサブキーを Autoreboot という名前で作成します。
  3. Autoreboot の値を整数 (例: 3) に設定します。

その他の構成とクエリ

I/O ドライバーバージョンの確認

VM にインストールされている I/O ドライバーのバージョンを確認するには、次の手順を実行します。

  1. C:\Windows\System32\drivers に移動します。

  2. リストからドライバーを見つけます。

  3. ドライバーを右クリックし、[プロパティ]、次に [詳細] を選択します。

    [ファイルバージョン] フィールドに、VM にインストールされているドライバーのバージョンが表示されます。

管理エージェントバージョンの確認

VM にインストールされている管理エージェントのバージョンを確認するには、次の手順を実行します。

  1. C:\Program Files\XenServer\XenTools に移動します。

  2. リストから XenGuestAgent を右クリックし、[プロパティ]、次に [詳細] をクリックします。

    [ファイルバージョン] フィールドに、VM にインストールされている管理エージェントのバージョンが表示されます。

匿名使用状況情報の構成

Windows 用 XenServer VM Tools のインストール中に、匿名使用状況情報を Cloud Software Group, Inc. に送信するかどうかを指定できます。Windows 用 XenServer VM Tools のインストールプロセス完了後にこの設定を更新する場合は、次の手順を実行します。

  1. VM で、管理者としてコマンドプロンプトを開きます。

  2. 次のコマンドを実行します。

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

Windows 用 XenServer VM Tools のトラブルシューティング

XenServer VM Tools の診断情報を取得するツール xtbugtool を提供しています。詳細については、「VM の問題のトラブルシューティング」を参照してください。

XenServer VM Tools のアンインストール

Windows VM から XenServer VM Tools を削除することはお勧めしません。これらのツールは、Windows VM が完全にサポートされるために必要です。これらを削除すると、予期しない動作が発生する可能性があります。XenServer VM Tools の手動アンインストールは、最後の手段としてのみ実行してください。

標準アンインストール

XenServer VM Tools の標準アンインストールを行うには、Windows の [プログラムの追加と削除] 機能を使用できます。

  1. 開始する前に、VM のスナップショットを作成します。
  2. Windows VM で、[プログラムの追加と削除] に移動します。
  3. [XenServer VM Tools] を選択し、[アンインストール] をクリックします。
  4. VM を再起動します。

uninstall.exe コマンド

Windows の [プログラムの追加と削除] 機能を使用して XenServer VM Tools をアンインストールすると、アンインストールアクションを実行するために <tools-install-directory>\uninstall.exe ファイルが呼び出されます。代わりに、PowerShell ターミナルまたは管理者権限を持つコマンドプロンプトからこのコマンドを呼び出すこともできます。

  1. 開始する前に、VM のスナップショットを作成します。
  2. 管理者として、コマンドプロンプトまたは PowerShell ターミナルを開きます。
  3. コマンド <tools-install-directory>\uninstall.exe を実行します。
  4. VM を再起動します。

コマンドオプション

uninstall.exe コマンドは次のパラメーターを受け入れます。

  • help - コマンドの使用状況情報を表示します。
  • log - コマンドが実行した内容を示すログファイルを生成します。
  • verbose - コマンドが実行した内容をコンソールに出力します。
  • disable - インストーラー MSI によってインストールされたドライバーを無効にします。
  • force-disable - すべての状況でドライバーを無効にします。
  • hidden - 非表示のデバイスを削除します。これらのデバイスは未使用であり、置き換えられていますが、古いレジストリエントリが残っている可能性があります。
  • cleanup - [プログラムの追加と削除] から古いアンインストーラーを削除します。これらのアンインストーラーには、古いバージョンのツールからの重複エントリが含まれる場合があります。
  • purge - (9.3.1 以降) VM を、XenServer VM Tools のいずれかの部分がインストールされる前のクリーンな状態にリセットします。詳細については、「すべての XenServer VM Tools コンポーネントの完全アンインストール」を参照してください。
  • install - (9.3.1 以降) 現在の I/O ドライバーセットをインストールし、必要な場合に VM の再起動を促します。
  • reboot - 他のすべてのコマンド操作が完了した後、VM を再起動します。

すべての XenServer VM Tools コンポーネントの完全アンインストール

Windows 用 XenServer VM Tools の最新バージョン (9.3.1 以降) には、uninstall.exe purge コマンドが含まれています。uninstall.exe アプリケーションの purge オプションは、I/O ドライバーがインストールされる前の状態に VM をリセットします。ツールを新しいバージョンにアップグレードする際に問題が発生している場合、または VM に新しいツールセットをインストールするためにクリーンな状態が必要な場合は、このユーティリティを使用してください。

  1. 開始する前に、VM のスナップショットを作成します。
  2. 管理者として、コマンドプロンプトまたは PowerShell ターミナルを開きます。
  3. コマンド <tools-install-directory>\uninstall.exe purge verbose を実行します。
  4. VM を再起動します。

このコマンドを使用した後、以前のバージョンの XenServer VM Tools で必要だったような手動のクリーンアップ手順を実行する必要はありません。XenServer VM Tools に関連するすべての変更が削除されています。

purge オプションで削除されるもの

コマンド uninstall.exe purge を使用すると、XenServer VM Tools のすべての痕跡が Windows VM から削除されます。このコマンドによって実行されるアクションのリストは次のとおりです。

  • サービス:
    • すべての XenServer VM Tools サービスを無効にし、インストールされたドライバーとサービスが再起動時に起動するのを防ぎます。
    • 実行中の XenServer VM Tools サービスを停止します。
  • ドライバー:
    • すべてのデバイスノードから I/O ドライバーをアンインストールします。
    • 非表示のデバイスをアンインストールします。このアクションは、hidden コマンドラインオプションによって実行されるものと同じです。
    • キャッシュされたドライバーパッケージをアンインストールし、ドライバーストアから削除します。その結果、I/O ドライバーは自動的に再インストールされません。
  • レジストリ:
    • サポート対象外のバージョンのドライバーで使用されていた古いレジストリ情報を削除します。
    • HKLM\System\CurrentControlSet\Control\Class\... からツール関連のキーを削除します。
    • HKLM\System\CurrentControlSet\Services からツール関連のキーを削除します。
    • HKLM\System\CurrentControlSet\Enum\... からツール関連のキーを削除します。
  • ファイル:
    • C:\Windows\System32 および C:\Windows\System32\drivers から XenServer VM Tools ドライバーファイルを削除します。
    • C:\Windows\INF から XenServer VM Tools の INF ファイルを削除します。
    • C:\Program Files\Citrix\XenTools および C:\Program Files\XenServer\XenTools から、サポート対象外のバージョンのツールによって残された古いファイルを削除します。
  • その他:
    • [プログラムの追加と削除] の古いエントリを削除します。このアクションは、cleanup コマンドラインオプションによって実行されるものと同じです。
    • InstallAgent の古い状態情報の一部をクリアします。
    • xenfilt.sys を上位フィルターから削除します。この変更により、xenfilt.sys がどのドライバーノードにもロードされなくなります。
    • unplug キーを削除します。これにより、VM は再起動時にエミュレートされたデバイスに戻ります。
    • StorNvme の StartOverride を削除します。この変更により、stornvme.sys が起動時に強制的に開始され、エミュレートされた NVMe (UEFI) ブートデバイスが機能するようになります。

新機能

Windows 用 XenServer VM Tools のバージョンは、XenServer のバージョンとは独立して更新されます。VM および VM の作成に使用するテンプレートの両方で、Windows 用 XenServer VM Tools を常に最新バージョンに更新してください。

Windows 用 XenServer VM Tools の最新バージョンは、XenServer ダウンロードページから入手できます。

XenServer VM Tools for Windows 9.4.1

2025 年 5 月 27 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.4.1
  • 管理エージェント: 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

CTX692748 - XenServer および Citrix Hypervisor セキュリティ速報に記載されている問題の影響を受けるすべてのお客様は、このバージョン以降のツールに更新する必要があります。

このリリースには、収集されたテレメトリへの更新も含まれています。

9.4.1 で修正された問題

このリリースには、次の問題に対する修正が含まれています。

  • 場合によっては、XenServer VM Tools 9.4.0 がインストールされていると、Windows 11 を 23H2 から 24H2 にアップグレードできません。
  • 管理エージェントが VM の再起動時または起動時にクラッシュすることがあります。
  • 一部の Windows VM で予期しない強制再起動が発生する可能性があります。

以前のリリース

9.4.0

2024 年 10 月 22 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.4.0
  • 管理エージェント: 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

このリリースには、次の問題に対する修正が含まれています。

  • 管理エージェントがレジストリ内の誤った InstallStatus 値をチェックするため、Windows 用 XenServer VM Tools のバージョンが Citrix Hypervisor に正しく報告されません。
  • StorNvme の StartOverride レジストリキーの処理が不完全なため、Windows Update を介した XenServer VM Tools の更新中に Windows VM を再起動すると、「Inaccessible Boot Device」エラーで BSOD が発生する可能性があります。
  • Windows 用 XenServer VM Tools を更新する際に、静的 IP 設定が失われ、ネットワーク設定が DHCP を使用するように変更されることがあります。この問題は、バージョン 9.3.3 以降から更新する場合 (たとえば、9.4.0 から新しいバージョンへ) には解決されます。ただし、9.3.3 より前のバージョンから更新する場合 (たとえば、9.3.2 から 9.4.0 へ) は、更新中に一度この問題が発生しますが、将来の更新には影響しません。詳細については、サポート記事「Windows 用 VM Tools 9.3.3 以前への更新時の静的 IP の損失」を参照してください。

このリリースには、次の既知の問題が含まれています。

  • 自動更新のために管理エージェントに依存している場合、9.3.3 は証明書チェックの問題により 9.4.0 に自動的に更新されないため、手動でバージョン 9.4.0 以降に更新する必要があります。これを解決するには、各 VM に Windows 用 XenServer VM Tools 9.4.0 以降のバージョンを手動でインストールします。

9.3.3

2024 年 6 月 4 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.3.3
  • 管理エージェント: 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

このリリースには、次の問題に対する修正が含まれています。

  • VM が高負荷状態にある場合、管理エージェントが ManagementException でクラッシュすることがあります。
  • Windows 2022 Server では、単一の vCPU が CPU を 100% 消費することがあります。その結果、サーバーが応答しなくなります。
  • OpenVSwitch ネットワークと VLAN タグ付きイーサネットフレームを使用するプールでホストされている Windows VM は、ネットワーク接続が不安定になることがあります。

9.3.2

2023 年 11 月 27 日リリース

このリリースでは、Citrix VM Tools が XenServer VM Tools にリブランドされます。

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.3.2
  • 管理エージェント: 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

このリリースには、次の改善も含まれています。

  • uninstall.exe コマンドの改善。
  • XenServer のバージョンと Windows オペレーティングシステムがサポートしている場合、一部の Windows VM で最大 64 vCPU を使用できるようにする変更。

このリリースには、次の問題に対する修正が含まれています。

  • XenServer VM Tools のインストール時に、致命的ではないエラーが原因でインストールが失敗することがあります。

9.3.1

2023 年 1 月 25 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.3.1
  • 管理エージェント: 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

このリリースには、次の改善が含まれています。

  • purge パラメーターを含む uninstall.exe ユーティリティの改善。詳細については、「XenServer VM Tools のアンインストール」を参照してください。
  • XenServer VM Tools インストーラーの全般的な改善。
  • レジストリキーの文字列処理の全般的な改善。

このリリースには、次の問題に対する修正が含まれています。

  • Windows Update を介して XenServer VM Tools が更新されると、静的 IP 設定が失われ、ネットワーク設定が DHCP を使用するように変更されることがあります。
  • Windows VM では、グラントテーブルが簡単に枯渇する可能性があります。この場合、読み取り/書き込み要求が失敗したり、追加の VIF が正しく有効にならずに起動に失敗したりすることがあります。
  • まれに、Windows 用 XenServer VM Tools をアップグレードする際に、既存の管理エージェントがシャットダウンに失敗し、アップグレードが成功しないことがあります。
  • Windows VM で、インストールされているプログラムにツールの以前のバージョンと新しいバージョンの両方、または管理エージェントがリストされている場合があります。
    • (以前) Citrix XenServer Windows Management Agent
    • (以降) Citrix Hypervisor PV Tools ツールを最新バージョンに更新すると、これらの以前の名前はどちらもリストされません。インストールされているプログラムには XenServer VM Tools のみがリストされます。

9.3.0

2022 年 7 月 26 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.3.0
  • 管理エージェント: 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

このリリースには、次の改善が含まれています。

  • XenServer VM Tools インストーラーの全般的な改善。

このリリースには、次の問題に対する修正が含まれています。

  • セキュリティソフトウェアが、データ流出防止策として、取り外し可能とマークされたセカンダリディスクが OS に公開されるのをブロックしていました。この更新により、VBD を取り外し不可としてフラグ付けし、OS を介してこれを正しく公開できるようになります。
  • Windows VM で、SR-IOV VIF の IP アドレスが XenCenter に表示されないことがあります。

9.2.3

2022 年 4 月 28 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.2.3
  • 管理エージェント: 9.1.1.13
  • xenbus: 9.1.3.30
  • xeniface: 9.1.4.34
  • xennet:
    • 9.1.1.8 (Windows Server 2012 および Windows Server 2012 R2 用)
    • 9.1.2.23 (その他すべてのサポート対象 Windows オペレーティングシステム用)
  • xenvbd: 9.1.2.20
  • xenvif: 9.1.5.48

このリリースには、次の問題に対する修正が含まれています。

  • Windows 用 XenServer VM Tools バージョン 9.2.2 では、時刻同期オプションが利用できません。
  • Citrix Hypervisor 8.2 Cumulative Update 1 でライブマイグレーション後に、競合状態により Windows VM でブルースクリーンエラーが表示されることがあります。
  • XenServer VM Tools のバージョン 9.2.1 または 9.2.2 がインストールされており、PVS ターゲットである Windows VM が、黒い画面でフリーズすることがあります。「Guest Rx stalled」というメッセージが dom0 カーネルログに存在します。この問題は、他のプールメンバーよりもプールコーディネーターでより頻繁に発生します。
  • 8 を超える vCPU を持つ Windows VM では、xenvif ドライバーが間接テーブルの設定に失敗するため、Receive Side Scaling が機能しない場合があります。

9.2.2

2022 年 1 月 14 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.2.2
  • 管理エージェント: 9.1.1.13
  • xenbus: 9.1.3.30
  • xeniface: 9.1.2.22
  • xennet:
    • 9.1.1.8 (Windows Server 2012 および Windows Server 2012 R2 用)
    • 9.1.2.23 (その他すべてのサポート対象 Windows オペレーティングシステム用)
  • xenvbd: 9.1.2.20
  • xenvif: 9.1.3.31

このリリースには、次の問題に対する修正が含まれています。

  • ツールの更新中に、ドライバーのインストールが完了する前に xenbus ドライバーが再起動を促すことがあります。再起動を受け入れると、Windows VM でブルースクリーンエラーが発生する可能性があります。
  • 収集された診断情報を圧縮する際に、xt-bugtool 診断ツールが 20 秒後にタイムアウトします。この動作により、診断 zip ファイルが正しく作成されない可能性があります。
  • VNC クリップボード共有が機能しません。
  • 以前のバージョンのドライバーは Windows Update を介してリリースされていませんでした。

9.2.1

2021 年 6 月 24 日リリース

このツールセットには、次のコンポーネントバージョンが含まれています。

  • インストーラー: 9.2.1
  • 管理エージェント: 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

注記:

このドライバーセットは Windows Update を介して提供されていませんでした。

このリリースには、次の問題に対する修正が含まれています。

  • 場合によっては、VM のラップトップ/スレート状態を変更できません。
  • VM が再起動された後、daemon.log ファイルに過剰なログメッセージを送信し始めることがあります。
  • OS アップグレード後のドライバーロード依存関係における競合状態により、XenServer VM Tools のアップグレードが妨げられることがあります。
  • ストレージエラーにより Windows VM がクラッシュすることがあります。
  • SR-IOV VIF の IP アドレスが XenCenter に表示されないことがあります。この問題を修正するには、VM のサービスマネージャー内から管理エージェントを再起動します。
  • 高いネットワークおよびシステム負荷、および低いリソースの下で、VM は Citrix およびサードパーティ製ドライバーの両方でバグチェック (通常はコード IRQL_NOT_LESS_OR_EQUAL) を経験することがあります。この修正により、これらのバグチェックを防ぐためにネットワークバッファリングが改善されます。
  • Windows I/O ドライバーをアップグレードすると、UEFI VM が「0xC000000E. 必要なデバイスが接続されていないか、アクセスできません。」と報告して起動に失敗することがあります。
  • 以前のバージョンの XenServer VM Tools をアンインストールした後に XenServer VM Tools をインストールすると、「このデバイスを開始できません (コード 10) (操作が失敗しました) 要求された操作は成功しませんでした」というエラーメッセージが返される問題が発生することがあります。
XenServer VM Tools for Windows
June 2, 2025
寄稿者: 
X
June 2, 2025
寄稿者: 
X

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.