すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:Vminit のインストール

最終更新日:Jun 22, 2026

Vminit は、Windows オペレーティングシステムを実行する ECS インスタンス用の初期化ツールです。ネットワーク設定、ホスト名設定、カスタムスクリプトの実行を処理します。カスタムイメージに Vminit がない場合は、インスタンスの初期化を正常に完了させるために手動でインストールする必要があります。このトピックでは、イメージ作成に使用する仮想マシンに Vminit をインストールする方法について説明します。

制限事項

Vminit は、Windows 7、Windows Server 2008 R2、およびそれ以降のオペレーティングシステムの 32 ビット版と 64 ビット版をサポートしています。

Vminit のインストール

説明

このトピックでは、Vminit バージョン 2.0.1.2 を例として使用します。他のバージョンについては、「リリースノート」をご参照ください。

  1. イメージの作成に使用する仮想マシンで、Vminit インストールパッケージをダウンロードして解凍します。

    ダウンロード URL: AliyunVminit.zip

  2. Vminit をインストールします。

    GUI

    1. ダウンロードディレクトリで、AliyunVminit_2.0.1.2_x86_64.exe を見つけてダブルクリックします。

    2. 画面の指示に従います。

      [ライセンス契約] ページで、[I accept the agreement (A)] を選択し、[Next (N)] をクリックしてインストールを続行します。

    3. 完了画面が表示されると、インストールは完了です。

    CLI

    1. Windows PowerShell で、パッケージをダウンロードしたディレクトリ (例: C:\test) に移動します。

      cd C:\test
    2. 次のコマンドを実行して Vminit をインストールします。

      .\AliyunVminit_2.0.1.2_x86_64.exe /SILENT /FORCE
      説明
      • /SILENT: サイレントインストールを有効にします。

      • /FORCE: 既存のインストールを強制的に上書きします。

  3. Vminit のインストールを検証します。

    1. Windows PowerShell で、次のコマンドを実行して Vminit のバージョン番号を確認します。

      (Get-Item C:\ProgramData\aliyun\vminit\vminit.exe).VersionInfo.ProductVersion

      次のようなバージョン番号が返された場合、インストールは成功です。

      PS C:\...> (Get-Item C:\ProgramData\aliyun\vminit\vminit.exe).VersionInfo.ProductVersion
      2.0.1.2
    2. 次のコマンドを実行して、Vminit 関連のレジストリ設定情報を取得します。

      Get-ItemProperty  -Path "HKLM:\SYSTEM\CurrentControlSet\Services\vminit"

      次のような情報が返された場合、インストールは成功です。

      PS C:\test> Get-ItemProperty  -Path "HKLM:\SYSTEM\CurrentControlSet\Services\vminit"
      ErrorControl  : 1
      start         : 2
      type          : 16
      DisplayName   : Aliyun Vminit Service
      ImagePath     : C:\ProgramData\aliyun\vminit\vminit.exe service
      ObjectName    : LocalSystem
      Description   : Aliyun Windows System Initialization Agent
      PSPath        : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\vminit
      PSParentPath  : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
      PSChildName   : vminit
      PSDrive       : HKLM
      PSProvider    : Microsoft.PowerShell.Core\Registry

    インストールの検証が完了すると、イメージを Alibaba Cloud にインポートする準備が整います。

(オプション) Vminit の設定

インスタンスの作成中、Vminit はデフォルトですべてのプラグインを実行します。カスタムイメージからインスタンスを作成し、起動時に特定の操作を自動的に実行させたくない場合は、イメージの作成時に対応するプラグインを無効にすることができます。

  1. 設定ファイルを作成します。

    C:\ProgramData\aliyun\vminit ディレクトリにファイルを作成します。 ファイルは次の条件を満たす必要があります:

    • ファイル名は customized_config にする必要があります。

    • ファイルに拡張子を付けてはなりません

    • ファイルの内容は JSON 形式である必要があります。

    説明

    ProgramData は通常、隠しディレクトリです。隠しアイテムを表示および管理するには、[隠しファイル、隠しフォルダー、および隠しドライブを表示する] オプションが有効になっていることを確認してください。

  2. 特定のプラグインを無効にします。

    次の例は、インスタンスのホスト名の自動設定とデータディスクの初期化のためのプラグインを無効にする方法を示しています。

    • ホスト名の自動設定とデータディスクの初期化を無効にする

      Alibaba Cloud によるインスタンスのホスト名の自動設定とデータディスクの初期化を望まない場合は、Plugin_Main_ConfigHostnamePlugin_Main_ConfigDisk の両方のプラグインを無効にできます。次の JSON コンテンツを customized_config ファイルにコピーして保存します。

      {
       "disabledPlugins": ["Plugin_Main_ConfigHostname", "Plugin_Main_ConfigDisk"]
      }
説明

後でプラグインを再度有効にする必要がある場合は、customized_config ファイルから対応するエントリを削除してください。

よくある質問

Windows インスタンスが作成中に一度再起動するのはなぜですか?

  • 原因: Windows インスタンスを作成すると、ホスト名を指定しなくても Alibaba Cloud によってデフォルトのホスト名が割り当てられます。Windows では、ホスト名の変更を有効にするためにシステムの再起動が必要です。そのため、作成段階でシステムが再起動します。

  • 解決策: インスタンスのホスト名を自分で設定したい場合は、Plugin_Main_ConfigHostname プラグインを無効にすることでこの問題を解決できます。プラグインを無効にすると、システムがインスタンスにホスト名を自動的に割り当てるのを防ぐことができます。

関連ドキュメント

  • Vminit の詳細については、「Vminit の概要」をご参照ください。

  • Vminit をインストールすると、デフォルトですべてのプラグインが有効になります。インスタンスの起動時に特定の操作を自動的に実行させないようにするには、イメージの作成時に対応するプラグインを無効にします。詳細については、「Vminit の設定」をご参照ください。

  • Windows イメージの作成に使用する仮想マシンに Vminit をインストールした後、virtio ドライバーのインストールも必要になる場合があります。これにより、イメージから作成された ECS インスタンスが virtio 仮想デバイスを正しく識別し、正常に起動することが保証されます。

  • Linux イメージを使用する ECS インスタンスの場合、初期化は cloud-init によって実行されます。詳細については、「cloud-init のインストール」をご参照ください。