Gérer l’extension de machine virtuelle de l’agent Network Watcher pour Windows
Article
L’extension de machine virtuelle de l’agent Network Watcher est obligatoire pour certaines fonctionnalités d’Azure Network Watcher qui capturent le trafic afin de diagnostiquer et de superviser les machines virtuelles Azure. Pour plus d’informations, consultez Présentation d’Azure Network Watcher.
Dans cet article, vous allez apprendre à installer et désinstaller l’agent Network Watcher pour Windows. L’installation de l’agent n’est pas perturbante et ne nécessite pas le redémarrage de la machine virtuelle. Si la machine virtuelle est déployée par un service Azure, consultez la documentation relative au service afin de déterminer si elle autorise l’installation d’extensions dans la machine virtuelle.
Connectivité TCP sortante vers 169.254.169.254 sur port 80 et 168.63.129.16 sur port 8037. L’agent utilise ces adresses IP pour communiquer avec la plateforme Azure.
Connectivité Internet : l’agent Network Watcher nécessite une connectivité Internet pour que certaines fonctionnalités fonctionnent correctement. Par exemple, il nécessite une connectivité à votre compte de stockage pour charger des captures de paquets. Pour plus d’informations, consultez Présentation de la capture de paquets.
Connectivité TCP sortante vers 169.254.169.254 sur port 80 et 168.63.129.16 sur port 8037. L’agent utilise ces adresses IP pour communiquer avec la plateforme Azure.
Connectivité Internet : l’agent Network Watcher nécessite une connectivité Internet pour que certaines fonctionnalités fonctionnent correctement. Par exemple, il nécessite une connectivité à votre compte de stockage pour charger des captures de paquets. Pour obtenir plus d’informations, consultez Présentation de la capture de paquets.
Azure Cloud Shell ou Azure PowerShell.
Les étapes de cet article exécutent les applets de commande Azure PowerShell de manière interactive dans Azure Cloud Shell. Pour exécuter les commandes dans le Cloud Shell, sélectionnez Ouvrir Cloud Shell dans le coin supérieur droit d’un bloc de code. Sélectionnez Copier pour copier le code, puis collez-le dans Cloud Shell pour l’exécuter. Vous pouvez également exécuter le Cloud Shell à partir du Portail Azure.
Connectivité TCP sortante vers 169.254.169.254 sur port 80 et 168.63.129.16 sur port 8037. L’agent utilise ces adresses IP pour communiquer avec la plateforme Azure.
Connectivité Internet : l’agent Network Watcher nécessite une connectivité Internet pour que certaines fonctionnalités fonctionnent correctement. Par exemple, il nécessite une connectivité à votre compte de stockage pour charger des captures de paquets. Pour obtenir plus d’informations, consultez Présentation de la capture de paquets.
Azure Cloud Shell ou Azure CLI.
Dans les étapes de cet article, vous exécutez les commandes Azure CLI de manière interactive dans Azure Cloud Shell. Pour exécuter les commandes dans le Cloud Shell, sélectionnez Ouvrir Cloud Shell dans le coin supérieur droit d’un bloc de code. Sélectionnez Copier pour copier le code, puis collez-le dans Cloud Shell afin de l’exécuter. Vous pouvez démarrer Azure Cloud Shell depuis le Portail Azure.
Vous pouvez également installer Azure CLI localement afin d’exécuter les commandes. Si vous exécutez Azure CLI localement, connectez-vous à Azure à l’aide de la commande az login.
Connectivité TCP sortante vers 169.254.169.254 sur port 80 et 168.63.129.16 sur port 8037. L’agent utilise ces adresses IP pour communiquer avec la plateforme Azure.
Connectivité Internet : l’agent Network Watcher nécessite une connectivité Internet pour que certaines fonctionnalités fonctionnent correctement. Par exemple, il nécessite une connectivité à votre compte de stockage pour charger des captures de paquets. Pour obtenir plus d’informations, consultez Présentation de la capture de paquets.
Azure PowerShell ou Azure CLI installé localement pour déployer le modèle.
Vous pouvez installer Azure CLI pour exécuter les commandes. Utilisez la commande az login pour vous connecter à Azure.
Systèmes d’exploitation pris en charge
L’extension agent Network Watcher pour Windows peut être installée sur :
Versions de Windows Server 2012, 2012 R2, 2016, 2019 et 2022.
Versions de Windows 10 et 11.
Remarque
Actuellement, Nano Server n’est pas pris en charge.
Schéma d’extensions
Le JSON suivant illustre le schéma de l’extension Agent Network Watcher. L’extension ne requiert ni ne prend en charge aucun paramètre fourni par l’utilisateur et s’appuie sur sa configuration par défaut.
À partir de la page de machine virtuelle dans le Portail Azure, vous pouvez afficher l’extension installée en suivant les étapes suivantes :
Sous Paramètres, sélectionnez Extensions + applications.
Sous l’onglet Extensions, vous pouvez voir toutes les extensions installées sur la machine virtuelle. Si la liste est longue, vous pouvez utiliser la zone de recherche pour filtrer la liste.
Utilisez la cmdlet Get-AzVMExtension pour répertorier toutes les extensions installées sur la machine virtuelle :
# List the installed extensions on the virtual machine.
Get-AzVMExtension -ResourceGroupName 'myResourceGroup' -VMName 'myVM' | format-table Name, Publisher, ExtensionType, AutoUpgradeMinorVersion, EnableAutomaticUpgrade
La sortie de la cmdlet répertorie les extensions installées :
À partir de la page de machine virtuelle dans le Portail Azure, vous pouvez installer l’extension de machine virtuelle de l’agent Network Watcher en suivant les étapes suivantes :
Sous Paramètres, sélectionnez Extensions + applications.
Sélectionnez + Ajouter et recherchez Agent Network Watcher et installez-le. Si l’extension est déjà installée, vous pouvez la voir dans la liste des extensions.
Dans la zone de recherche de Installer une extension, entrez Agent Network Watcher pour Windows. Sélectionnez l’extension dans la liste, puis sélectionnez Suivant.
Sélectionnez Vérifier + créer, puis sélectionnez Créer.
Utilisez la cmdlet Set-AzVMExtension pour installer l’extension de machine virtuelle de l’agent Network Watcher sur la machine virtuelle :
# 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'
Une fois l’installation terminée, la sortie suivante s’affiche :
RequestId IsSuccessStatusCode StatusCode ReasonPhrase
--------- ------------------- ---------- ------------
True OK
Utilisez la commande az vm extension set pour installer l’extension de machine virtuelle de l’agent Network Watcher sur la machine virtuelle :
# 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'
Utilisez le modèle Azure Resource Manager (modèle ARM) suivant pour installer l’extension de machine virtuelle de l’agent Network Watcher sur une machine virtuelle Windows :
À partir de la page de machine virtuelle dans le Portail Azure, vous pouvez désinstaller l’extension de machine virtuelle de l’agent Network Watcher en suivant les étapes suivantes :
Sous Paramètres, sélectionnez Extensions + applications.
Sélectionnez AzureNetworkWatcherExtension dans la liste des extensions, puis sélectionnez Désinstaller.
Remarque
Il est possible que vous voyiez l’extension de machine virtuelle de l’agent Network Watcher nommée différemment d’AzureNetworkWatcherExtension.
Utilisez la cmdlet Remove-AzVMExtension pour supprimer l’extension de machine virtuelle de l’agent Network Watcher de la machine virtuelle :