Rozšíření virtuálního počítače agenta Network Watcher je předpokladem některých funkcí služby Azure Network Watcher, které zaznamenávají síťový provoz pro diagnostiku a monitorování virtuálních počítačů Azure. Další informace najdete v tématu Co je Azure Network Watcher?
V tomto článku se naučíte, jak instalovat, aktualizovat a odinstalovat Network Watcher Agent pro Windows a Linux. Instalace agenta nenaruší nebo vyžaduje restartování virtuálního počítače. Pokud je virtuální stroj nasazen službou Azure, zkontrolujte dokumentaci služby, abyste zjistili, zda služba umožňuje instalaci rozšíření do virtuálního stroje.
Note
Rozšíření Network Watcher Agent není na AKS clusterech podporováno.
Předpoklady
Azure virtuální stroj (VM) běžící na podporovaném operačním systému. Pro více informací viz Podporované operační systémy.
Odchozí připojení TCP přes 169.254.169.254 přes port 80 a 168.63.129.16 přes port 8037. Agent používá tyto IP adresy ke komunikaci s platformou Azure.
Internetové připojení: Network Watcher Agent vyžaduje připojení k internetu, aby některé funkce správně fungovaly. Například pro nahrání zachycených paketů je vyžadováno připojení k vašemu účtu úložiště.
Azure virtuální stroj (VM) běžící na podporovaném operačním systému. Pro více informací viz Podporované operační systémy.
Odchozí připojení TCP přes 169.254.169.254 přes port 80 a 168.63.129.16 přes port 8037. Agent používá tyto IP adresy ke komunikaci s platformou Azure.
Internetové připojení: Network Watcher Agent vyžaduje připojení k internetu, aby některé funkce správně fungovaly. Například pro nahrání zachycených paketů je vyžadováno připojení k vašemu účtu úložiště.
Azure Cloud Shell nebo Azure PowerShell.
Kroky v tomto článku spouští rutiny Azure PowerShell interaktivně v Azure Cloud Shell. Pokud chcete příkazy spustit v Cloud Shellu, vyberte Otevřít Cloud Shell v pravém horním rohu bloku kódu. Výběrem možnosti Kopírovat zkopírujte kód a vložte ho do Cloud Shellu a spusťte ho. Cloud Shell můžete spustit také z portálu Azure.
Můžete také nainstalovat Azure PowerShell lokálně a spouštět rutiny. Pokud powershell spouštíte místně, přihlaste se k Azure pomocí rutiny Connect-AzAccount.
Azure virtuální stroj (VM) běžící na podporovaném operačním systému. Pro více informací viz Podporované operační systémy.
Odchozí připojení TCP přes 169.254.169.254 přes port 80 a 168.63.129.16 přes port 8037. Agent používá tyto IP adresy ke komunikaci s platformou Azure.
Internetové připojení: Network Watcher Agent vyžaduje připojení k internetu, aby některé funkce správně fungovaly. Například pro nahrání zachycených paketů je vyžadováno připojení k vašemu účtu úložiště.
Azure Cloud Shell nebo Azure CLI.
Kroky v tomto článku spouští příkazy Azure CLI interaktivně v Azure Cloud Shellu. Pokud chcete příkazy spustit v Cloud Shellu, vyberte Otevřít Cloud Shell v pravém horním rohu bloku kódu. Výběrem Kopírovat zkopírujte kód, vložte ho do Cloud Shellu a spusťte ho. Cloud Shell můžete spustit také z portálu Azure.
Ke spuštění příkazů můžete také nainstalovat Azure CLI místně . Pokud Azure CLI spustíte místně, přihlaste se k Azure pomocí příkazu az login.
Azure virtuální stroj (VM) běžící na podporovaném operačním systému. Pro více informací viz Podporované operační systémy.
Odchozí připojení TCP přes 169.254.169.254 přes port 80 a 168.63.129.16 přes port 8037. Agent používá tyto IP adresy ke komunikaci s platformou Azure.
Internetové připojení: Network Watcher Agent vyžaduje připojení k internetu, aby některé funkce správně fungovaly. Například pro nahrání zachycených paketů je vyžadováno připojení k vašemu účtu úložiště.
Azure PowerShell nebo Azure CLI nainstalované místně pro nasazení šablony.
Podporované operační systémy
Rozšíření Network Watcher Agent pro Windows můžete nainstalovat na následující operační systémy:
- Windows Server 2012, 2012 R2, verze 2016, 2019, 2022 a 2025.
- Vydání Windows 10 a 11.
Note
Nano Server se v současné době nepodporuje.
Rozšíření Network Watcher Agent pro Linux můžete nainstalovat na následující linuxové distribuce:
| Distribution |
Version |
| AlmaLinux |
9.2 |
| Azure Linux |
2.0 |
| CentOS 1 |
6.10 a 7 |
| Debian |
7 a 8 |
| openSUSE Leap |
42.3+ |
| Oracle Linux |
6.10 2, 7, 8 a 9+ |
| Red Hat Enterprise Linux (RHEL) |
6.10 3, 7, 8 a 9.2 |
| Rocky Linux |
9.1 |
| SUSE Linux Enterprise Server (SLES) |
12 a 15 (SP2, SP3 a SP4) |
| Ubuntu |
16+ |
1 CentOS Linux dosáhl konce své životnosti (EOL) 30. června 2024. Další informace najdete v doprovodných materiálech CentOS End Of Life.
2 Podpora rozšířeného životního cyklu (ELS) pro Oracle Linux verze 6.X skončila 1. července 2024.
3 Podporarozšířeného životního cyklu (ELS) pro Red Hat Enterprise Linux 6.X skončila 30. června 2024.
Note
Monitorování protokolu Internet Control Message Protocol (ICMP) není v současnosti podporováno v Network Watcher Agent na Oracle Linux kvůli známým omezením na úrovni jádra specifickými pro tuto distribuci.
Schéma rozšíření
Následující KÓD JSON ukazuje schéma pro rozšíření agenta Network Watcher. Rozšíření nevyžaduje ani nepodporuje žádná uživatelská nastavení a spoléhá na své výchozí konfiguraci.
{
"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"
}
}
Výpis nainstalovaných rozšíření
Na stránce virtuálních strojů v Azure portálu si můžete zobrazit nainstalovaná rozšíření podle těchto kroků:
V části Nastavení vyberte Rozšíření a aplikace.
Na kartě Rozšíření uvidíte všechna nainstalovaná rozšíření na virtuálním počítači. Pokud je seznam dlouhý, použijte vyhledávací pole k jeho filtrování.
Použijte cmdlet Get-AzVMExtension pro zobrazení všech nainstalovaných rozšíření ve virtuálním stroji.
# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade
Výstup rutiny obsahuje seznam nainstalovaných rozšíření:
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentWindows True True
Name Publisher ExtensionType AutoUpgradeMinorVersion EnableAutomaticUpgrade
---- --------- ------------- ----------------------- ----------------------
AzureNetworkWatcherExtension Microsoft.Azure.NetworkWatcher NetworkWatcherAgentLinux True True
Použijte příkaz az VM extension list k vyjmenování všech nainstalovaných rozšíření ve virtuálním stroji.
# List the installed extensions on the virtual machine.
az vm extension list --resource-group 'myResourceGroup' --vm-name 'myVM' --out table
Výstup příkazu zobrazí seznam nainstalovaných rozšíření:
Name ProvisioningState Publisher Version AutoUpgradeMinorVersion
---------------------------- ------------------- ------------------------------ --------- -------------------------
AzureNetworkWatcherExtension Succeeded Microsoft.Azure.NetworkWatcher 1.4 True
Nainstalujte rozšíření agenta Network Watcher pro virtuální počítač
Na stránce virtuálního počítače na webu Azure Portal můžete nainstalovat rozšíření virtuálního počítače agenta Network Watcher pomocí následujícího postupu:
V části Nastavení vyberte Rozšíření a aplikace.
Vyberte + Přidat, vyhledejte Network Watcher Agent a nainstalujte ho. Pokud už je rozšíření nainstalované, můžete ho zobrazit v seznamu rozšíření.
Do vyhledávacího pole Install an Extension zadejte Network Watcher Agent, vyberte odpovídající rozšíření pro váš operační systém ze seznamu a poté vyberte Další.
Vyberte Zkontrolovat + vytvořit a potom Vytvořit.
Použijte cmdlet Set-AzVMExtension k instalaci rozšíření Network Watcher Agent VM na virtuální stroj:
# 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'
Po dokončení instalace uvidíte následující výstup:
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
Použijte příkaz az VM extension set k instalaci rozšíření Network Watcher Agent VM na virtuální stroj:
# 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'
Použijte následující šablonu Azure Resource Manager (ARM šablona) k instalaci rozšíření Network Watcher Agent VM na virtuální stroj:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"resources": [
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2024-07-01",
"location": "[resourceGroup().location]",
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "1.4"
}
}
]
}
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"resources": [
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2024-07-01",
"location": "[resourceGroup().location]",
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
]
}
K nasazení šablony Resource Manageru můžete použít Azure PowerShell nebo 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'
Aktualizuj rozšíření Network Watcher Agent VM
Kontrola verze rozšíření
Verzi rozšíření můžete zkontrolovat pomocí webu Azure Portal, Azure CLI nebo PowerShellu.
Přejděte do Rozšíření + aplikace vašeho VM v Azure portálu.
V seznamu rozšíření zkontrolujte sloupec Version pro AzureNetworkWatcherExtension. Pokud je k dispozici novější verze, sloupec Nejnovější verze ukazuje (Aktualizace dostupná).
Použijte cmdlet Get-AzVM pro kontrolu nainstalované verze rozšíření:
(Get-AzVM -ResourceGroupName 'myResourceGroup' -Name 'myVM' -Status).Extensions | Where-Object { $_.Name -eq 'AzureNetworkWatcherExtension' } | Select-Object Name, TypeHandlerVersion
Použijte cmdlet Get-AzVMExtensionImage k nalezení nejnovější dostupné verze rozšíření pro operační systém a region vašeho VM:
Get-AzVMExtensionImage -Location '<region>' -PublisherName 'Microsoft.Azure.NetworkWatcher' -Type 'NetworkWatcherAgentWindows' | Sort-Object -Property { [Version]$_.Version } -Descending | Select-Object -First 1
Get-AzVMExtensionImage -Location '<region>' -PublisherName 'Microsoft.Azure.NetworkWatcher' -Type 'NetworkWatcherAgentLinux' | Sort-Object -Property { [Version]$_.Version } -Descending | Select-Object -First 1
Použijte příkaz get-instance-view v az VM k ověření nainstalované verze rozšíření:
az vm get-instance-view --resource-group 'myResourceGroup' --name 'myVM' --query "extensions[?name=='AzureNetworkWatcherExtension'].typeHandlerVersion" --output tsv
Použijte příkaz az vm extension image list k vyhledání nejnovější dostupné verze rozšíření pro operační systém vašeho VM:
az vm extension image list --name 'NetworkWatcherAgentWindows' --publisher 'Microsoft.Azure.NetworkWatcher' --latest
az vm extension image list --name 'NetworkWatcherAgentLinux' --publisher 'Microsoft.Azure.NetworkWatcher' --latest
Note
Nejnovější verze rozšíření Network Watcher je 1.4.4011.1.
Zapnout automatický upgrade
Automatická aktualizace umožňuje platformě Azure aktualizovat rozšíření na nejnovější verzi bez manuálního zásahu. Použijte následující kroky, abyste zjistili, zda je automatická aktualizace zapnutá, a pokud není, povolte ji.
V nastavení vašeho VM v portálu Azure vyberte Rozšíření + aplikace.
Vyberte AzureNetworkWatcherExtension ze seznamu rozšíření a zkontrolujte sloupec Automatický stav aktualizace .
Pokud je to označeno jako zakázáno, vyberte na panelu nástrojů Povolit automatickou aktualizaci .
Potvrďte výběrem možnosti Ano.
Použijte cmdlet Get-AzVMExtension k ověření, zda je automatické upgradování zapnuté:
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' | Select-Object Name, EnableAutomaticUpgrade
Pokud je EnableAutomaticUpgradeFalse, použijte cmdlet Set-AzVMExtension k jeho povolení:
Set-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentWindows' -EnableAutomaticUpgrade $true
Set-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -ExtensionType 'NetworkWatcherAgentLinux' -EnableAutomaticUpgrade $true
Použijte příkaz az vm extension show ke kontrole, zda je automatická aktualizace povolená:
az vm extension show --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'AzureNetworkWatcherExtension' --query 'enableAutomaticUpgrade'
Pokud příkaz vrátí false, použijte k jeho povolení příkaz az vm extension set:
az vm extension set --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'NetworkWatcherAgentWindows' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true'
az vm extension set --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'NetworkWatcherAgentLinux' --publisher 'Microsoft.Azure.NetworkWatcher' --enable-auto-upgrade 'true'
Použijte následující šablonu Azure Resource Manager (ARM šablona) pro povolení automatického upgradu rozšíření Network Watcher Agent VM:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"resources": [
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2024-07-01",
"location": "[resourceGroup().location]",
"properties": {
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "1.4"
}
}
]
}
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
}
},
"resources": [
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2024-07-01",
"location": "[resourceGroup().location]",
"properties": {
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "1.4"
}
}
]
}
K nasazení šablony Resource Manageru můžete použít Azure PowerShell nebo 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'
Note
Po zapnutí automatické aktualizace Azure aktualizuje rozšíření automaticky, aniž by bylo nutné restartovat virtuální stroj. Tento proces může trvat až 30 dní po vydání nové verze.
Aktualizovat ručně
V nastavení vašeho VM v portálu Azure vyberte Rozšíření + aplikace.
Vyberte AzureNetworkWatcherExtension ze seznamu rozšíření a poté v panelu nástrojů zvolte Aktualizovat .
Potvrďte výběrem možnosti Ano.
Po dokončení aktualizace sloupce Verze a Nejnovější verze ukazují stejné číslo verze.
Pokud aktualizace neaplikuje nejnovější verzi, odstraňte rozšíření a nainstalujte ho znovu:
- V seznamu rozšíření vyberte AzureNetworkWatcherExtension a pak vyberte Odinstalovat.
- Vyberte + Přidat, vyhledejte Network Watcher Agent a nainstalujte ho znovu. Platforma automaticky instaluje nejnovější dostupnou verzi. Další informace najdete v článku Instalace rozšíření virtuálního počítače agenta Network Watcher.
Použijte cmdlet Set-AzVMExtension s parametrem -ForceRerun pro opětovné použití rozšíření bez nutnosti odinstalovat. Hodnota -ForceRerun musí být při každém spuštění příkazu jiná než její aktuální hodnota, proto použijte hodnotu, která se mění, například aktuální datum a čas:
Set-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -Type 'NetworkWatcherAgentWindows' -ForceRerun (Get-Date -Format o)
Set-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -Type 'NetworkWatcherAgentLinux' -ForceRerun (Get-Date -Format o)
Pokud tato podmínka rozšíření neaktualizuje, odstraňte ho a nainstalujte znovu, abyste získali nejnovější verzi:
Remove-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension'
Set-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -Type 'NetworkWatcherAgentWindows'
Set-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' -Name 'AzureNetworkWatcherExtension' -Publisher 'Microsoft.Azure.NetworkWatcher' -Type 'NetworkWatcherAgentLinux'
Použijte příkaz AZ VM Extension Set s parametrem --force-update pro opětovné použití rozšíření bez odinstalování:
az vm extension set --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'NetworkWatcherAgentWindows' --publisher 'Microsoft.Azure.NetworkWatcher' --force-update
az vm extension set --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'NetworkWatcherAgentLinux' --publisher 'Microsoft.Azure.NetworkWatcher' --force-update
Pokud tato podmínka rozšíření neaktualizuje, odstraňte ho a nainstalujte znovu, abyste získali nejnovější verzi:
az vm extension delete --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'AzureNetworkWatcherExtension'
az vm extension set --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'NetworkWatcherAgentWindows' --publisher 'Microsoft.Azure.NetworkWatcher'
az vm extension set --resource-group 'myResourceGroup' --vm-name 'myVM' --name 'NetworkWatcherAgentLinux' --publisher 'Microsoft.Azure.NetworkWatcher'
Použijte následující šablonu Azure Resource Manager (ARM šablona) k opětovnému použití rozšíření. Aktualizujte typeHandlerVersion parametr na nejnovější verzi, kterou jste identifikovali v Zkontrolujte verzi svého rozšíření a znovu nasadit šablonu:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
},
"typeHandlerVersion": {
"type": "string"
}
},
"resources": [
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2024-07-01",
"location": "[resourceGroup().location]",
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentWindows",
"typeHandlerVersion": "[parameters('typeHandlerVersion')]"
}
}
]
}
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"vmName": {
"type": "string"
},
"typeHandlerVersion": {
"type": "string"
}
},
"resources": [
{
"name": "[concat(parameters('vmName'), '/AzureNetworkWatcherExtension')]",
"type": "Microsoft.Compute/virtualMachines/extensions",
"apiVersion": "2024-07-01",
"location": "[resourceGroup().location]",
"properties": {
"autoUpgradeMinorVersion": true,
"publisher": "Microsoft.Azure.NetworkWatcher",
"type": "NetworkWatcherAgentLinux",
"typeHandlerVersion": "[parameters('typeHandlerVersion')]"
}
}
]
}
K nasazení šablony Resource Manageru můžete použít Azure PowerShell nebo Azure CLI:
# Deploy the JSON template file using Azure PowerShell.
New-AzResourceGroupDeployment -ResourceGroupName 'myResourceGroup' -TemplateFile 'agent.json' -typeHandlerVersion '<version>'
# Deploy the JSON template file using the Azure CLI.
az deployment group create --resource-group 'myResourceGroup' --template-file 'agent.json' --parameters typeHandlerVersion='<version>'
Aktualizace ve velkém měřítku pomocí PowerShell skriptu
Pokud máte rozsáhlá nasazení, použijte PowerShell skript k aktualizaci více VM v rámci předplatného najednou. Následující skript aktualizuje rozšíření Network Watcher na všech zastaralých VM v rámci předplatného:
<#
.SYNOPSIS
This script scans all VMs in the provided subscription and upgrades any out-of-date AzureNetworkWatcherExtensions to the latest available version.
.DESCRIPTION
This script is a no-op if AzureNetworkWatcherExtensions are already up to date.
Requires Azure PowerShell 4.2 or higher to be installed.
.EXAMPLE
.\UpdateVMAgentsInSub.ps1 -SubID aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e -NoUpdate
#>
[CmdletBinding()]
param(
[Parameter(Mandatory=$true)]
[string] $SubID,
[Parameter(Mandatory=$false)]
[Switch] $NoUpdate = $false
)
function Get-LatestExtensionVersion($location, $extensionType)
{
$latestImage = Get-AzVMExtensionImage -Location $location -PublisherName "Microsoft.Azure.NetworkWatcher" -Type $extensionType |
Sort-Object -Property { [Version]$_.Version } -Descending |
Select-Object -First 1
return $latestImage.Version
}
Write-Host "Scanning all VMs in the subscription: $($SubID)"
Set-AzContext -SubscriptionId $SubID
$vms = Get-AzVM
$foundVMs = $false
Write-Host "Starting VM search, this may take a while"
foreach ($vmName in $vms)
{
# Get Detailed VM info
$vm = Get-AzVM -ResourceGroupName $vmName.ResourceGroupName -Name $vmName.name -Status
$isitWindows = $vm.OsName -like "*Windows*"
$type = if ($isitWindows) { "NetworkWatcherAgentWindows" } else { "NetworkWatcherAgentLinux" }
$latestVersion = Get-LatestExtensionVersion -location $vmName.Location -extensionType $type
foreach ($extension in $vm.Extensions)
{
if ($extension.Name -eq "AzureNetworkWatcherExtension")
{
if ([Version]$extension.TypeHandlerVersion -lt [Version]$latestVersion)
{
$foundVMs = $true
if (-not ($NoUpdate))
{
Write-Host "Found VM that needs to be updated: subscriptions/$($SubID)/resourceGroups/$($vm.ResourceGroupName)/providers/Microsoft.Compute/virtualMachines/$($vm.Name) -> Updating to $latestVersion " -NoNewline
Remove-AzVMExtension -ResourceGroupName $vm.ResourceGroupName -VMName $vm.Name -Name "AzureNetworkWatcherExtension" -Force
Write-Host "... " -NoNewline
Set-AzVMExtension -ResourceGroupName $vm.ResourceGroupName -Location $vmName.Location -VMName $vm.Name -Name "AzureNetworkWatcherExtension" -Publisher "Microsoft.Azure.NetworkWatcher" -Type $type -TypeHandlerVersion $latestVersion
Write-Host "Done"
}
else
{
Write-Host "Found $(if ($isitWindows) {"Windows"} else {"Linux"}) VM that needs to be updated to $($latestVersion): subscriptions/$($SubID)/resourceGroups/$($vm.ResourceGroupName)/providers/Microsoft.Compute/virtualMachines/$($vm.Name)"
}
}
}
}
}
if ($foundVMs)
{
Write-Host "Finished $(if ($NoUpdate) {"searching"} else {"updating"}) out of date AzureNetworkWatcherExtension on VMs"
}
else
{
Write-Host "All AzureNetworkWatcherExtensions up to date"
}
Odinstalujte rozšíření agenta VM pro Network Watcher
Na stránce virtuálního počítače na webu Azure Portal můžete odinstalovat rozšíření virtuálního počítače agenta Network Watcher pomocí následujícího postupu:
V části Nastavení vyberte Rozšíření a aplikace.
V seznamu rozšíření vyberte AzureNetworkWatcherExtension a pak vyberte Odinstalovat.
Note
Může se stát, že rozšíření virtuálního počítače agenta Network Watcher má jiný název než AzureNetworkWatcherExtension.
Použijte příkaz Remove-AzVMExtension k odstranění rozšíření Network Watcher Agent VM z virtuálního stroje:
# Uninstall Network Watcher Agent VM extension.
Remove-AzVMExtension -Name 'AzureNetworkWatcherExtension' -ResourceGroupName 'myResourceGroup' -VMName 'myVM'
Použijte příkaz az VM extension delete k odstranění rozšíření Network Watcher Agent VM z virtuálního stroje:
# Uninstall Network Watcher Agent VM extension.
az vm extension delete --name 'AzureNetworkWatcherExtension' --resource-group 'myResourceGroup' --vm-name 'myVM'
Často kladené otázky (FAQ)
Pro odpovědi na nejčastější otázky ohledně Network Watcher Agent si přečtěte Network Watcher Agent FAQ.
Související obsah