Utiliser un TAP de réseau virtuel à l’aide d’Azure CLIWork with a virtual network TAP using the Azure CLI

Le TAP (point d’accès terminal) de réseau virtuel Azure vous permet de diffuser en continu votre trafic réseau de machine virtuelle vers un collecteur de paquets réseau ou un outil analytique.Azure virtual network TAP (Terminal Access Point) allows you to continuously stream your virtual machine network traffic to a network packet collector or analytics tool. Le collecteur ou l’outil analytique est fourni par une appliance virtuelle réseau partenaire.The collector or analytics tool is provided by a network virtual appliance partner. Pour obtenir la liste des solutions de partenaires qui fonctionnent avec un TAP de réseau virtuel, consultez les solutions de partenaires.For a list of partner solutions that are validated to work with virtual network TAP, see partner solutions.

Créer une ressource TAP de réseau virtuelCreate a virtual network TAP resource

Lisez les prérequis avant de créer une ressource TAP de réseau virtuel.Read prerequisites before you create a virtual network TAP resource. Vous pouvez exécuter les commandes qui suivent dans Azure Cloud Shell ou en exécutant l’interface de ligne de commande (CLI) Azure à partir de votre ordinateur.You can run the commands that follow in the Azure Cloud Shell, or by running the Azure command-line interface (CLI) from your computer. Azure Cloud Shell est un interpréteur de commandes interactif gratuit qui ne nécessite pas l’installation d’Azure CLI sur votre ordinateur.The Azure Cloud Shell is a free interactive shell, that doesn't require installing the Azure CLI on your computer. Vous devez vous connecter à Azure avec un compte qui a les autorisations appropriées.You must sign in to Azure with an account that has the appropriate permissions. Cet article nécessite la version 2.0.46 ou ultérieure d’Azure CLI.This article requires the Azure CLI version 2.0.46 or later. Exécutez az --version pour rechercher la version installée.Run az --version to find the installed version. Si vous devez installer ou mettre à niveau, consultez Installation d’Azure CLI 2.0.If you need to install or upgrade, see Install Azure CLI 2.0. Le point d’accès terminal (TAP) de réseau virtuel est actuellement disponible sous forme d’extension.Virtual network TAP is currently available as an extension. Pour installer l’extension, vous devez exécuter az extension add -n virtual-network-tap.To install the extension you need to run az extension add -n virtual-network-tap. Si vous exécutez Azure CLI localement, vous devez également exécuter az login pour créer une connexion avec Azure.If you are running the Azure CLI locally, you also need to run az login to create a connection with Azure.

  1. Récupérer l’ID de votre abonnement dans une variable, utilisée dans une étape ultérieure :Retrieve the ID of your subscription into a variable that is used in a later step:

    subscriptionId=$(az account show \
    --query id \
    --out tsv)
    
  2. Définissez l’ID d’abonnement à utiliser pour créer une ressource TAP de réseau virtuel.Set the subscription id that you will use to create a virtual network TAP resource.

    az account set --subscription $subscriptionId
    
  3. Réinscrivez l’ID d’abonnement à utiliser pour créer une ressource TAP de réseau virtuel.Re-register the subscription ID that you'll use to create a virtual network TAP resource. Si vous obtenez une erreur d’inscription quand vous créez une ressource TAP, exécutez la commande suivante :If you get a registration error when you create a TAP resource, run the following command:

    az provider register --namespace Microsoft.Network --subscription $subscriptionId
    
  4. Si la destination du TAP de réseau virtuel est l’interface réseau sur l’appliance virtuelle réseau d’un collecteur ou d’un outil analytique :If the destination for the virtual network TAP is the network interface on the network virtual appliance for collector or analytics tool -

    • Récupérez la configuration IP de l’interface réseau de l’appliance virtuelle réseau dans une variable, utilisée dans une étape ultérieure.Retrieve the IP configuration of the network virtual appliance's network interface into a variable that is used in a later step. L’ID est le point de terminaison qui va agréger le trafic TAP.The ID is the end point that will aggregate the TAP traffic. L’exemple suivant récupère l’ID de la configuration IP ipconfig1 pour une interface réseau nommée myNetworkInterface, dans un groupe de ressources nommé myResourceGroup :The following example retrieves the ID of the ipconfig1 IP configuration for a network interface named myNetworkInterface, in a resource group named myResourceGroup:

        IpConfigId=$(az network nic ip-config show \
        --name ipconfig1 \
        --nic-name myNetworkInterface \
        --resource-group myResourceGroup \
        --query id \
        --out tsv)
      
    • Créez le TAP de réseau virtuel dans la région Azure westcentralus à l’aide de l’ID de la configuration IP de destination et d’une propriété de port facultative.Create the virtual network TAP in westcentralus azure region using the ID of the IP configuration as the destination and an optional port property. Le port spécifie le port de destination du trafic TAP sur la configuration IP d’interface réseau :The port specifies the destination port on network interface IP configuration where the TAP traffic will be received :

        az network vnet tap create \
        --resource-group myResourceGroup \
        --name myTap \
        --destination $IpConfigId \
        --port 4789 \
        --location westcentralus
      
  5. Si la destination du TAP de réseau virtuel est un équilibreur de charge interne Azure :If the destination for the virtual network TAP is an azure internal load balancer:

    • Récupérez la configuration IP frontend de l’équilibreur de charge interne Azure dans une variable, utilisée dans une étape ultérieure.Retrieve the front end IP configuration of the Azure internal load balancer into a variable that is used in a later step. L’ID est le point de terminaison qui va agréger le trafic TAP.The ID is the end point that will aggregate the TAP traffic. L’exemple suivant récupère l’ID de la configuration IP frontend frontendipconfig1 pour un équilibreur de charge nommé myInternalLoadBalancer, dans un groupe de ressources nommé myResourceGroup :The following example retrieves the ID of the frontendipconfig1 front end IP configuration for a load balancer named myInternalLoadBalancer, in a resource group named myResourceGroup:

      FrontendIpConfigId=$(az network lb frontend-ip show \
      --name frontendipconfig1 \
      --lb-name myInternalLoadBalancer \
      --resource-group myResourceGroup \
      --query id \
      --out tsv)
      
    • Créez le TAP de réseau virtuel à l’aide de l’ID de la configuration IP de destination et d’une propriété de port facultative.Create the virtual network TAP using the ID of the frontend IP configuration as the destination and an optional port property. Le port spécifie le port de destination du trafic TAP sur la configuration IP frontend :The port specifies the destination port on front end IP configuration where the TAP traffic will be received :

      az network vnet tap create \
      --resource-group myResourceGroup \
      --name myTap \
      --destination $FrontendIpConfigId \
      --port 4789 \
      --location westcentralus
      
  6. Confirmez la création du TAP de réseau virtuel :Confirm creation of the virtual network TAP:

    az network vnet tap show \
    --resource-group myResourceGroup
    --name myTap
    

