Zarządzanie rozszerzeniem maszyny wirtualnej Network Watcher Agent

Rozszerzenie maszyny wirtualnej agenta usługi Network Watcher jest wymagane w przypadku niektórych funkcji usługi Azure Network Watcher, które przechwytują ruch sieciowy w celu diagnozowania i monitorowania maszyn wirtualnych platformy Azure. Aby uzyskać więcej informacji, zobacz Co to jest usługa Azure Network Watcher?

W tym artykule dowiesz się, jak zainstalować i odinstalować Network Watcher Agent dla Windows i Linux. Instalacja agenta nie zakłóca ani nie wymaga ponownego uruchomienia maszyny wirtualnej. Jeśli maszyna wirtualna jest wdrażana przez usługę Azure, sprawdź dokumentację tej usługi, aby ustalić, czy usługa pozwala na instalację rozszerzeń w maszynie wirtualnej.

Note

Rozszerzenie Network Watcher Agent nie jest obsługiwane na klastrzach AKS.

Wymagania wstępne

Wirtualna maszyna Azure (VM) działająca na obsługiwanym systemie operacyjnym. Więcej informacji można znaleźć w sekcji Obsługiwane systemy operacyjne.
Wychodząca łączność TCP z 169.254.169.254 za pośrednictwem port 80 i 168.63.129.16 za pośrednictwem port 8037. Agent używa tych adresów IP do komunikowania się z platformą Azure.
Łączność z Internetem: Agent usługi Network Watcher wymaga łączności z Internetem, aby niektóre funkcje działały prawidłowo. Na przykład wymaga łączności z kontem magazynu w celu przesyłania przechwyconych pakietów.

Wirtualna maszyna Azure (VM) działająca na obsługiwanym systemie operacyjnym. Więcej informacji można znaleźć w sekcji Obsługiwane systemy operacyjne.
Wychodząca łączność TCP z 169.254.169.254 za pośrednictwem port 80 i 168.63.129.16 za pośrednictwem port 8037. Agent używa tych adresów IP do komunikowania się z platformą Azure.
Łączność z Internetem: Agent usługi Network Watcher wymaga łączności z Internetem, aby niektóre funkcje działały prawidłowo. Na przykład wymaga łączności z kontem magazynu w celu przesyłania przechwyconych pakietów.
Azure Cloud Shell lub Azure PowerShell.

Kroki opisane w tym artykule umożliwiają interaktywne uruchamianie poleceń cmdlet Azure PowerShell w Azure Cloud Shell. Aby uruchomić polecenia w usłudze Cloud Shell, wybierz pozycję Otwórz usługę Cloud Shell w prawym górnym rogu bloku kodu. Wybierz pozycję Copy aby skopiować kod, a następnie wklej go do Cloud Shell, aby go uruchomić. Możesz również uruchomić Cloud Shell z poziomu portalu Azure.

Możesz również zainstalować program Azure PowerShell lokalnie , aby uruchomić polecenia cmdlet. Jeśli uruchomisz program PowerShell lokalnie, zaloguj się do Azure przy użyciu polecenia cmdlet Connect-AzAccount.

Wirtualna maszyna Azure (VM) działająca na obsługiwanym systemie operacyjnym. Więcej informacji można znaleźć w sekcji Obsługiwane systemy operacyjne.
Wychodząca łączność TCP z 169.254.169.254 za pośrednictwem port 80 i 168.63.129.16 za pośrednictwem port 8037. Agent używa tych adresów IP do komunikowania się z platformą Azure.
Łączność z Internetem: Agent usługi Network Watcher wymaga łączności z Internetem, aby niektóre funkcje działały prawidłowo. Na przykład wymaga łączności z kontem magazynu w celu przesyłania przechwyconych pakietów.
Azure Cloud Shell lub Azure CLI.

Kroki opisane w tym artykule umożliwiają interaktywne uruchamianie poleceń Azure CLI w Azure Cloud Shell. Aby uruchomić polecenia w usłudze Cloud Shell, wybierz pozycję Otwórz usługę Cloud Shell w prawym górnym rogu bloku kodu. Wybierz pozycję Copy aby skopiować kod, i wklej go do Cloud Shell, aby go uruchomić. Możesz również uruchomić Cloud Shell z poziomu portalu Azure.

