Quickstart: Een ExpressRoute-circuit maken en wijzigen met behulp van Azure PowerShell

  • Artikel

Deze quickstart laat zien hoe u een ExpressRoute-circuit maakt met behulp van PowerShell-cmdlets en het Azure Resource Manager-implementatiemodel. U kunt ook de status van een circuit controleren, een circuit bijwerken of verwijderen, of de inrichting ervan ongedaan maken.

Diagram of ExpressRoute circuit deployment environment using Azure PowerShell.

Vereisten

Azure Cloud Shell

Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde Cloud Shell-opdrachten gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.

Om Azure Cloud Shell op te starten:

Optie Voorbeeld/koppeling
Selecteer Uitproberen in de rechterbovenhoek van een code- of opdrachtblok. Als u Try It selecteert, wordt de code of opdracht niet automatisch gekopieerd naar Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen. Button to launch Azure Cloud Shell.
Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal. Screenshot that shows the Cloud Shell button in the Azure portal

Azure Cloud Shell gebruiken:

  1. Start Cloud Shell.

  2. Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.

  3. Plak de code of opdracht in de Cloud Shell-sessie door Ctrl+Shift+V in Windows en Linux te selecteren of door Cmd+Shift+V te selecteren in macOS.

  4. Selecteer Enter om de code of opdracht uit te voeren.

Een ExpressRoute-circuit maken en inrichten

Aanmelden bij uw Azure-account en uw abonnement selecteren

Als u Azure Cloud Shell gebruikt, wordt u automatisch aangemeld bij uw Azure-account nadat u op Probeer het nu hebt geklikt. Als u zich lokaal wil aanmelden, opent u de PowerShell-console met verhoogde rechten en voert u de cmdlet uit om verbinding te maken.

Connect-AzAccount

Als u meer dan één abonnement hebt, haalt u een lijst met uw abonnementen op.

Get-AzSubscription

Geef het abonnement op dat u wilt gebruiken.

Select-AzSubscription -SubscriptionName "Name of subscription"

De lijst met ondersteunde providers, locaties en bandbreedten ophalen

U kunt pas een ExpressRoute-circuit maken als u beschikt over de lijst met ondersteunde connectiviteitsproviders, locaties en bandbreedte-opties.

De PowerShell-cmdlet Get-AzExpressRouteServiceProvider retourneert deze informatie, die u in latere stappen gebruikt:

Get-AzExpressRouteServiceProvider

Controleer deze om te zien of uw connectiviteitsprovider wordt vermeld. Noteer de volgende gegevens, aangezien u die later nodig hebt bij het maken van een circuit:

  • Naam
  • PeeringLocations
  • BandwidthsOffered

U bent nu klaar om een ExpressRoute-circuit te maken.

Een ExpressRoute-circuit maken

Als u nog geen resourcegroep hebt, moet u er een maken voordat u het ExpressRoute-circuit maakt. U doet dit door de volgende opdracht uit te voeren:

New-AzResourceGroup -Name "ExpressRouteResourceGroup" -Location "West US"

In het volgende voorbeeld ziet u hoe u een ExpressRoute-circuit van 200 Mbps maakt met behulp van Equinix in Silicon Valley. Als u een andere provider en andere instellingen gebruikt, vervangt u de gegevens uit het voorbeeld door uw gegevens wanneer u uw aanvraag verstuurt. Gebruik het volgende voorbeeld om een nieuwe servicesleutel aan te vragen:

New-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup" -Location "West US" -SkuTier Standard -SkuFamily MeteredData -ServiceProviderName "Equinix" -PeeringLocation "Silicon Valley" -BandwidthInMbps 200

Zorg ervoor dat u de juiste SKU-categorie en SKU-familie opgeeft:

  • De SKU-categorie bepaalt of een ExpressRoute-circuit Local, Standard of Premium is. U kunt Local, *Standard of Premium opgeven.
  • De SKU-familie bepaalt het type facturering. U kunt MeteredData opgeven voor een data-abonnement met een datalimiet en UnlimitedData voor een onbeperkt data-abonnement. U kunt het type facturering wijzigen van MeteredData in UnlimitedData, maar niet van UnlimitedData in MeteredData. Een Local circuit kan alleen UnlimitedData zijn.

Belangrijk

Vanaf het moment dat een servicesleutel is uitgegeven, worden er kosten voor een ExpressRoute-circuit in rekening gebracht. Zorg ervoor dat u deze bewerking uitvoert wanneer de connectiviteitsprovider gereed is om het circuit in te richten.