Ajouter une configuration TAP à une interface réseauAdd a TAP configuration to a network interface

  1. Récupérez l’ID d’une ressource TAP de réseau virtuel existante.Retrieve the ID of an existing virtual network TAP resource. L’exemple suivant récupère un TAP de réseau virtuel nommé myTap dans un groupe de ressources nommé myResourceGroup :The following example retrieves a virtual network TAP named myTap in a resource group named myResourceGroup:

    tapId=$(az network vnet tap show \
    --name myTap \
    --resource-group myResourceGroup \
    --query id \
    --out tsv)
    
  2. Créez une configuration TAP sur l’interface réseau de la machine virtuelle supervisée.Create a TAP configuration on the network interface of the monitored virtual machine. L’exemple suivant crée une configuration TAP pour une interface réseau nommée myNetworkInterface :The following example creates a TAP configuration for a network interface named myNetworkInterface:

    az network nic vtap-config create \
    --resource-group myResourceGroup \
    --nic myNetworkInterface \
    --vnet-tap $tapId \
    --name mytapconfig \
    --subscription subscriptionId
    
  3. Confirmez la création de la configuration TAP :Confirm creation of the TAP configuration:

    az network nic vtap-config show \
    --resource-group myResourceGroup \
    --nic-name myNetworkInterface \
    --name mytapconfig \
    --subscription subscriptionId
    

Supprimer la configuration TAP sur une interface réseauDelete the TAP configuration on a network interface

az network nic vtap-config delete \
--resource-group myResourceGroup \
--nic myNetworkInterface \
--name myTapConfig \
--subscription subscriptionId

Lister les TAP de réseau virtuel dans un abonnementList virtual network TAPs in a subscription

az network vnet tap list

Supprimer un TAP de réseau virtuel dans un groupe de ressourcesDelete a virtual network TAP in a resource group

az network vnet tap delete \
--resource-group myResourceGroup \
--name myTap