Verwalten der Erweiterung für virtuelle Computer des Network Watcher Agent

Die Network Watcher Agent-Erweiterung für VMs ist eine Voraussetzung für einige Funktionen von Azure Network Watcher, die den Netzwerkverkehr zur Diagnose und Überwachung von Azure-VMs erfassen. Weitere Informationen finden Sie unter Was ist Network Watcher?

In diesem Artikel erfahren Sie, wie Sie den Network Watcher Agent für Windows und Linux installieren, aktualisieren und deinstallieren. Die Installation des Agents führt nicht zu einer Unterbrechung und erfordert keinen Neustart der VM. Wenn die virtuelle Maschine von einem Azure-Dienst bereitgestellt wird, prüfen Sie die Dokumentation des Dienstes, um festzustellen, ob der Dienst die Installation von Erweiterungen in der virtuellen Maschine erlaubt.

Hinweis

Die Network Watcher Agent-Erweiterung wird auf AKS-Clustern nicht unterstützt.

Voraussetzungen

  • Eine Azure Virtual Machine (VM), die ein unterstütztes Betriebssystem ausführt. Weitere Informationen finden Sie unter Unterstützte Betriebssysteme.

  • Ausgehende TCP-Konnektivität zu 169.254.169.254 über port 80 und 168.63.129.16 über port 8037. Der Agent verwendet diese IP-Adressen für die Kommunikation mit der Azure-Plattform.

  • Internetverbindung: Der Network Watcher Agent benötigt eine Internetverbindung, damit einige Funktionen richtig funktionieren. Zum Beispiel ist eine Verbindung zu Ihrem Speicherkonto erforderlich, um Paketerfassungen hochzuladen.

Unterstützte Betriebssysteme

Sie können die Network Watcher Agent-Erweiterung für Windows auf den folgenden Betriebssystemen installieren:

  • Windows Server 2012-, 2012 R2-, 2016-, 2019-, 2022- und 2025-Versionen.
  • Windows 10- und 11-Releases.

Hinweis

Derzeit wird Nano Server nicht unterstützt.

Sie können die Network Watcher Agent-Erweiterung für Linux auf den folgenden Linux-Distributionen installieren:

Verteilung Version
AlmaLinux 9.2
Azure Linux 2.0
CentOS 1 6.10 und 7
Debian 7 und 8
openSUSE Leap 15.1 und höher 42.3+
Oracle Linux 6.10 2, 7, 8 und 9+
Red Hat Enterprise Linux (RHEL) 6.10 3, 7, 8 und 9.2
Rocky Linux 9.1
SUSE Linux Enterprise Server (SLES) 12 und 15 (SP2, SP3 und SP4)
Ubuntu 16+

1 CentOS Linux erreichte sein Lebensende (EOL) am 30. Juni 2024. Weitere Informationen finden Sie im CentOS End-of-Life-Leitfaden.

2Unterstützung für den erweiterten Lebenszyklus (ELS) für Oracle Linux Version 6.X endete am 1. Juli 2024.

3Unterstützung für den erweiterten Lebenszyklus (ELS) für Red Hat Enterprise Linux 6.X endete am 30. Juni 2024.

Hinweis

Die Überwachung des Internet Control Message Protocol (ICMP) wird derzeit im Network Watcher Agent unter Oracle Linux aufgrund bekannter Kernel-Einschränkungen, die spezifisch für die Distribution gelten, nicht unterstützt.

Erweiterungsschema

Der folgende JSON-Code zeigt das Schema für die Network Watcher-Agent-Erweiterung. Die Erweiterung benötigt oder unterstützt keine benutzerdefinierten Einstellungen und basiert auf ihrer Standardkonfiguration.

{
    "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"
    }
}

Auflisten installierter Erweiterungen

Von der Virtual Machine-Seite im Azure-Portal aus können Sie die installierten Erweiterungen ansehen, indem Sie folgende Schritte befolgen:

  1. Wählen Sie unter Einstellungen die Option Erweiterungen und Anwendungen aus.

  2. Auf der Registerkarte Erweiterungen werden alle auf der VM installierten Erweiterungen angezeigt. Wenn die Liste lang ist, verwenden Sie das Suchfeld, um die Liste zu filtern.

    Screenshot, der zeigt, wie installierte Erweiterungen auf einer VM im Azure-Portal angezeigt werden.

    Screenshot, der zeigt, wie installierte Erweiterungen auf einer VM im Azure-Portal angezeigt werden.

Installieren der VM-Erweiterung Network Watcher Agent

Auf der Seite „VM“ im Azure-Portal können Sie die VM-Erweiterung Network Watcher Agent installieren, indem Sie die folgenden Schritte ausführen:

  1. Wählen Sie unter Einstellungen die Option Erweiterungen und Anwendungen aus.

  2. Wählen Sie + Hinzufügen aus, suchen Sie nach Network Watcher Agent, und installieren Sie ihn. Wenn die Erweiterung bereits installiert ist, finden Sie sie in der Liste der Erweiterungen.

    Screenshot der Seite mit den VM-Erweiterungen im Azure-Portal.

  3. Im Suchfeld "Eine Erweiterung installieren" geben Sie den Network Watcher Agent ein, wählen Sie die passende Erweiterung Ihres Betriebssystems aus der Liste aus und wählen Sie dann Nächster.

    Screenshot, der zeigt, wie Network Watcher Agent für Windows im Azure-Portal installiert wird.

    Screenshot, der zeigt, wie Network Watcher Agent für Linux im Azure-Portal installiert wird.

  4. Wählen Sie Überprüfen + erstellen und anschließend Erstellen aus.

