Windows 用 Network Watcher Agent 仮想マシン拡張機能の管理

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

Network Watcher エージェントの仮想マシン拡張機能は、Azure 仮想マシン (VM) を診断および監視するためのネットワークトラフィックをキャプチャする一部の Azure Network Watcher 機能の要件です。詳細については、「Azure Network Watcher とは」を参照してください。

この記事では、Windows 用 Network Watcher エージェントをインストールしてアンインストールする方法について説明します。エージェントのインストールによって、仮想マシンが中断されることも、再起動が必要になることもありません。仮想マシンが Azure サービスによってデプロイされる場合は、サービスのドキュメントを調べて、仮想マシンへの拡張機能のインストールが許可されるかどうかを確認します。

前提条件

Azure Windows 仮想マシン (VM) です。詳細については、「サポート対象の Windows バージョン」を参照してください。
port 80 経由で 169.254.169.254、port 8037 経由で 168.63.129.16 への送信 TCP 接続です。エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。たとえば、パケットキャプチャをアップロードするには、ストレージアカウントへの接続が必要です。詳細については、「パケットキャプチャの概要」を参照してください。

Azure Windows 仮想マシン (VM) です。詳細については、「サポート対象の Windows バージョン」を参照してください。
port 80 経由で 169.254.169.254、port 8037 経由で 168.63.129.16 への送信 TCP 接続です。エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。たとえば、パケットキャプチャをアップロードするには、ストレージアカウントへの接続が必要です。詳細については、「パケットキャプチャの概要」を参照してください。
Azure Cloud Shell または Azure PowerShell。

この記事の手順では、Azure Cloud Shell で Azure PowerShell コマンドレットを対話型で実行します。 Cloud Shell でコマンドを実行するには、コードブロックの右上隅にある [Cloud Shell を開く] を選択します。 [コピー] を選択してコードをコピーし、続いて Cloud Shell に貼り付けて実行します。 Azure portal 内から Cloud Shell を実行することもできます。

また、Azure PowerShell をローカルにインストールしてコマンドレットを実行することもできます。 PowerShell をローカルで実行している場合は、Connect-AzAccount コマンドレットを使用して Azure にサインインします。

Azure Windows 仮想マシン (VM) です。詳細については、「サポート対象の Windows バージョン」を参照してください。
port 80 経由で 169.254.169.254、port 8037 経由で 168.63.129.16 への送信 TCP 接続です。エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。たとえば、パケットキャプチャをアップロードするには、ストレージアカウントへの接続が必要です。詳細については、「パケットキャプチャの概要」を参照してください。
Azure Cloud Shell または Azure CLI。

この記事の手順では、Azure Cloud Shell で Azure CLI コマンドを対話型で実行します。 Cloud Shell でコマンドを実行するには、コードブロックの右上隅にある [Cloud Shell を開く] を選択します。 [コピー] を選択してコードをコピーし、Cloud Shell に貼り付けて実行します。 Azure portal 内から Cloud Shell を実行することもできます。

また、Azure CLI をローカルにインストールしてコマンドを実行することもできます。 Azure CLI をローカルで実行する場合は、az login コマンドを使用して Azure にサインインします。

Azure Windows 仮想マシン (VM) です。詳細については、「サポート対象の Windows バージョン」を参照してください。
port 80 経由で 169.254.169.254、port 8037 経由で 168.63.129.16 への送信 TCP 接続です。エージェントは、これらの IP アドレスを使用して Azure プラットフォームと通信します。
インターネット接続: 一部の機能が正常に機能するためには、Network Watcher エージェントにインターネット接続が必要です。たとえば、パケットキャプチャをアップロードするには、ストレージアカウントへの接続が必要です。詳細については、「パケットキャプチャの概要」を参照してください。
テンプレートをデプロイするためにローカルにインストールされた Azure PowerShell または Azure CLI です。
- Azure PowerShell をローカルにインストールしてコマンドレットを実行できます。 Connect-AzAccount コマンドレットを使用して Azure にサインインします。
- Azure CLI をインストールしてコマンドを実行できます。 az login コマンドを使用して Azure にサインインします。

サポートされるオペレーティングシステム

Windows 用の Network Watcher Agent 拡張機能は、Windows Server 2012、2012 R2、2016、2019、2022 の各リリースにインストールできます。現在、Nano Server はサポートされていません。

拡張機能のスキーマ

次の JSON は、Network Watcher Agent 拡張機能のスキーマを示しています。この拡張機能はユーザーが指定した設定を必要とせず、サポートもしていません。既定の構成が使用されます。

{
    "name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
    "type": "Microsoft.Compute/virtualMachines/extensions",
    "apiVersion": "2023-03-01",
    "location": "[resourceGroup().location]",
    "dependsOn": [
        "[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
    ],
    "properties": {
        "autoUpgradeMinorVersion": true,
        "publisher": "Microsoft.Azure.NetworkWatcher",
        "type": "NetworkWatcherAgentWindows",
        "typeHandlerVersion": "1.4"
    }
}

