オフラインモードでの Azure 仮想マシンエージェントのインストール

[アーティクル]
04/01/2024

Azure 仮想マシンエージェント (VM エージェント) は、ローカル管理者パスワードのリセットやスクリプトのプッシュなどの便利な機能を備えています。この記事では、オフラインの Windows 仮想マシン (VM) に対して VM エージェントをインストールする方法について説明します。

オフラインモードで VM エージェントを使用するタイミング

VM エージェントがインストールされておらず、VM に RDP 接続できない場合は、VM エージェントをオフラインモードでインストールします。

VM に RDP 接続できる場合は、 VM エージェントを手動でダウンロードしてインストールするだけで済みます。

オフラインモードで VM エージェントをインストールする方法

オフラインモードで VM エージェントをインストールするには、次の手順に従います。

手順 1: VM の OS ディスクをデータディスクとして別の VM に接続する

影響のあった VM の OS ディスクのスナップショットを取得し、スナップショットからディスクを作成して、トラブルシューティング用 VM にディスクをアタッチします。詳細については、Azure portal を使用した OS ディスクの復旧 VM へのアタッチによる Windows VM のトラブルシューティングに関するページを参照してください。クラシック VM の場合は、VM を削除して OS ディスクを保持し、OS ディスクをトラブルシューティング用 VM に接続します。
トラブルシューティングツール VM に接続します。 [コンピューターの管理]>[ディスクの管理] の順に開きます。 OS ディスクがオンラインであり、ドライブ文字がディスクパーティションに割り当てられていることを確認します。

手順 2: OS ディスクを変更して Azure VM エージェントをインストールする

トラブルシューティングツール VM へのリモートデスクトップ接続を作成します。
トラブルシューティングツール VM で、アタッチした OS ディスクを参照し、 \windows\system32\config フォルダーを 開きます。ロールバックが必要な場合に備えて、このフォルダーのすべてのファイルをバックアップとしてコピーします。
レジストリエディター (regedit.exe) を起動します。
HKEY_LOCAL_MACHINE キーを選択します。メニューで、 [ファイル]>[ハイブの読み込み] を選択します。
接続した OS ディスクで、 \windows\system32\config\SYSTEM フォルダーを参照します。ハイブの名前として、「BROKENSYSTEM」と入力します。 HKEY_LOCAL_MACHINE キーの下に、新しいレジストリハイブが表示されます。
アタッチされた OS ディスクに VM エージェントがインストールされている場合は、現在の構成のバックアップを実行します。 VM エージェントがインストールされていない場合は、次の手順に進みます。
1. \windowsazure フォルダーの名前を \windowsazure.old に変更します。
2. 次のレジストリをエクスポートします。
  - HKEY_LOCAL_MACHINE\BROKENSYSTEM\ControlSet001\Services\WindowsAzureGuestAgent
  - HKEY_LOCAL_MACHINE\BROKENSYSTEM\ControlSet001\Services\RdAgent
トラブルシューティングツール VM 上の既存のファイルを、VM エージェントのインストール用リポジトリとして使用します。次の手順を実行します。
1. トラブルシューティングツール VM から、次のサブキーをレジストリ形式 (.reg) でエクスポートします。
  - HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\WindowsAzureGuestAgent
  - HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\RdAgent
2. レジストリファイルを編集します。各ファイルで、(次の図に示すように) エントリ値 SYSTEM を BROKENSYSTEM に変更し、ファイルを保存します。現在の VM エージェントの ImagePath を思い出してください。該当するフォルダーを、接続された OS ディスクにコピーする必要があります。
3. 各レジストリファイルをダブルクリックして、レジストリファイルをリポジトリにインポートします。
4. 次のサブキーが BROKENSYSTEM Hive に正常にインポートされていることを確認します。
  - WindowsAzureGuestAgent
  - RdAgent
5. 接続された OS ディスクに、現在の VM エージェントのインストールフォルダーをコピーします。
  1. アタッチした OS ディスクで、ルートパスに WindowsAzure という名前のフォルダーを作成します。
  2. トラブルシューティングツール VM で C:\WindowsAzure に移動し、 C:\WindowsAzure\GuestAgent_X.X.XXXX.XXX という名前のフォルダーを探します。最新バージョン番号を持つ GuestAgent フォルダーを C:\WindowsAzure から、接続されている OS ディスク内の WindowsAzure フォルダーにコピーします。コピーするフォルダーがわからない場合は、すべての GuestAgent フォルダーを コピーします。次の図は、接続されている OS ディスクにコピーされる GuestAgent フォルダーの例を示しています。 GuestAgent フォルダーが見つからない場合は、正確なパスの windowsAzureGuestAgent レジストリサブキーの imagePath にチェックします。
[BROKENSYSTEM] を選択します。メニューから [ファイルアンロード Hive] を選択します>。
OS ディスクをデタッチした後、影響のあった VM 用の OS ディスクを変更します。クラシック VM の場合は、修復された OS ディスクを使用して新しい VM を作成します。
VM にアクセスします。 RdAgent が実行されていて、ログが生成されていることがわかります。

Resource Manager デプロイモデルを使用して VM を作成した場合は、これで完了です。

クラシック VM での ProvisionGuestAgent プロパティの使用

重要

クラシック VM は 2023 年 9 月 1 日に廃止されます

ASM の IaaS リソースを使用する場合は、2023 年 9 月 1 日までに移行を完了してください。 Azure Resource Manager の多くの機能拡張を利用するには、切り替えを早めに行うことをお勧めします。

詳細については、「2023 年 9 月 1 日までに IaaS リソースを Azure Resource Manager に移行する」を参照してください。

クラシックモデルを使用して VM を作成した場合は、Azure PowerShell モジュールを使用して ProvisionGuestAgent プロパティを更新します。このプロパティによって、Azure は VM に VM エージェントがインストールされていることを認識します。

ProvisionGuestAgent プロパティを設定するには、Azure PowerShell で次のコマンドを実行します。

$vm = Get-AzureVM –ServiceName <cloud service name> –Name <VM name>
$vm.VM.ProvisionGuestAgent = $true
Update-AzureVM –Name <VM name> –VM $vm.VM –ServiceName <cloud service name>

Get-AzureVM コマンドを実行します。 GuestAgentStatus プロパティにデータが設定されていることがわかります。

Get-AzureVM –ServiceName <cloud service name> –Name <VM name>
GuestAgentStatus:Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus

次の手順

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティサポートにお問い合わせください。 Azure フィードバックコミュニティに製品フィードバックを送信することもできます。

オフライン モードでの Azure 仮想マシン エージェントのインストール

オフライン モードで VM エージェントを使用するタイミング

オフライン モードで VM エージェントをインストールする方法

手順 1: VM の OS ディスクをデータ ディスクとして別の VM に接続する