Configurer une passerelle de réseau virtuel pour ExpressRoute à l’aide de PowerShellConfigure a virtual network gateway for ExpressRoute using PowerShell

Cet article vous permet d’ajouter, de redimensionner et de supprimer une passerelle de réseau virtuel pour un réseau virtuel préexistant.This article helps you add, resize, and remove a virtual network (VNet) gateway for a pre-existing VNet. Les étapes de cette configuration s’appliquent aux réseaux virtuels qui ont été créés à l’aide du modèle de déploiement Resource Manager pour une configuration ExpressRoute.The steps for this configuration apply to VNets that were created using the Resource Manager deployment model for an ExpressRoute configuration. Pour en savoir plus, consultez À propos des passerelles de réseau virtuel pour ExpressRoute.For more information, see About virtual network gateways for ExpressRoute.

Avant tout choseBefore beginning

Travailler avec PowerShellWorking with PowerShell

Les étapes et les exemples de cet article utilisent les modules Azure PowerShell Az.The steps and examples in this article use Azure PowerShell Az modules. Pour installer les modules Az en local sur un ordinateur, voir Installer Azure PowerShell.To install the Az modules locally on your computer, see Install Azure PowerShell. Pour plus d’informations sur le module Az, voir Présentation du nouveau module Azure PowerShell Az.To learn more about the new Az module, see Introducing the new Azure PowerShell Az module. Les cmdlets PowerShell sont fréquemment mises à jour.PowerShell cmdlets are updated frequently. Si vous n’exécutez pas leur dernière version, les valeurs spécifiées dans les instructions peuvent échouer.If you are not running the latest version, the values specified in the instructions may fail. Pour rechercher les versions de PowerShell installées sur votre système, utilisez la cmdlet Get-Module -ListAvailable Az.To find the installed versions of PowerShell on your system, use the Get-Module -ListAvailable Az cmdlet.

Il est possible d’utiliser Azure Cloud Shell pour exécuter la plupart des cmdlets PowerShell et des commandes CLI au lieu d’installer Azure PowerShell ou CLI en local.You can use Azure Cloud Shell to run most PowerShell cmdlets and CLI commands, instead of installing Azure PowerShell or CLI locally. Azure Cloud Shell est un interpréteur de commandes interactif gratuit qui est configuré pour pouvoir être utilisé avec votre compte et dans lequel les outils Azure communs ont été préinstallés.Azure Cloud Shell is a free interactive shell that has common Azure tools preinstalled and is configured to use with your account. Pour exécuter le code contenu dans cet article sur Azure Cloud Shell, ouvrez une session Cloud Shell, utilisez le bouton Copier sur un bloc de code pour copier le code, et collez-le dans la session Cloud Shell avec Ctrl+Maj+V sur Windows et Linux, ou avec Cmd+Maj+V sur macOS.To run any code contained in this article on Azure Cloud Shell, open a Cloud Shell session, use the Copy button on a code block to copy the code, and paste it into the Cloud Shell session with Ctrl+Shift+V on Windows and Linux, or Cmd+Shift+V on macOS. Le texte collé ne s’exécute pas automatiquement ; appuyez sur Entrée pour exécuter le code.Pasted text is not automatically executed, press Enter to run code.

Cloud Shell peut être lancé de plusieurs façons :There are a few ways to launch the Cloud Shell:

Cliquez sur Essayer dans le coin supérieur droit d’un bloc de code.Click Try It in the upper right corner of a code block. Cloud Shell dans cet article
Ouvrez Cloud Shell dans votre navigateur.Open Cloud Shell in your browser. https://shell.azure.com/powershell
Cliquez sur le bouton Cloud Shell du menu situé dans l’angle supérieur droit de la fenêtre du portail Azure.Click the Cloud Shell button on the menu in the upper right of the Azure portal. Cloud Shell dans le portailCloud Shell in the portal

Liste de référence de configurationConfiguration reference list