Het antwoord bevat de servicesleutel. U kunt gedetailleerde beschrijvingen van alle parameters opvragen door de volgende opdracht uit te voeren:

get-help New-AzExpressRouteCircuit -detailed

Alle ExpressRoute-circuits opvragen

Als u een lijst wilt weergeven met alle ExpressRoute-circuits die u hebt gemaakt, voert u de opdracht Get-AzExpressRouteCircuit uit:

Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

Het antwoord ziet er ongeveer uit als in het volgende voorbeeld:

Name                             : ExpressRouteARMCircuit
ResourceGroupName                : ExpressRouteResourceGroup
Location                         : westus
Id                               : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag                             : W/"################################"
ProvisioningState                : Succeeded
Sku                              : {
                                    "Name": "Standard_MeteredData",
                                    "Tier": "Standard",
                                    "Family": "MeteredData"
                                    }
CircuitProvisioningState          : Enabled
ServiceProviderProvisioningState  : NotProvisioned
ServiceProviderNotes              :
ServiceProviderProperties         : {
                                    "ServiceProviderName": "Equinix",
                                    "PeeringLocation": "Silicon Valley",
                                    "BandwidthInMbps": 200
                                    }
ServiceKey                        : **************************************
Peerings                          : []

U kunt deze informatie op elk gewenst moment opvragen met behulp van de cmdlet Get-AzExpressRouteCircuit. Als u de aanroep gebruikt zonder parameters, worden alle circuits weergegeven. Uw servicesleutel wordt vermeld in het veld ServiceKey:

Get-AzExpressRouteCircuit

Het antwoord ziet er ongeveer uit als in het volgende voorbeeld:

Name                             : ExpressRouteARMCircuit
ResourceGroupName                : ExpressRouteResourceGroup
Location                         : westus
Id                               : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag                             : W/"################################"
ProvisioningState                : Succeeded
Sku                              : {
                                    "Name": "Standard_MeteredData",
                                    "Tier": "Standard",
                                    "Family": "MeteredData"
                                    }
CircuitProvisioningState         : Enabled
ServiceProviderProvisioningState : NotProvisioned
ServiceProviderNotes             :
ServiceProviderProperties        : {
                                    "ServiceProviderName": "Equinix",
                                    "PeeringLocation": "Silicon Valley",
                                    "BandwidthInMbps": 200
                                    }
ServiceKey                       : **************************************
Peerings                         : []

De servicesleutel voor inrichting verzenden naar de connectiviteitsprovider

ServiceProviderProvisioningState biedt informatie over de huidige status van het inrichten aan de kant van de serviceprovider. CircuitProvisioningState biedt u de status aan de Zijde van Microsoft. Zie Werkstromen voor meer informatie over de inrichtingsstatussen van circuits.

Wanneer u een nieuw ExpressRoute-circuit maakt, heeft het circuit de volgende status:

ServiceProviderProvisioningState : NotProvisioned
CircuitProvisioningState         : Enabled

Wanneer de connectiviteitsprovider bezig is met het inschakelen van uw circuit, verandert de status van het circuit in:

ServiceProviderProvisioningState : Provisioning
CircuitProvisioningState         : Enabled

Als u het ExpressRoute-circuit wilt gebruiken, moet het de volgende status hebben:

ServiceProviderProvisioningState : Provisioned
CircuitProvisioningState         : Enabled

Controleer regelmatig de circuitstatus en de status van de circuitsleutel

Als u de status en de status van de servicesleutel controleert, weet u wanneer uw provider uw circuit heeft ingericht. Nadat het circuit is geconfigureerd, wordt ServiceProviderProvisioningState weergegeven als Ingericht, zoals wordt weergegeven in het volgende voorbeeld:

Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

Het antwoord ziet er ongeveer uit als in het volgende voorbeeld:

Name                             : ExpressRouteARMCircuit
ResourceGroupName                : ExpressRouteResourceGroup
Location                         : westus
Id                               : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag                             : W/"################################"
ProvisioningState                : Succeeded
Sku                              : {
                                    "Name": "Standard_MeteredData",
                                    "Tier": "Standard",
                                    "Family": "MeteredData"
                                    }
CircuitProvisioningState         : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes             :
ServiceProviderProperties        : {
                                    "ServiceProviderName": "Equinix",
                                    "PeeringLocation": "Silicon Valley",
                                    "BandwidthInMbps": 200
                                    }
ServiceKey                       : **************************************
Peerings                         : []

De routeringsconfiguratie maken

Raadpleeg het artikel over de routeringsconfiguratie voor ExpressRoute-circuits voor stapsgewijze instructies over het maken en wijzigen van circuitpeerings.

