Windows ゲスト エージェント (WinGA) の再インストール方法

Last Update: feedback 共有

こんにちは、Azure テクニカル サポート チームの富田です。

お問い合わせでご案内する頻度が多い、Windows ゲスト エージェント (WinGA) の再インストール方法をご案内いたします。
WinGA が正常に動作しなくなった場合に再インストールを行うことで正常動作に戻ることが多くあります。

手順としては下記画像の 2 つのサービスを一旦削除し、インストールを行うシナリオとなります。

ヒント

以前は WindowsAzureTelemetryService というサービスも稼働しておりましたが、2020 年頃のバージョン 2.7.41491.971 から、WindowsAzureTelemetryService は Windows Azure Guest Agent サービスに統合されております。

もしご利用環境に当該サービスが存在する場合は後述のサービス停止、削除手順の引数に WindowsAzureTelemetryService を指定して追加でご実行ください。

再インストール方法

  1. 現在の WinGA をアンインストールします。

    手動で WinGA をインストールしていた場合は、以下の手順でアンインストールをします。
    スタートを右クリックして、「Apps and Features」を選択します。
    下記のように「Windows Azure VM Agent」がインストールされている場合は「Uninstall」を選択してください。

    WinGAが最初からインストールされているイメージを使用した際は、「Windows Azure VM Agent」の表示はありませんのでこの操作は不要です。

  2. 管理者権限でコマンドプロンプトを起動します。

  3. 下記のコマンドでサービスを停止します。

    なお、既に停止していた場合は実施不要となります。
    もしサービスが停止できない場合は、スタート メニューより [サービス] を検索 → 対象のサービスを右クリック → [プロパティ] → スタートアップの種類を [手動] に設定して VM を再起動してから再試行してください。 

    1
    2
    net stop rdagent
    net stop WindowsAzureGuestAgent

  4. 下記コマンドでサービスの削除を行います。

    1
    2
    sc delete rdagent
    sc delete WindowsAzureGuestAgent

  5. インストール前に古いログ等のファイルの移動を行います。

    “C:\WindowsAzure” 内に “OLD” というフォルダを作成します。
    “C:\WindowsAzure” 内に “Packages” または “GuestAgent” で始まるフォルダがあった場合は、作成した “OLD” フォルダに移動させてください。

  6. 下記リンクより最新のインストーラーをダウンロードします。

    https://github.com/Azure/WindowsVMAgent/releases

    最新バージョンの Assets より MSI をダウンロードします。
    通常は amd64 の表記のある MSI をご利用ください。
    もし、ARM64 プロセッサをご利用の場合は arm64 の方をご利用くださいませ。

  7. インストールを行います。

    通常はダウンロードしたインストーラーを実行いただく形で問題ございません。

    もし、インストールに失敗するといったことなどがございましたら、以下の手順でインストールを行い、必要に応じて出力された “C:\VMAgentMSI\msiexec.log” の内容を参照してください。

    ダウンロードしたインストーラーを “C:\VMAgentMSI” に配置し、下記コマンドでインストールを実行します。
    <インストーラーファイル名> はインストーラーのファイル名に合わせて書き換えて実行してください。 

    1
    msiexec.exe /i c:\VMAgentMSI\<インストーラーファイル名> /quiet /L*v c:\VMAgentMSI\msiexec.log

  8. これにてWinGAの再インストールは完了となります。

    なお、サービスが起動するまでに 1,2 分程度かかる場合がございます。

※本情報の内容（添付文書、リンク先などを含む）は、作成日時点でのものであり、予告なく変更される場合があります。