Les étapes de cette tâche utilisent un réseau virtuel basé sur les valeurs figurant dans la liste de référence de configuration suivante.The steps for this task use a VNet based on the values in the following configuration reference list. Les noms et paramètres supplémentaires sont également présentés dans cette liste.Additional settings and names are also outlined in this list. Nous n’utilisons pas cette liste directement dans la procédure, mais nous ajoutons des variables en fonction des valeurs dans cette liste.We don't use this list directly in any of the steps, although we do add variables based on the values in this list. Vous pouvez copier la liste et l’utiliser en tant que référence, en remplaçant les valeurs par les vôtres.You can copy the list to use as a reference, replacing the values with your own.

  • Nom du réseau virtuel : « TestVNet »Virtual Network Name = "TestVNet"
  • Espace d’adressage du réseau virtuel : 192.168.0.0/16Virtual Network address space = 192.168.0.0/16
  • Groupe de ressources : « TestRG »Resource Group = "TestRG"
  • Nom du sous-réseau 1 : « FrontEnd »Subnet1 Name = "FrontEnd"
  • Espace d’adressage du sous-réseau 1 = "192.168.1.0/24"Subnet1 address space = "192.168.1.0/24"
  • Nom du sous-réseau de passerelle : « GatewaySubnet » Vous devez toujours nommer un sous-réseau de passerelle GatewaySubnet.Gateway Subnet name: "GatewaySubnet" You must always name a gateway subnet GatewaySubnet.
  • Espace d'adressage du sous-réseau de passerelle : « 192.168.200.0/26 »Gateway Subnet address space = "192.168.200.0/26"
  • Région : « USA Est »Region = "East US"
  • Nom de la passerelle : « GW »Gateway Name = "GW"
  • Nom d’adresse IP de la passerelle : « GWIP »Gateway IP Name = "GWIP"
  • Nom de configuration IP de la passerelle : « gwipconf »Gateway IP configuration Name = "gwipconf"
  • Type : « ExpressRoute » Ce type est requis pour une configuration ExpressRoute.Type = "ExpressRoute" This type is required for an ExpressRoute configuration.
  • Nom d’adresse IP publique de passerelle = « gwpip »Gateway Public IP Name = "gwpip"

Ajout d’une passerelleAdd a gateway

  1. Connectez-vous à votre abonnement Azure.Connect to your Azure Subscription.

    Si vous utilisez Azure Cloud Shell, vous vous connectez à votre compte Azure automatiquement après avoir cliqué sur « Essayer ».If you are using the Azure Cloud Shell, you sign in to your Azure account automatically after clicking 'Try it'. Pour vous connecter en local, ouvrez la console PowerShell avec des privilèges élevés et exécutez la cmdlet pour vous connecter.To sign in locally, open your PowerShell console with elevated privileges and run the cmdlet to connect.

    Connect-AzAccount
    

    Si vous possédez plusieurs abonnements, procurez-vous la liste de vos abonnements Azure.If you have more than one subscription, get a list of your Azure subscriptions.

    Get-AzSubscription
    

    Spécifiez l’abonnement à utiliser.Specify the subscription that you want to use.

    Select-AzSubscription -SubscriptionName "Name of subscription"
    
  2. Déclarez vos variables pour cet exercice.Declare your variables for this exercise. Veillez à modifier l’exemple pour refléter les paramètres que vous souhaitez utiliser.Be sure to edit the sample to reflect the settings that you want to use.

    $RG = "TestRG"
    $Location = "East US"
    $GWName = "GW"
    $GWIPName = "GWIP"
    $GWIPconfName = "gwipconf"
    $VNetName = "TestVNet"
    
  3. Stockez l’objet de réseau virtuel en tant que variable.Store the virtual network object as a variable.

    $vnet = Get-AzVirtualNetwork -Name $VNetName -ResourceGroupName $RG
    
  4. Ajoutez un sous-réseau de passerelle à votre réseau virtuel.Add a gateway subnet to your Virtual Network. Le sous-réseau de passerelle doit être nommé « GatewaySubnet ».The gateway subnet must be named "GatewaySubnet". Vous devez créer un sous-réseau de passerelle défini sur /27 ou plus (/26, /25, etc.).You should create a gateway subnet that is /27 or larger (/26, /25, etc.).

    Add-AzVirtualNetworkSubnetConfig -Name GatewaySubnet -VirtualNetwork $vnet -AddressPrefix 192.168.200.0/26
    
  5. Définissez la configuration.Set the configuration.

    $vnet = Set-AzVirtualNetwork -VirtualNetwork $vnet
    
  6. Stockez le sous-réseau de passerelle en tant que variable.Store the gateway subnet as a variable.

    $subnet = Get-AzVirtualNetworkSubnetConfig -Name 'GatewaySubnet' -VirtualNetwork $vnet
    
  7. Demandez une adresse IP publiqueRequest a public IP address. L’adresse IP est demandée avant de créer la passerelle.The IP address is requested before creating the gateway. Vous ne pouvez pas spécifier l’adresse IP que vous souhaitez utiliser, car elle est allouée de façon dynamique.You cannot specify the IP address that you want to use; it’s dynamically allocated. Vous utiliserez cette adresse IP dans la section de configuration suivante.You'll use this IP address in the next configuration section. La méthode AllocationMethod doit être dynamique.The AllocationMethod must be Dynamic.

    $pip = New-AzPublicIpAddress -Name $GWIPName  -ResourceGroupName $RG -Location $Location -AllocationMethod Dynamic
    
  8. Créez la configuration de votre passerelle.Create the configuration for your gateway. La configuration de la passerelle définit le sous-réseau et l’adresse IP publique à utiliser.The gateway configuration defines the subnet and the public IP address to use. Dans cette étape, vous spécifiez la configuration qui sera utilisée lors de la création de la passerelle.In this step, you are specifying the configuration that will be used when you create the gateway. Cette étape ne crée pas réellement l’objet de passerelle.This step does not actually create the gateway object. Utilisez l’exemple ci-dessous pour créer la configuration de votre passerelle.Use the sample below to create your gateway configuration.

    $ipconf = New-AzVirtualNetworkGatewayIpConfig -Name $GWIPconfName -Subnet $subnet -PublicIpAddress $pip
    
  9. Créez la passerelle.Create the gateway. Dans cette étape, le type -GatewayType est particulièrement important.In this step, the -GatewayType is especially important. Vous devez utiliser la valeur ExpressRoute.You must use the value ExpressRoute. Après l’exécution de ces cmdlets, la création de la passerelle peut prendre 45 minutes ou plus.After running these cmdlets, the gateway can take 45 minutes or more to create.

    New-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG -Location $Location -IpConfigurations $ipconf -GatewayType Expressroute -GatewaySku Standard
    

