Modifier un circuit ExpressRoute à l’aide de PowerShell (Azure Classic)Modify an ExpressRoute circuit using PowerShell (classic)

Cet article vous montre les étapes nécessaires à la vérification de l’état, à la mise à jour, à la suppression et au déprovisionnement du circuit de votre modèle de déploiement classique ExpressRoute.This article walks you through the steps to check the status, update, or delete and deprovision your ExpressRoute classic deployment model circuit. Cet article s’applique au modèle de déploiement classique.This article applies to the classic deployment model.

Important

Depuis le 1er mars 2017, vous ne pouvez pas créer de circuits ExpressRoute dans le modèle de déploiement classique.As of March 1, 2017, you can't create new ExpressRoute circuits in the classic deployment model.

  • Vous pouvez déplacer un circuit ExpressRoute existant du modèle de déploiement classique vers le modèle de déploiement Resource Manager sans affecter la connectivité.You can move an existing ExpressRoute circuit from the classic deployment model to the Resource Manager deployment model without experiencing any connectivity down time. Pour plus d’informations, consultez Déplacer un circuit existant.For more information, see Move an existing circuit.
  • Vous pouvez vous connecter à des réseaux virtuels dans le modèle de déploiement classique en définissant allowClassicOperations sur TRUE.You can connect to virtual networks in the classic deployment model by setting allowClassicOperations to TRUE.

Utilisez les liens suivants pour créer et gérer des circuits ExpressRoute dans le modèle de déploiement Resource Manager :Use the following links to create and manage ExpressRoute circuits in the Resource Manager deployment model:

À propos des modèles de déploiement AzureAbout Azure deployment models

Actuellement, Azure utilise deux modèles de déploiement : Resource Manager et le déploiement classique.Azure currently works with two deployment models: Resource Manager and classic. Les deux modèles ne sont pas entièrement compatibles entre eux.The two models are not completely compatible with each other. Avant de commencer, vous devez savoir dans quel modèle vous souhaitez travailler.Before you begin, you need to know which model that you want to work in. Pour plus d'informations sur les modèles de déploiement, consultez Comprendre les modèles de déploiement Azure.For information about the deployment models, see Understanding deployment models. Si vous êtes un nouvel utilisateur d’Azure, nous vous recommandons le modèle de déploiement Resource Manager.If you are new to Azure, we recommend that you use the Resource Manager deployment model.

Avant de commencerBefore you begin

Installez les dernières versions des modules PowerShell Azure Service Management (SM) et du module ExpressRoute.Install the latest versions of the Azure Service Management (SM) PowerShell modules and the ExpressRoute module. Vous ne pouvez pas utiliser l’environnement Azure CloudShell pour exécuter des modules SM.You can't use the Azure CloudShell environment to run SM modules.

  1. Suivez les instructions de l’article Installation du module Service Management pour installer le module Azure Service Management.Use the instructions in the Installing the Service Management module article to install the Azure Service Management Module. Si le module Az ou RM est déjà installé, assurez-vous d’utiliser « -AllowClobber ».If you have the Az or RM module already installed, be sure to use '-AllowClobber'.

  2. Importez les modules installés.Import the installed modules. Lorsque vous utilisez l’exemple suivant, ajustez le chemin pour refléter l’emplacement et la version de vos modules PowerShell installés.When using the following example, adjust the path to reflect the location and version of your installed PowerShell modules.

    Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.3.0\Azure.psd1'
    Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.3.0\ExpressRoute\ExpressRoute.psd1'
    
  3. Pour vous connecter à votre compte Azure, ouvrez votre console PowerShell avec des droits élevés et connectez-vous à votre compte.To sign in to your Azure account, open your PowerShell console with elevated rights and connect to your account. Utilisez l’exemple suivant pour vous aider à vous connecter à l’aide du module Service Management :Use the following example to help you connect using the Service Management module:

    Add-AzureAccount
    

Récupérer l’état d’un circuitGet the status of a circuit

Vous pouvez récupérer ces informations à tout moment à l’aide de l’applet de commande Get-AzureCircuit .You can retrieve this information at any time by using the Get-AzureCircuit cmdlet. Un appel effectué sans aucun paramètre répertorie tous les circuits.Making the call without any parameters lists all the circuits.

Get-AzureDedicatedCircuit

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Bandwidth                        : 1000
CircuitName                      : MyAsiaCircuit
Location                         : Singapore
ServiceKey                       : #################################
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Vous pouvez obtenir des informations sur un circuit ExpressRoute spécifique en passant, en tant que paramètre, la clé de service à l’appel.You can get information on a specific ExpressRoute circuit by passing the service key as a parameter to the call.