Belangrijk

Deze instructies zijn alleen van toepassing op circuits die zijn gemaakt met serviceproviders die services met laag-2-connectiviteit aanbieden. Als u gebruikmaakt van een serviceprovider die beheerde laag-3-services aanbiedt (meestal een IP-adres voor VPN, zoals MPLS), wordt de routering voor u geconfigureerd en beheerd via de connectiviteitsprovider.

Koppel vervolgens een virtueel netwerk aan een ExpressRoute-circuit. Gebruik het artikel Virtuele netwerken koppelen aan ExpressRoute-circuits wanneer u werkt met het Resource Manager-implementatiemodel.

De status van een ExpressRoute-circuit ophalen

U kunt deze informatie op elk gewenst moment opvragen met behulp van de cmdlet Get-AzExpressRouteCircuit. Als u de aanroep gebruikt zonder parameters, worden alle circuits weergegeven.

Get-AzExpressRouteCircuit

Het antwoord is vergelijkbaar met het volgende voorbeeld:

Name                             : ExpressRouteARMCircuit
ResourceGroupName                : ExpressRouteResourceGroup
Location                         : westus
Id                               : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag                             : W/"################################"
ProvisioningState                : Succeeded
Sku                              : {
                                    "Name": "Standard_MeteredData",
                                    "Tier": "Standard",
                                    "Family": "MeteredData"
                                    }
CircuitProvisioningState         : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes             :
ServiceProviderProperties        : {
                                        "ServiceProviderName": "Equinix",
                                        "PeeringLocation": "Silicon Valley",
                                        "BandwidthInMbps": 200
                                    }
ServiceKey                       : **************************************
Peerings                         : []

U kunt informatie over een specifiek ExpressRoute-circuit verkrijgen door de naam van de resourcegroep en de naam van het circuit als een parameter aan de aanroep door te geven:

Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

Het antwoord ziet er ongeveer uit als in het volgende voorbeeld:

Name                             : ExpressRouteARMCircuit
ResourceGroupName                : ExpressRouteResourceGroup
Location                         : westus
Id                               : /subscriptions/***************************/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag                             : W/"################################"
ProvisioningState                : Succeeded
Sku                              : {
                                        "Name": "Standard_MeteredData",
                                        "Tier": "Standard",
                                        "Family": "MeteredData"
                                    }
CircuitProvisioningState         : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes             :
ServiceProviderProperties        : {
                                        "ServiceProviderName": "Equinix",
                                        "PeeringLocation": "Silicon Valley",
                                        "BandwidthInMbps": 200
                                    }
ServiceKey                       : **************************************
Peerings                         : []

U kunt gedetailleerde beschrijvingen van alle parameters opvragen door de volgende opdracht uit te voeren:

get-help Get-AzExpressRouteCircuit -detailed

Een ExpressRoute-circuit wijzigen

U kunt bepaalde eigenschappen van een ExpressRoute-circuit wijzigen zonder dat dit van invloed is op de connectiviteit.

U kunt de volgende taken uitvoeren zonder dat dit resulteert in downtime:

  • Een ExpressRoute Premium-invoegtoepassing in- of uitschakelen voor uw ExpressRoute-circuit.
  • De bandbreedte van uw ExpressRoute-circuit verhogen, mits er capaciteit beschikbaar is op de poort. Het verminderen van de bandbreedte van een circuit wordt niet ondersteund.
  • Het verbruiksabonnement wijzigen van Datalimiet in Onbeperkte data. Het verbruiksabonnement wijzigen van Onbeperkte data in Datalimiet wordt niet ondersteund.
  • U kunt klassieke bewerkingen toestaan in- en uitschakelen.

Zie de Veelgestelde vragen over ExpressRoute voor meer informatie over limieten en beperkingen.

Premium-invoegtoepassing voor ExpressRoute inschakelen

U kunt de ExpressRoute Premium-invoegtoepassing inschakelen voor uw bestaande circuit met behulp van het volgende PowerShell-fragment:

$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

$ckt.Sku.Tier = "Premium"
$ckt.sku.Name = "Premium_MeteredData"

Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

De functies van de ExpressRoute Premium-invoegtoepassing zijn nu ingeschakeld voor het circuit. We beginnen u te factureren voor de premium-invoegtoepassing zodra de opdracht is uitgevoerd.

Premium-invoegtoepassing voor ExpressRoute uitschakelen

Belangrijk

Deze bewerking kan mislukken als u resources gebruikt die groter zijn dan wat is toegestaan voor het Standard-circuit.

