网络观察程序代理虚拟机扩展是某些 Azure 网络观察程序功能所必需的，这些功能捕获网络流量以诊断和监视 Azure 虚拟机 (VM)。 有关详细信息，请参阅 什么是 Azure 网络观察程序？
在本文中，你将学习如何安装和卸载网络观察程序 Agent for Windows 和 Linux。 代理的安装不会中断虚拟机的运行，也不需要重新启动虚拟机。 如果虚拟机是由 Azure 服务部署的，请查看该服务的文档，以确定该服务是否允许在虚拟机中安装扩展。
Note
网络观察程序 Agent 扩展不支持 AKS 集群。
先决条件
一个运行支持操作系统的 Azure 虚拟机（VM）。 更多信息请参见 支持的操作系统。
对 169.254.169.254 的出站 TCP 连接通过 port 80，对 168.63.129.16 的连接通过 port 8037。 该代理使用这些 IP 地址与 Azure 平台进行通信。
Internet 连接：网络观察程序代理需要 Internet 连接才能正常使用某些功能。 例如，系统需要连接到存储帐户才能上传抓包。
一个运行支持操作系统的 Azure 虚拟机（VM）。 更多信息请参见 支持的操作系统。
对 169.254.169.254 的出站 TCP 连接通过 port 80，对 168.63.129.16 的连接通过 port 8037。 该代理使用这些 IP 地址与 Azure 平台进行通信。
Internet 连接：网络观察程序代理需要 Internet 连接才能正常使用某些功能。 例如，系统需要连接到存储帐户才能上传抓包。
Azure CLI。
可以在本地安装 Azure CLI 以运行命令。 如果在本地运行Azure CLI，请使用 az login 命令登录到Azure。
一个运行支持操作系统的 Azure 虚拟机（VM）。 更多信息请参见 支持的操作系统。
对 169.254.169.254 的出站 TCP 连接通过 port 80，对 168.63.129.16 的连接通过 port 8037。 该代理使用这些 IP 地址与 Azure 平台进行通信。
Internet 连接：网络观察程序代理需要 Internet 连接才能正常使用某些功能。 例如，系统需要连接到存储帐户才能上传抓包。
在本地安装 Azure PowerShell 或 Azure CLI 以部署模板。
受支持的操作系统
可在以下版本上安装适用于 Windows 的网络观察程序代理扩展：
- Windows Server 2012、2012 R2、2016、2019、2022 和 2025 版本。
- Windows 10 和 11 版本发布。
扩展架构
以下 JSON 显示了网络观察程序代理扩展的架构。 该扩展既不需要也不支持任何用户提供的设置，而是依赖于其默认配置。
{
"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"
}
}
{
"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": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
列出已安装的扩展
在 Azure 门户的虚拟机页面，您可以按照以下步骤查看已安装的扩展：
在“设置”下，选择“扩展 + 应用程序”。
在“扩展”选项卡中，可以看到虚拟机上所有已安装的扩展。 如果列表太长，可以使用搜索框筛选列表。
使用 Get-AzVMExtension cmdlet 列出虚拟机上所有已安装的扩展：
# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade
cmdlet 的输出将列出已安装的扩展：
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentWindows True True
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentLinux 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
安装 网络观察程序 Agent VM 扩展
在 Azure 门户中的虚拟机页中，可以按照以下步骤安装网络观察程序代理 VM 扩展：
在“设置”下，选择“扩展 + 应用程序”。
选择 + 添加，搜索 网络观察者代理 并安装它。 如果扩展已安装，将显示在扩展列表中。
在“安装扩展”的搜索框中，输入“网络观察程序 Agent”，从列表中选择与你操作系统匹配的扩展，然后选择“下一步”。
选择“查看 + 创建”，然后选择“创建” 。
使用 Set-AzVMExtension cmdlet 在虚拟机上安装网络观察程序代理 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'
# Install Network Watcher Agent for Linux on the virtual machine.
Set-AzVMExtension -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentLinux' -EnableAutomaticUpgrade 1 -TypeHandlerVersion '1.4' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
安装成功完成后，将显示以下输出：
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
使用 az vm extension set 命令在虚拟机上安装 网络观察程序 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'
# Install Network Watcher Agent for Linux on the virtual machine.
az vm extension set --name 'NetworkWatcherAgentLinux' --extension-instance-name 'AzureNetworkWatcherExtension' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true' --version '1.4' --resource-group 'myResourceGroup' --vm-name 'myVM'
使用以下 Azure 资源管理器 模板（ARM 模板）在虚拟机上安装 网络观察程序 Agent VM 扩展：
{
"$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": {}
}
{
"$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": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
],
"outputs": {}
}
可以使用 Azure PowerShell 或 Azure CLI 部署资源管理器模板：
# 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'
卸载 网络观察程序 代理 VM 扩展
你可以在 Azure 门户的虚拟机页上，按照以下步骤卸载 网络观察程序 代理 VM 扩展：
在“设置”下，选择“扩展 + 应用程序”。
从扩展列表中选择 AzureNetworkWatcherExtension，然后选择“卸载”。
Note
你可能会看到 网络观察程序 Agent VM 扩展的名称不同于 AzureNetworkWatcherExtension。
使用 Remove-AzVMExtension cmdlet 从虚拟机中删除 网络观察程序 Agent VM 扩展：
# Uninstall Network Watcher Agent VM extension.
Remove-AzVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
使用 az vm extension delete 命令从虚拟机中删除 网络观察程序 Agent VM 扩展：
# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'
常见问题 (FAQ)
要获取有关网络观察程序代理的最常见问题解答，请参阅网络观察程序代理常见问题解答。
相关内容