Get-AzureDedicatedCircuit -ServiceKey "*********************************"

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Vous pouvez obtenir une description détaillée de tous les paramètres en exécutant l’exemple suivant :You can get detailed descriptions of all the parameters by running the following example:

get-help get-azurededicatedcircuit -detailed

Modifier un circuitModify a circuit

Vous pouvez modifier certaines propriétés d'un circuit ExpressRoute sans affecter la connectivité.You can modify certain properties of an ExpressRoute circuit without impacting connectivity.

Vous pouvez effectuer les tâches suivantes sans entraîner de temps d’arrêt :You can do the following tasks with no downtime:

  • Activer ou désactiver le module complémentaire ExpressRoute Premium pour votre circuit ExpressRoute.Enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • Augmenter la bande passante de votre circuit ExpressRoute à condition que la capacité disponible sur le port le permette.Increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. La rétrogradation de la bande passante d'un circuit n'est pas prise en charge.Downgrading the bandwidth of a circuit is not supported.
  • Modifiez le plan de mesure de Données limitées à Données illimitées.Change the metering plan from Metered Data to Unlimited Data. La modification du plan de limitation de Données illimitées à Données limitées n’est pas prise en charge.Changing the metering plan from Unlimited Data to Metered Data is not supported.
  • Vous pouvez activer et désactiver Autoriser les opérations classiques.You can enable and disable Allow Classic Operations.

Pour plus d’informations sur les limites et les limitations, reportez-vous au FAQ ExpressRoute .Refer to the ExpressRoute FAQ for more information on limits and limitations.

Activer le module complémentaire ExpressRoute PremiumEnable the ExpressRoute premium add-on

Vous pouvez activer le module complémentaire ExpressRoute Premium pour votre circuit existant à l’aide de l’applet de commande PowerShell suivante :You can enable the ExpressRoute premium add-on for your existing circuit by using the following PowerShell cmdlet:

Set-AzureDedicatedCircuitProperties -ServiceKey "*********************************" -Sku Premium

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Premium
Status                           : Enabled

Les fonctionnalités du module complémentaire ExpressRoute premium seront activées sur votre circuit.Your circuit will now have the ExpressRoute premium add-on features enabled. La facturation du module complémentaire Premium démarre dès que la commande est exécutée avec succès.As soon as the command has been successfully run, billing for the premium add-on capability begins.

Désactiver le module complémentaire ExpressRoute PremiumDisable the ExpressRoute premium add-on

Important

Cette opération peut échouer si vous utilisez des ressources supérieures à ce qui est autorisé pour le circuit standard.This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

ConsidérationsConsiderations

  • Vérifiez que le nombre de réseaux virtuels liés au circuit est inférieur à 10 avant de rétrograder du niveau Premium au niveau Standard.Make sure that the number of virtual networks linked to the circuit is less than 10 before you downgrade from premium to standard. Si vous ne le faites pas, votre demande de mise à jour échoue et les tarifs Premium continuent d’être appliqués.If you don't do this, your update request fails, and you are billed the premium rates.
  • Vous devez dissocier tous les réseaux virtuels dans d'autres régions géopolitiques.You must unlink all virtual networks in other geopolitical regions. Si vous ne le faites pas, votre demande de mise à jour échoue et les tarifs Premium continuent d’être appliqués.If you don't, your update request fails, and you are billed the premium rates.
  • Pour le peering privé, votre table de routage doit comporter moins de 4 000 routages.Your route table must be less than 4,000 routes for private peering. Si la table de routage comporte plus de 4 000 routages, la session BGP s’arrête et ne sera pas réactivée tant que le nombre de préfixes publiés ne sera pas inférieur à 4 000.If your route table size is greater than 4,000 routes, the BGP session drops and won't be reenabled until the number of advertised prefixes goes below 4,000.

Pour désactiver le module complémentaire PremiumTo disable the premium add-on

Vous pouvez désactiver le module complémentaire ExpressRoute Premium pour votre circuit existant à l’aide de l’applet de commande PowerShell suivante :You can disable the ExpressRoute premium add-on for your existing circuit by using the following PowerShell cmdlet:


Set-AzureDedicatedCircuitProperties -ServiceKey "*********************************" -Sku Standard

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Mettre à jour la bande passante d’un circuit ExpressRouteUpdate the ExpressRoute circuit bandwidth

