Modifier un circuit ExpressRoute à l’aide de PowerShell (Azure 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. Cet article s’applique au modèle de déploiement classique.
Important
Depuis le 1er mars 2017, vous ne pouvez pas créer de circuits ExpressRoute dans le modèle de déploiement classique.
- 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é. Pour plus d’informations, consultez Déplacer un circuit existant.
- Vous pouvez vous connecter à des réseaux virtuels dans le modèle de déploiement classique en définissant allowClassicOperations sur TRUE.
Utilisez les liens suivants pour créer et gérer des circuits ExpressRoute dans le modèle de déploiement Resource Manager :
À propos des modèles de déploiement Azure
Actuellement, Azure utilise deux modèles de déploiement : Resource Manager et le déploiement classique. Les deux modèles ne sont pas entièrement compatibles entre eux. Avant de commencer, vous devez savoir dans quel modèle vous souhaitez travailler. Pour plus d'informations sur les modèles de déploiement, consultez Comprendre les modèles de déploiement Azure. Si vous êtes un nouvel utilisateur d’Azure, nous vous recommandons le modèle de déploiement Resource Manager.
Avant de commencer
Installez les dernières versions des modules PowerShell Azure Service Management (SM) et du module ExpressRoute. Vous ne pouvez pas utiliser l’environnement Azure CloudShell pour exécuter des modules SM.
Suivez les instructions de l’article Installation du module Service Management pour installer le module Azure Service Management. Si le module Az ou RM est déjà installé, assurez-vous d’utiliser « -AllowClobber ».
Importez les modules installés. Lorsque vous utilisez l’exemple suivant, ajustez le chemin pour refléter l’emplacement et la version de vos modules PowerShell installés.
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'
Pour vous connecter à votre compte Azure, ouvrez votre console PowerShell avec des droits élevés et connectez-vous à votre compte. Utilisez l’exemple suivant pour vous aider à vous connecter à l’aide du module Service Management :
Add-AzureAccount
Récupérer l’état d’un circuit
Vous pouvez récupérer ces informations à tout moment à l’aide de l’applet de commande Get-AzureCircuit
. Un appel effectué sans aucun paramètre répertorie tous les 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.
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 :
get-help get-azurededicatedcircuit -detailed
Modifier un circuit
Vous pouvez modifier certaines propriétés d'un circuit ExpressRoute sans affecter la connectivité.
Vous pouvez effectuer les tâches suivantes sans entraîner de temps d’arrêt :
- Activer ou désactiver le module complémentaire ExpressRoute Premium pour votre circuit ExpressRoute.
- Augmenter la bande passante de votre circuit ExpressRoute à condition que la capacité disponible sur le port le permette. La rétrogradation de la bande passante d'un circuit n'est pas prise en charge.
- Modifiez le plan de mesure de Données limitées à Données illimitées. La modification du plan de limitation de Données illimitées à Données limitées n’est pas prise en charge.
- Vous pouvez activer et désactiver Autoriser les opérations classiques.
Pour plus d’informations sur les limites et les limitations, reportez-vous au FAQ ExpressRoute .
Activer le module complémentaire ExpressRoute Premium
Vous pouvez activer le module complémentaire ExpressRoute Premium pour votre circuit existant à l’aide de l’applet de commande PowerShell suivante :
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. La facturation du module complémentaire Premium démarre dès que la commande est exécutée avec succès.
Désactiver le module complémentaire ExpressRoute Premium
Important
Cette opération peut échouer si vous utilisez des ressources supérieures à ce qui est autorisé pour le circuit standard.
Considérations
- 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. Si vous ne le faites pas, votre demande de mise à jour échoue et les tarifs Premium continuent d’être appliqués.
- Vous devez dissocier tous les réseaux virtuels dans d'autres régions géopolitiques. Si vous ne le faites pas, votre demande de mise à jour échoue et les tarifs Premium continuent d’être appliqués.
- Pour le peering privé, votre table de routage doit comporter moins de 4 000 routages. 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.
Pour désactiver le module complémentaire Premium
Vous pouvez désactiver le module complémentaire ExpressRoute Premium pour votre circuit existant à l’aide de l’applet de commande PowerShell suivante :
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 ExpressRoute
Pour connaître les options de bande passante prises en charge par votre fournisseur, consultez le FAQ ExpressRoute . 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.
Important
Vous devrez peut-être recréer le circuit ExpressRoute si la capacité sur le port existant est inappropriée. Vous ne pouvez pas mettre le circuit à niveau si aucune capacité supplémentaire n’est disponible à cet emplacement.
Vous ne pouvez pas réduire la bande passante d’un circuit ExpressRoute sans interrompre le service. 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.
Redimensionner un 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 :
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. C’est à partir de là que démarre la facturation de l’option de bande passante mise à jour.
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éé. Vous devez supprimer ce circuit et en créer un nouveau de la taille nécessaire.
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 circuit
Considérations
- Vous devez annuler la liaison de tous les réseaux virtuels du circuit ExpressRoute pour que cette opération réussisse. Si cette opération échoue, vérifiez si des réseaux virtuels sont liés au circuit.
- 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é. 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.
- 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. Cette opération arrête la facturation du circuit.
Supprimer un circuit
Vous pouvez supprimer votre circuit ExpressRoute en exécutant la commande suivante :
Remove-AzureDedicatedCircuit -ServiceKey "*********************************"