インストールされている拡張機能を一覧表示する

Azure portal の仮想マシンに関するページから、次の手順に従ってインストールされている拡張機能を表示できます:

[設定] で [拡張機能とアプリケーション] を選択します。
[拡張機能] タブには、仮想マシンにインストールされているすべての拡張機能が表示されます。リストが長い場合は、検索ボックスを使用してリストをフィルター処理できます。

Get-AzVMExtension コマンドレット使用して、仮想マシンにインストールされているすべての拡張機能を一覧表示します:

# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade

コマンドレットの出力には、インストールされている拡張機能が一覧表示されます:

Name                         Publisher                      ExtensionType              AutoUpgradeMinorVersion EnableAutomaticUpgrade
----                         ---------                      -------------              ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentWindows                    True                   True

az vm extension list コマンド使用して、仮想マシンにインストールされているすべての拡張機能を一覧表示します:

# List the installed extensions on the virtual machine.
az vm extension list --resource-group 'myResourceGroup' --vm-name 'myVM' --out table

このコマンドの出力には、インストールされている拡張機能が一覧表示されます:

Name                          ProvisioningState    Publisher                       Version    AutoUpgradeMinorVersion
----------------------------  -------------------  ------------------------------  ---------  -------------------------
AzureNetworkWatcherExtension  Succeeded            Microsoft.Azure.NetworkWatcher  1.4        True

Linux 用 Network Watcher Agent VM 拡張機能のインストール

Azure portal の仮想マシンに関するページから、次の手順に従って Network Watcher Agent VM 拡張機能をインストールできます:

[設定] で [拡張機能とアプリケーション] を選択します。
[+ 追加] を選択し、Network Watcher エージェントを検索してインストールします。拡張機能が既にインストールされている場合は、拡張機能の一覧に表示されます。
[拡張機能のインストール] の検索ボックスに、「Windows 用 Network Watcher エージェント」と入力します。リストから拡張機能を選択し、[次へ] を選択します。
[確認と作成]、[作成] の順に選択します。

Set-AzVMExtension コマンドレット使用して、Network Watcher Agent VM 拡張機能を仮想マシンにインストールします:

# Install Network Watcher Agent for Windows on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentWindows' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'

インストールが正常に完了すると、次の出力が表示されます:

RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
                         True         OK

az vm extension set コマンド使用して、Network Watcher Agent VM 拡張機能を仮想マシンにインストールします:

# Install Network Watcher Agent for Windows on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentWindows' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'

次の Azure Resource Manager テンプレート (ARM テンプレート) を使用して、Network Watcher Agent VM 拡張機能を Windows 仮想マシンにインストールします:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "vmName": {
                "type": "string"
            }
    },
    "variables": {},
    "resources": [
        {
                "name": "[parameters('vmName')]",
                "type": "Microsoft.Compute/virtualMachines",
                "apiVersion": "2023-03-01",
                "location": "[resourceGroup().location]",
                "properties": {
                }
            },
            {
                "name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
                "type": "Microsoft.Compute/virtualMachines/extensions",
                "apiVersion": "2023-03-01",
                "location": "[resourceGroup().location]",
                "dependsOn": [
                    "[concat('Microsoft.Compute/virtualMachines/', parameters('vmName'))]"
                ],
                "properties": {
                    "autoUpgradeMinorVersion": true,
                    "publisher": "Microsoft.Azure.NetworkWatcher",
                    "type": "NetworkWatcherAgentWindows",
                    "typeHandlerVersion": "1.4"
                }
            }
    ],
    "outputs": {}
}

Azure PowerShell または Azure CLI を使用して、Resource Manager テンプレートをデプロイできます:

# Deploy the JSON template file using Azure PowerShell.
New-AzResourceGroupDeployment -ResourceGroupName 'myResourceGroup' -TemplateFile 'agent.json'

# Deploy the JSON template file using the Azure CLI.
az deployment group create --resource-group 'myResourceGroup' --template-file 'agent.json'

Network Watcher Agent VM 拡張機能のアンインストール

Azure portal の仮想マシンに関するページから、次の手順に従って Network Watcher Agent VM 拡張機能をアンインストールできます:

[設定] で [拡張機能とアプリケーション] を選択します。
拡張機能一覧から AzureNetworkWatcherExtension を選択し、[アンインストール] を選択します。

Note

AzureNetworkWatcherExtension とは異なる名前の Network Watcher Agent VM 拡張機能が表示される場合があります。

Remove-AzVMExtension コマンドレットを使用して、Network Watcher Agent VM 拡張機能を仮想マシンから削除します:

# Uninstall Network Watcher Agent VM extension.
Remove-AzureVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'

az vm extension delete コマンドを使用して、Network Watcher Agent VM 拡張機能を仮想マシンから削除します:

# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'

よく寄せられる質問 (FAQ)

Network Watcher エージェントに関してよく寄せられる質問に対する回答については、「Network Watcher エージェントに関する FAQ」を参照してください。