Let op de volgende informatie:

  • Voordat u een downgrade uitvoert van Premium naar Standard, moet u ervoor zorgen dat het aantal virtuele netwerken dat is gekoppeld aan het circuit, kleiner is dan 10. Als u dat niet doet, mislukt de aanvraag en wordt u gefactureerd tegen Premium-tarieven.
  • Alle virtuele netwerken in andere geopolitieke regio's moeten eerst worden ontkoppeld. Als u de koppeling niet verwijdert, mislukt uw updateaanvraag en blijven we u factureren tegen premiumtarieven.
  • De routetabel moet kleiner zijn dan 4.000 routes voor persoonlijke peering. Als de grootte van de routetabel groter is dan 4000 routes, wordt de BGP-sessie verwijderd. De BGP-sessie wordt pas opnieuw tot stand gebracht als het aantal geadverteerde voorvoegsels minder is dan 4000.

U kunt de ExpressRoute Premium-invoegtoepassing uitschakelen voor het bestaande circuit met behulp van het volgende PowerShell-cmdlet:

$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

$ckt.Sku.Tier = "Standard"
$ckt.sku.Name = "Standard_MeteredData"

Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

De bandbreedte van het ExpressRoute-circuit bijwerken

Informatie over ondersteunde bandbreedte-opties voor uw provider vindt u in de Veelgestelde vragen over ExpressRoute. U kunt elke grootte kiezen die groter is dan de grootte van uw bestaande circuit.

Belangrijk

Mogelijk moet u het ExpressRoute-circuit opnieuw maken als er onvoldoende capaciteit is op de bestaande poort. U kunt het circuit niet upgraden als er geen extra capaciteit beschikbaar is op de betreffende locatie.

Het is niet mogelijk om de bandbreedte van een ExpressRoute-circuit zonder onderbreking te verminderen. Voor het verminderen van de bandbreedte moet u de inrichting van het ExpressRoute-circuit ongedaan maken, en vervolgens een nieuw ExpressRoute-circuit inrichten.

Nadat u hebt bepaald welke grootte u nodig hebt, gebruikt u de volgende opdracht om de grootte van het circuit te wijzigen:

$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

$ckt.ServiceProviderProperties.BandwidthInMbps = 1000

Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

Uw circuit wordt bijgewerkt aan de zijde van Microsoft. Vervolgens moet u contact opnemen met uw connectiviteitsprovider om configuraties aan hun zijde bij te werken met deze wijziging. Nadat u deze melding hebt gedaan, wordt u gefactureerd voor de bijgewerkte bandbreedte-optie.

De SKU wijzigen van Datalimiet in Onbeperkte data

U kunt de SKU van een ExpressRoute-circuit wijzigen met behulp van het volgende PowerShell-fragment:

$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

$ckt.Sku.Family = "UnlimitedData"
$ckt.sku.Name = "Premium_UnlimitedData"

Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

De toegang tot de klassieke omgeving en de Resource Manager-omgeving beheren

Lees de instructies in het artikel over het verplaatsen van ExpressRoute-circuits van het klassieke naar het Resource Manager-implementatiemodel.

De inrichting van een ExpressRoute-circuit ongedaan maken

Let op de volgende informatie:

  • Alle virtuele netwerken moeten worden losgekoppeld van het ExpressRoute-circuit. Als deze bewerking mislukt, controleert u of er virtuele netwerken zijn gekoppeld aan het circuit.
  • Als de serviceprovider van het circuit de inrichtingsstatus Inrichten of Ingericht heeft, moet u contact opnemen met de serviceprovider om de inrichting van het circuit aan hun zijde ongedaan te maken. We blijven resources reserveren en kosten in rekening brengen, totdat de serviceprovider de inrichting van het circuit helemaal ongedaan heeft gemaakt en ons op de hoogte heeft gesteld.
  • Als de serviceprovider de inrichting van het circuit ongedaan heeft gemaakt, wat betekent dat de inrichtingsstatus van de serviceprovider wordt ingesteld op Niet ingericht, kunt u het circuit verwijderen. De facturering voor het circuit stopt.

Resources opschonen

U kunt uw ExpressRoute-circuit verwijderen door de volgende opdracht uit te voeren:

Remove-AzExpressRouteCircuit -ResourceGroupName "ExpressRouteResourceGroup" -Name "ExpressRouteARMCircuit"

Volgende stappen

Nadat u het circuit hebt gemaakt en het circuit is ingericht bij uw provider, gaat u verder met de volgende stap om de peering te configureren:

Routering voor uw ExpressRoute-circuit maken en wijzigen