Możesz również instalować Azure CLI lokalnie aby uruchomić polecenia. Jeśli uruchamiasz Azure CLI lokalnie, zaloguj się do Azure używając polecenia az login.

Wirtualna maszyna Azure (VM) działająca na obsługiwanym systemie operacyjnym. Więcej informacji można znaleźć w sekcji Obsługiwane systemy operacyjne.
Wychodząca łączność TCP z 169.254.169.254 za pośrednictwem port 80 i 168.63.129.16 za pośrednictwem port 8037. Agent używa tych adresów IP do komunikowania się z platformą Azure.
Łączność z Internetem: Agent usługi Network Watcher wymaga łączności z Internetem, aby niektóre funkcje działały prawidłowo. Na przykład wymaga łączności z kontem magazynu w celu przesyłania przechwyconych pakietów.
Program Azure PowerShell lub interfejs wiersza polecenia platformy Azure zainstalowany lokalnie w celu wdrożenia szablonu.
- Aby uruchomić polecenia cmdlet, możesz zainstalować program Azure PowerShell . Użyj cmdlet Connect-AzAccount, aby zalogować się do platformy Azure.
- Aby uruchomić polecenia, możesz zainstalować interfejs wiersza polecenia platformy Azure. Użyj polecenia az login, aby zalogować się do platformy Azure.

Obsługiwane systemy operacyjne

Rozszerzenie agenta usługi Network Watcher dla systemu Windows można zainstalować na:

Wersje systemu Windows Server 2012, 2012 R2, 2016, 2019, 2022 i 2025.
Wersje systemu Windows 10 i 11.

Note

Obecnie serwer Nano Server nie jest obsługiwany.

Możesz zainstalować rozszerzenie Network Watcher Agent dla Linuksa na następujących dystrybucjach Linuksa:

Distribution	Version
AlmaLinux	9.2
Azure Linux	2.0
CentOS ¹	6.10 i 7
Debian	7 i 8
openSUSE Leap	42.3+
Oracle Linux	6.10 ², 7, 8 i 9+
Red Hat Enterprise Linux (RHEL)	6.10 ³, 7, 8 i 9.2
Rocky Linux	9.1
SUSE Linux Enterprise Server (SLES)	12 i 15 (SP2, SP3 i SP4)
Ubuntu	16+

¹ CentOS Linux osiągnął koniec swojego życia (EOL) 30 czerwca 2024 roku. Aby uzyskać więcej informacji, zobacz wskazówki dotyczące zakończenia życia systemu CentOS.

²Rozszerzona obsługa cyklu życia (ELS) dla systemu Oracle Linux w wersji 6.X zakończyła się 1 lipca 2024 r.

³Wsparcie rozszerzonego cyklu życia (ELS) dla systemu Red Hat Enterprise Linux 6.X zakończyło się 30 czerwca 2024 r.

Note

Monitorowanie protokołu Internet Control Message Protocol (ICMP) nie jest obecnie obsługiwane w Network Watcher Agent na Oracle Linux ze względu na znane ograniczenia na poziomie jądra specyficzne dla dystrybucji.

Schemat rozszerzenia

Poniższy kod JSON przedstawia schemat rozszerzenia agenta usługi Network Watcher. Rozszerzenie nie wymaga ani nie obsługuje żadnych ustawień dostarczonych przez użytkownika i opiera się na konfiguracji domyślnej.

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

Wyświetlanie listy zainstalowanych rozszerzeń

Na stronie maszyny wirtualnej w portalu Azure możesz zobaczyć zainstalowane rozszerzenia, wykonując następujące kroki:

W obszarze Ustawienia wybierz Rozszerzenia i aplikacje.
Na karcie Rozszerzenia można wyświetlić wszystkie zainstalowane rozszerzenia na maszynie wirtualnej. Jeśli lista jest długa, możesz użyć pola wyszukiwania do filtrowania listy.