Aktualisierung der Network Watcher Agent VM-Erweiterung

Überprüfen der Erweiterungsversion

Die Erweiterungsversion kann über das Azure-Portal, mithilfe der Azure-Befehlszeilenschnittstelle oder per PowerShell überprüft werden.

  1. Gehe im Azure-Portal zu Erweiterungen + Anwendungen deiner VM.

  2. In der Erweiterungsliste prüfen Sie die Versionsspalte für AzureNetworkWatcherExtension. Wenn eine neuere Version verfügbar ist, zeigt die Spalte Neueste Version(Update verfügbar) an.

    Screenshot, der die Network Watcher-Erweiterung zeigt.

Hinweis

Die aktuelle Version der Network Watcher-Erweiterung ist 1.4.4011.1.

Automatisches Upgrade aktivieren

Ein automatisches Upgrade ermöglicht es der Azure-Plattform, die Erweiterung ohne manuelles Eingreifen auf die neueste Version zu aktualisieren. Verwenden Sie die folgenden Schritte, um zu prüfen, ob automatisches Upgrade aktiviert ist, und aktivieren Sie es, falls nicht.

  1. Unter Einstellungen Ihrer VM im Azure-Portal wählen Sie Erweiterungen + Anwendungen.

  2. Wählen Sie AzureNetworkWatcherExtension aus der Liste der Erweiterungen und prüfen Sie die Spalte Automatischer Upgrade-Status .

  3. Wenn es als deaktiviert angezeigt wird, wähle in der Werkzeugleiste "Automatisches Upgrade aktivieren ".

    Screenshot, der die Network Watcher-Erweiterung zeigt.

  4. Klicken Sie auf Ja, um zu bestätigen.

    Screenshot, der den Bestätigungsdialog für das Aktivieren des automatischen Upgrades in der Network Watcher-Erweiterung zeigt.

Hinweis

Nachdem Sie das automatische Upgrade aktiviert haben, aktualisiert Azure die Erweiterung automatisch, ohne dass die virtuelle Maschine neu gestartet werden muss. Dieser Prozess kann bis zu 30 Tage nach der Veröffentlichung einer neuen Version dauern.

Manuell aktualisieren

  1. Unter Einstellungen Ihrer VM im Azure-Portal wählen Sie Erweiterungen + Anwendungen.

  2. Wählen Sie AzureNetworkWatcherExtension aus der Liste der Erweiterungen und wählen Sie dann in der Werkzeugleiste Aktualisieren .

    Screenshot, der die Network Watcher-Erweiterung zeigt.

  3. Klicken Sie auf Ja, um zu bestätigen.

    Screenshot, der den Bestätigungsdialog für die Aktualisierung der Network Watcher-Erweiterung auf die neueste Version zeigt.

  4. Wenn das Update abgeschlossen ist, zeigen die Spalten Version und Neueste Version dieselbe Versionsnummer an.

    Screenshot, der die Network Watcher-Erweiterung nach der Aktualisierung auf die neueste Version zeigt.

Wenn das Update nicht die neueste Version anwendet, entferne die Erweiterung und installiere sie erneut:

  1. Wählen Sie AzureNetworkWatcherExtension aus der Liste der Erweiterungen aus, und wählen Sie dann Deinstallieren aus.
  2. Wählen Sie + Hinzufügen, suchen Sie nach Network Watcher Agent und installieren Sie ihn erneut. Die Plattform installiert automatisch die aktuellste verfügbare Version. Weitere Informationen finden Sie unter Install Network Watcher Agent VM-Erweiterung.

Aktualisierung im großen Maßstab mit einem PowerShell-Skript

Wenn du große Deployments hast, verwende ein PowerShell-Skript, um mehrere VMs in einem Abonnement gleichzeitig zu aktualisieren. Das folgende Skript aktualisiert die Network Watcher-Erweiterung bei allen veralteten VMs in einem Abo:

<#
    .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"
}

Deinstallieren der VM-Erweiterung Network Watcher Agent

Auf der Seite „VM“ im Azure-Portal können Sie die VM-Erweiterung Network Watcher Agent deinstallieren, indem Sie die folgenden Schritte ausführen:

  1. Wählen Sie unter Einstellungen die Option Erweiterungen und Anwendungen aus.

  2. Wählen Sie AzureNetworkWatcherExtension aus der Liste der Erweiterungen aus, und wählen Sie dann Deinstallieren aus.

    Screenshot, der zeigt, wie Network Watcher Agent für Windows im Azure-Portal deinstalliert wird.

    Screenshot, der zeigt, wie Network Watcher Agent für Linux im Azure-Portal deinstalliert wird.

    Hinweis

    Es kann sein, dass die VM-Erweiterung Network Watcher Agent unter einem anderen Namen als AzureNetworkWatcherExtension angezeigt wird.

Häufig gestellte Fragen (FAQ)

Um Antworten auf die am häufigsten gestellten Fragen zum Network Watcher Agent zu erhalten, siehe die Network Watcher Agent FAQ.

Verwandte Inhalte

  • Last updated on