Pour connaître les options de bande passante prises en charge par votre fournisseur, consultez le FAQ ExpressRoute .Check the ExpressRoute FAQ for supported bandwidth options for your provider. Vous pouvez choisir toute taille supérieure à celle de votre circuit existant, pour autant que le port physique (sur lequel votre circuit est créé) le permette.You can pick any size that is greater than the size of your existing circuit as long as the physical port (on which your circuit is created) allows.

Important

Vous devrez peut-être recréer le circuit ExpressRoute si la capacité sur le port existant est inappropriée.You may have to recreate the ExpressRoute circuit if there is inadequate capacity on the existing port. Vous ne pouvez pas mettre le circuit à niveau si aucune capacité supplémentaire n’est disponible à cet emplacement.You cannot upgrade the circuit if there is no additional capacity available at that location.

Vous ne pouvez pas réduire la bande passante d’un circuit ExpressRoute sans interrompre le service.You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. Le fait de passer à un niveau inférieur de bande passante vous oblige à annuler l’approvisionnement du circuit ExpressRoute, puis à réapprovisionner un nouveau circuit ExpressRoute.Downgrading bandwidth requires you to deprovision the ExpressRoute circuit and then reprovision a new ExpressRoute circuit.

Redimensionner un circuitResize a circuit

Une fois que vous avez décidé de la taille dont vous avez besoin, vous pouvez utiliser la commande suivante pour redimensionner votre circuit :After you decide what size you need, you can use the following command to resize your circuit:

Set-AzureDedicatedCircuitProperties -ServiceKey ********************************* -Bandwidth 1000

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Une fois le circuit redimensionné par Microsoft, vous devez contacter votre fournisseur de connectivité pour qu’il mette à jour les configurations de son côté afin de refléter ce changement.Once your circuit has been sized up on the Microsoft side, you must contact your connectivity provider to update configurations on their side to match this change. C’est à partir de là que démarre la facturation de l’option de bande passante mise à jour.Billing begins for the updated bandwidth option from this point on.

Si l’erreur suivante s’affiche lors de l’augmentation de la bande passante du circuit, cela signifie qu’il ne reste pas suffisamment de bande passante sur le port physique sur lequel votre circuit est créé.If you see the following error when increasing the circuit bandwidth, it means there is no sufficient bandwidth left on the physical port where your existing circuit is created. Vous devez supprimer ce circuit et en créer un nouveau de la taille nécessaire.You must delete this circuit and create a new circuit of the size you need.

Set-AzureDedicatedCircuitProperties : InvalidOperation : Insufficient bandwidth available to perform this circuit
update operation
At line:1 char:1
+ Set-AzureDedicatedCircuitProperties -ServiceKey ********************* ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  + CategoryInfo          : CloseError: (:) [Set-AzureDedicatedCircuitProperties], CloudException
  + FullyQualifiedErrorId : Microsoft.WindowsAzure.Commands.ExpressRoute.SetAzureDedicatedCircuitPropertiesCommand

Déprovisionner et supprimer un circuitDeprovision and delete a circuit

ConsidérationsConsiderations

  • Vous devez annuler la liaison de tous les réseaux virtuels du circuit ExpressRoute pour que cette opération réussisse.You must unlink all virtual networks from the ExpressRoute circuit for this operation to succeed. Si cette opération échoue, vérifiez si des réseaux virtuels sont liés au circuit.Check to see if you have any virtual networks that are linked to the circuit if this operation fails.
  • Si l’état d’approvisionnement du fournisseur de services du circuit ExpressRoute est En cours d’approvisionnement ou Approvisionné, vous devez vous mettre en relation avec votre fournisseur de services pour annuler l’approvisionnement du circuit de son côté.If the ExpressRoute circuit service provider provisioning state is Provisioning or Provisioned you must work with your service provider to deprovision the circuit on their side. Nous continuons à réserver des ressources et à vous facturer jusqu’à ce que le fournisseur de services termine le désapprovisionnement du circuit et nous en avertisse.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • Si le fournisseur de services a déprovisionné le circuit (l’état d’approvisionnement du fournisseur de services doit afficher la valeur Non approvisionné), vous pouvez supprimer le circuit.If the service provider has deprovisioned the circuit (the service provider provisioning state is set to Not provisioned), you can then delete the circuit. Cette opération arrête la facturation du circuit.This stops billing for the circuit.

Supprimer un circuitDelete a circuit

Vous pouvez supprimer votre circuit ExpressRoute en exécutant la commande suivante :You can delete your ExpressRoute circuit by running the following command:

Remove-AzureDedicatedCircuit -ServiceKey "*********************************"