Użyj polecenia cmdlet Get-AzVMExtension , aby wyświetlić listę wszystkich zainstalowanych rozszerzeń na maszynie wirtualnej:

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

Dane wyjściowe polecenia cmdlet zawierają listę zainstalowanych rozszerzeń:

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

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

Użyj polecenia az vm extension list , aby wyświetlić listę wszystkich zainstalowanych rozszerzeń na maszynie wirtualnej:

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

Dane wyjściowe polecenia zawierają listę zainstalowanych rozszerzeń:

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

Instalacja rozszerzenia agenta usługi Network Watcher dla maszyny wirtualnej (VM)

Na stronie maszyny wirtualnej w witrynie Azure Portal możesz zainstalować rozszerzenie maszyny wirtualnej agenta usługi Network Watcher, wykonując następujące kroki:

W obszarze Ustawienia wybierz Rozszerzenia i aplikacje.
Wybierz + Dodaj i wyszukaj Network Watcher Agent, a następnie zainstaluj go. Jeśli rozszerzenie jest już zainstalowane, można go zobaczyć na liście rozszerzeń.
W polu wyszukiwania Install an Extension wpisz Network Watcher Agent, wybierz odpowiadające rozszerzenie dla swojego systemu operacyjnego z listy, a następnie wybierz Dalej.
Wybierz pozycję Przeglądanie i tworzenie, a następnie wybierz pozycję Utwórz.

Użyj cmdletu Set-AzVMExtension, aby zainstalować rozszerzenie Network Watcher Agent na maszynie wirtualnej.

# 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 pomyślnym zakończeniu instalacji zostaną wyświetlone następujące dane wyjściowe:

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

Użyj polecenia az vm extension set, aby zainstalować rozszerzenie Network Watcher Agent VM na maszynie wirtualnej:

# 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'

Użyj poniższego szablonu Azure Resource Manager (szablon ARM), aby zainstalować rozszerzenie Network Watcher Agent VM na maszynie wirtualnej:

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

Aby wdrożyć szablon usługi Resource Manager, możesz użyć programu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure:

# 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'

Odinstaluj rozszerzenie agenta Network Watcher dla maszyny wirtualnej

Na stronie maszyny wirtualnej w witrynie Azure Portal możesz odinstalować rozszerzenie maszyny wirtualnej agenta usługi Network Watcher, wykonując następujące kroki:

W obszarze Ustawienia wybierz Rozszerzenia i aplikacje.
Wybierz pozycję AzureNetworkWatcherExtension z listy rozszerzeń, a następnie wybierz pozycję Odinstaluj.

Note

Być może zobaczysz rozszerzenie maszyny wirtualnej agenta usługi Network Watcher o nazwie innej niż AzureNetworkWatcherExtension.

Użyj polecenia cmdlet Remove-AzVMExtension, aby usunąć rozszerzenie agenta maszyny wirtualnej Network Watcher z maszyny wirtualnej.

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

Aby usunąć rozszerzenie agenta usługi Network Watcher z maszyny wirtualnej, użyj polecenia az vm extension delete:

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

Najczęściej zadawane pytania (FAQ)

Aby uzyskać odpowiedzi na najczęściej zadawane pytania dotyczące agenta usługi Network Watcher, zobacz Agent usługi Network Watcher — często zadawane pytania.

Aktualizowanie rozszerzenia usługi Azure Network Watcher do najnowszej wersji
Włączanie lub wyłączanie usługi Azure Network Watcher
Microsoft Q& A - Network Watcher

Opinia

Czy ta strona była pomocna?

Last updated on 2026-08-27

Zarządzanie rozszerzeniem maszyny wirtualnej Network Watcher Agent

Wymagania wstępne

Obsługiwane systemy operacyjne

Schemat rozszerzenia

Wyświetlanie listy zainstalowanych rozszerzeń

Instalacja rozszerzenia agenta usługi Network Watcher dla maszyny wirtualnej (VM)

Odinstaluj rozszerzenie agenta Network Watcher dla maszyny wirtualnej

Najczęściej zadawane pytania (FAQ)

Treści powiązane

Opinia

Dodatkowe zasoby