Gerenciar a extensão da máquina virtual do Agente do Observador de Rede para Windows

A extensão de máquina virtual do Agente do Observador de Rede é um requisito para alguns dos recursos do Observador de Rede do Azure que capturam o tráfego de rede para diagnosticar e monitorar VMs (máquinas virtuais) do Azure. Para obter mais informações, consulte O que é o Observador de Rede do Azure?

Neste artigo, você aprenderá a instalar e desinstalar o Agente do Observador de Rede para Windows. A instalação do agente não interrompe nem requer que a máquina virtual seja reiniciada. Se a máquina virtual for implantada por um serviço do Azure, verifique a documentação do serviço para determinar se ele permite ou não a instalação de extensões na máquina virtual.

Pré-requisitos

Portal

• Uma VM (máquina virtual) do Windows do Azure. Para mais informações, confira Versões do Windows com suporte.

• Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.

• Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes. Para obter mais informações, consulte Visão geral de captura de pacotes.

PowerShell

• Uma VM (máquina virtual) do Windows do Azure. Para mais informações, confira Versões do Windows com suporte.

• Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.

• Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes. Para obter mais informações, consulte Visão geral de captura de pacotes.

• Azure Cloud Shell ou Azure PowerShell.

  As etapas desse artigo executam os cmdlets do Azure PowerShell interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Abrir o Cloud Shell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e cole-o no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell no portal do Azure.

  Você também pode instalar o Azure PowerShell localmente para executar os cmdlets. Se você executar o PowerShell localmente, entre no Azure usando a cmdlet Connect-AzAccount.

CLI do Azure

• Uma VM (máquina virtual) do Windows do Azure. Para mais informações, confira Versões do Windows com suporte.

• Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.

• Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes. Para obter mais informações, consulte Visão geral de captura de pacotes.

• Azure Cloud Shell ou CLI do Azure.

  As etapas desse artigo executam os comandos da CLI do Azure interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Abrir o Cloud Shell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e colá-lo no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell no portal do Azure.

  Você também pode instalar a CLI do Azure localmente para executar os comandos. Se você executar a CLI do Azure localmente, entre no Azure usando o comando az login .

Gerenciador de Recursos

• Uma VM (máquina virtual) do Windows do Azure. Para mais informações, confira Versões do Windows com suporte.

• Conectividade TCP de saída para 169.254.169.254 por port 80 e para 168.63.129.16 por port 8037. O agente usa esses endereços IP para se comunicar com a plataforma Azure.

• Conectividade com a Internet: o Agente do Observador de Rede requer conectividade com a Internet para que alguns recursos funcionem corretamente. Por exemplo, ele requer conectividade com sua conta de armazenamento para carregar capturas de pacotes. Para obter mais informações, consulte Visão geral de captura de pacotes.

• O Azure PowerShell ou a CLI do Azure foram instalados localmente para implantar o modelo.

  • Você pode instalar o Azure PowerShell para executar os cmdlets. Use o cmdlet Connect-AzAccount para entrar no Azure.

  • Você pode instalar a CLI do Azure para executar os comandos. Use o comando az login para entrar no Azure.

Sistemas operacionais compatíveis

A extensão do Agente do Observador de Rede para Windows pode ser instalada em:

• Versões do Windows Server 2012, 2012 R2, 2016, 2019 e 2022.
• Versões do Windows 10 e 11.

Observação

No momento, não há suporte para o Nano Server.

Esquema de extensão

O JSON a seguir mostra o esquema para a extensão do Agente do Observador de Rede. A extensão não requer e não é compatível com nenhuma configuração fornecida pelo usuário e é baseada em uma configuração padrão.

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

Listar extensões instaladas

Portal

Na página da máquina virtual no portal do Azure, você pode exibir a extensão instalada seguindo estas etapas:

1. Em Configurações, selecione Extensões + aplicativos.

2. Na guia Extensões, você pode ver todas as extensões instaladas na máquina virtual. Se a lista for longa, você poderá usar a caixa de pesquisa para filtrar a lista.

   

PowerShell

Use o cmdlet Get-AzVMExtension para listar todas as extensões instaladas na máquina virtual:

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

A saída do cmdlet lista as extensões instaladas:

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

CLI do Azure

Use o comando az vm extension list para listar todas as extensões instaladas na máquina virtual:

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

A saída do comando lista as extensões instaladas:

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

Gerenciador de Recursos

N/D

Instalar a extensão da VM do Agente do Observador de Rede

Portal

Na página da máquina virtual no portal do Azure, você pode instalar a extensão da VM do Agente do Observador de Rede seguindo estas etapas:

1. Em Configurações, selecione Extensões + aplicativos.

2. Selecione + Adicionar e pesquise Agente do Observador de Rede e instale-o. Se a extensão já estiver instalada, você poderá vê-la na lista de extensões.

   

3. Na caixa de pesquisa de Instalar uma Extensão, insira Agente do Observador de Rede para Windows. Selecione a extensão na lista e selecione Avançar.

   

4. Selecione Examinar + Criar e, em seguida, selecione Criar.

PowerShell

Use o cmdlet Set-AzVMExtension para instalar a extensão da VM do Agente do Observador de Rede na máquina virtual:

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

Depois que a instalação for concluída com êxito, você verá a seguinte saída:

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

CLI do Azure

Use o comando az vm extension set para instalar a extensão de VM do Agente do Observador de Rede na máquina virtual:

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

Gerenciador de Recursos

Use o seguinte modelo do ARM (modelo do Azure Resource Manager) para instalar a extensão de VM do Agente do Observador de Rede em uma máquina virtual do 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": {}
}

Você pode usar o Azure PowerShell ou a CLI do Azure para implantar o modelo do 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'

Desinstalar a extensão da VM do Agente do Observador de Rede

Portal

Na página da máquina virtual no portal do Azure, você pode desinstalar a extensão da VM do Agente do Observador de Rede seguindo estas etapas:

1. Em Configurações, selecione Extensões + aplicativos.

2. Selecione AzureNetworkWatcherExtension na lista de extensões e, em seguida, selecione Desinstalar.

   

   Observação

   Você pode ver a extensão da VM do Agente do Observador de Rede com um nome diferente de AzureNetworkWatcherExtension.

PowerShell

Use o cmdlet Remove-AzVMExtension para remover a extensão da VM do Agente do Observador de Rede da máquina virtual:

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

CLI do Azure

Use o comando az vm extension delete para remover a extensão da VM do Agente do Observador de Rede da máquina virtual:

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

Gerenciador de Recursos

N/D

Perguntas frequentes

Para obter respostas para as perguntas mais frequentes sobre o Agente do Observador de Rede, consulte Perguntas frequentes sobre o Agente do Observador de Rede.

Conteúdo relacionado

• Atualizar a extensão do Observador de Rede do Azure para a versão mais recente.
• Documentação do Observador de Rede.
• Microsoft Q&A – Observador de Rede.