Vérification de la création de la passerelleVerify the gateway was created

Utilisez les commandes suivantes pour vérifier que la passerelle a été créée :Use the following commands to verify that the gateway has been created:

Get-AzVirtualNetworkGateway -ResourceGroupName $RG

Redimensionner une passerelleResize a gateway

Il existe un certain nombre de Références (SKU) de passerelle.There are a number of Gateway SKUs. Vous pouvez utiliser la commande suivante pour modifier la référence de passerelle à tout moment.You can use the following command to change the Gateway SKU at any time.

Important

Cette commande ne fonctionne pas pour la passerelle UltraPerformance.This command doesn't work for UltraPerformance gateway. Pour modifier votre passerelle en passerelle UltraPerformance, commencez par supprimer la passerelle ExpressRoute, puis créez une passerelle UltraPerformance.To change your gateway to an UltraPerformance gateway, first remove the existing ExpressRoute gateway, and then create a new UltraPerformance gateway. Pour mettre à niveau votre passerelle à partir d’une passerelle UltraPerformance, commencez par supprimer la passerelle UltraPerformance, puis créez-en une.To downgrade your gateway from an UltraPerformance gateway, first remove the UltraPerformance gateway, and then create a new gateway.

$gw = Get-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG
Resize-AzVirtualNetworkGateway -VirtualNetworkGateway $gw -GatewaySku HighPerformance

Supprimer une passerelleRemove a gateway

Pour supprimer une passerelle, utilisez la commande suivante :Use the following command to remove a gateway:

Remove-AzVirtualNetworkGateway -Name $GWName -ResourceGroupName $RG

Étapes suivantesNext steps

Une fois que vous avez créé la passerelle de réseau virtuel, vous pouvez lier votre réseau virtuel à un circuit ExpressRoute.After you have created the VNet gateway, you can link your VNet to an ExpressRoute circuit. Consultez Liaison d’un réseau virtuel à un circuit ExpressRoute.See Link a Virtual Network to an ExpressRoute circuit.