CLI kullanarak bir ExpressRoute devre oluşturma ve değiştirmeCreate and modify an ExpressRoute circuit using CLI

Bu makalede komut satırı arabirimi (CLI) kullanarak bir Azure ExpressRoute bağlantı hattı oluşturmayı açıklar.This article describes how to create an Azure ExpressRoute circuit by using the Command Line Interface (CLI). Bu makalede ayrıca durumu, güncelleştirme veya silme kontrol edin ve bir bağlantı hattının sağlamasını kaldırma işlemini gösterir.This article also shows you how to check the status, update, or delete and deprovision a circuit. ExpressRoute bağlantı hatları ile çalışmak için farklı bir yöntem kullanmak istiyorsanız, aşağıdaki listeden makaleyi seçebilirsiniz:If you want to use a different method to work with ExpressRoute circuits, you can select the article from the following list:

Başlamadan önceBefore you begin

Oluşturma ve bir ExpressRoute bağlantı hattı sağlamaCreate and provision an ExpressRoute circuit

1. Azure hesabınızda oturum açın ve aboneliğinizi seçin1. Sign in to your Azure account and select your subscription

Yapılandırmanızı başlamak için Azure hesabınızda oturum açın.To begin your configuration, sign in to your Azure account. "Try It" CloudShell kullanıyorsanız, otomatik olarak oturum açtınız.If you use the CloudShell "Try It", you are signed in automatically. Bağlanmanıza yardımcı olması için aşağıdaki örnekleri kullanın:Use the following examples to help you connect:

az login

Hesapla ilişkili abonelikleri kontrol edin.Check the subscriptions for the account.

az account list

Bir ExpressRoute bağlantı hattı oluşturmak istediğiniz aboneliği seçin.Select the subscription for which you want to create an ExpressRoute circuit.

az account set --subscription "<subscription ID>"

2. desteklenen sağlayıcıların, konumların ve bant genişliklerinin listesini alın2. Get the list of supported providers, locations, and bandwidths

Bir ExpressRoute bağlantı hattı oluşturmadan önce desteklenen bağlantı sağlayıcıları ve konumları bant genişliği seçenekleri listesi gerekir.Before you create an ExpressRoute circuit, you need the list of supported connectivity providers, locations, and bandwidth options. CLı komutu az network express-route list-service-providers, sonraki adımlarda kullanacağınız bu bilgileri döndürür:The CLI command az network express-route list-service-providers returns this information, which you’ll use in later steps:

az network express-route list-service-providers

Yanıt aşağıdaki örneğe benzer:The response is similar to the following example:

[
  {
    "bandwidthsOffered": [
      {
        "offerName": "50Mbps",
        "valueInMbps": 50
      },
      {
        "offerName": "100Mbps",
        "valueInMbps": 100
      },
      {
        "offerName": "200Mbps",
        "valueInMbps": 200
      },
      {
        "offerName": "500Mbps",
        "valueInMbps": 500
      },
      {
        "offerName": "1Gbps",
        "valueInMbps": 1000
      },
      {
        "offerName": "2Gbps",
        "valueInMbps": 2000
      },
      {
        "offerName": "5Gbps",
        "valueInMbps": 5000
      },
      {
        "offerName": "10Gbps",
        "valueInMbps": 10000
      }
    ],
    "id": "/subscriptions//resourceGroups//providers/Microsoft.Network/expressRouteServiceProviders/",
    "location": null,
    "name": "AARNet",
    "peeringLocations": [
      "Melbourne",
      "Sydney"
    ],
    "provisioningState": "Succeeded",
    "resourceGroup": "",
    "tags": null,
    "type": "Microsoft.Network/expressRouteServiceProviders"
  },

Yanıta bağlantı sağlayıcınız listelenip listelenmediğini denetleyin.Check the response to see if your connectivity provider is listed. Bir devreyi oluştururken ihtiyacınız olacak aşağıdaki bilgileri not edin:Make a note of the following information, which you will need when you create a circuit:

  • AdName
  • PeeringLocationsPeeringLocations
  • BandwidthsOfferedBandwidthsOffered

Bir ExpressRoute bağlantı hattı oluşturmak artık hazırsınız.You're now ready to create an ExpressRoute circuit.

3. bir ExpressRoute bağlantı hattı oluşturma3. Create an ExpressRoute circuit

Önemli

ExpressRoute bağlantı hattı, bir hizmet anahtarı verildiğinde andan itibaren faturalandırılır.Your ExpressRoute circuit is billed from the moment a service key is issued. Bağlantı sağlayıcısı devreyi sağlamak hazır olduğunda, bu işlemi gerçekleştirin.Perform this operation when the connectivity provider is ready to provision the circuit.

Bir kaynak grubu zaten sahip değilseniz, ExpressRoute devreniz oluşturmadan önce bir oluşturmanız gerekir.If you don't already have a resource group, you must create one before you create your ExpressRoute circuit. Aşağıdaki komutu çalıştırarak bir kaynak grubu oluşturabilirsiniz:You can create a resource group by running the following command:

az group create -n ExpressRouteResourceGroup -l "West US"

Aşağıdaki örnek, 200 MB/sn, Silikon vadisi ExpressRoute bağlantı hattı üzerinden Equinix oluşturma işlemi gösterilmektedir.The following example shows how to create a 200-Mbps ExpressRoute circuit through Equinix in Silicon Valley. Farklı bir sağlayıcı ve farklı ayarlar kullanıyorsanız, bu bilgileri, isteğinde bulunduğunda değiştirin.If you're using a different provider and different settings, substitute that information when you make your request.

SKU ailesi ve SKU katmanı doğru belirttiğinizden emin olun:Make sure that you specify the correct SKU tier and SKU family:

  • SKU katmanı, bir ExpressRoute devresinin Yerel, standart veya Premiumolup olmadığını belirler.SKU tier determines whether an ExpressRoute circuit is Local, Standard or Premium. Yerel, Standart veya Premiumbelirtebilirsiniz.You can specify Local, Standard or Premium.
  • SKU ailesi, fatura türü belirler.SKU family determines the billing type. Belirtebileceğiniz Metereddata ölçülen veri planı için ve Unlimiteddata sınırsız veri planı için.You can specify Metereddata for a metered data plan and Unlimiteddata for an unlimited data plan. Fatura türünden değiştirebilirsiniz Metereddata için Unlimiteddata, ancak türünden değiştiremezsiniz Unlimiteddata için Metereddata.You can change the billing type from Metereddata to Unlimiteddata, but you can't change the type from Unlimiteddata to Metereddata. Yerel devre yalnızca limiteddata ' dır.A Local circuit is Unlimiteddata only.

ExpressRoute bağlantı hattı, bir hizmet anahtarı verildiğinde andan itibaren faturalandırılır.Your ExpressRoute circuit is billed from the moment a service key is issued. Aşağıdaki örnek, bir istek için yeni bir hizmet anahtarı verilmiştir:The following example is a request for a new service key:

az network express-route create --bandwidth 200 -n MyCircuit --peering-location "Silicon Valley" -g ExpressRouteResourceGroup --provider "Equinix" -l "West US" --sku-family MeteredData --sku-tier Standard

Yanıt hizmet anahtarı içerir.The response contains the service key.

4. tüm ExpressRoute devreleri listeleyin4. List all ExpressRoute circuits

Oluşturduğunuz tüm ExpressRoute devrelerinin bir listesini almak için az network express-route list komutunu çalıştırın.To get a list of all the ExpressRoute circuits that you created, run the az network express-route list command. Bu komutu kullanarak bu bilgileri istediğiniz zaman alabilir.You can retrieve this information at any time by using this command. Tüm devreler listelemek için parametresiz çağrısı yapın.To list all circuits, make the call with no parameters.

az network express-route list

Hizmet anahtarınız listelenen Servicekey'ini yanıtın alan.Your service key is listed in the ServiceKey field of the response.

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

Komutunu çalıştırarak, tüm parametrelerin ayrıntılı açıklamaları alabilirsiniz '-h' parametresi.You can get detailed descriptions of all the parameters by running the command using the '-h' parameter.

az network express-route list -h

5. sağlama için hizmet anahtarını bağlantı sağlayıcınıza gönderin5. Send the service key to your connectivity provider for provisioning

'ServiceProviderProvisioningState' hizmet sağlayıcı tarafta sağlama geçerli durumu hakkında bilgi sağlar.'ServiceProviderProvisioningState' provides information about the current state of provisioning on the service-provider side. Durum Microsoft tarafında durumu sağlar.The status provides the state on the Microsoft side. Daha fazla bilgi için iş akışları makale.For more information, see the Workflows article.

Yeni bir ExpressRoute bağlantı hattı'ı oluşturduğunuzda, bağlantı hattı şu durumda olur:When you create a new ExpressRoute circuit, the circuit is in the following state:

"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"

Bağlantı sağlayıcısı, etkinleştirmeden sürecinde olduğunda bağlantı hattının aşağıdaki duruma değiştirir:The circuit changes to the following state when the connectivity provider is in the process of enabling it for you:

"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"

Bir ExpressRoute bağlantı hattı kullanabilmek için şu durumda olmalıdır:For you to be able to use an ExpressRoute circuit, it must be in the following state:

"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled

6. her düzenli olarak devre anahtarı durumunu ve durumunu kontrol edin6. Periodically check the status and the state of the circuit key

Durum ve bağlantı hattı tuşunun durumunu denetleme, sağlayıcınız bağlantı hattınızın etkin olduğunda bilmenizi sağlar.Checking the status and the state of the circuit key lets you know when your provider has enabled your circuit. Bağlantı hattı yapılandırıldıktan sonra 'ServiceProviderProvisioningState' 'Sağlanıyor' aşağıdaki örnekte gösterildiği gibi görünür:After the circuit has been configured, 'ServiceProviderProvisioningState' appears as 'Provisioned', as shown in the following example:

az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit

Yanıt aşağıdaki örneğe benzer:The response is similar to the following example:

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

7. yönlendirme yapılandırmanızı oluşturun7. Create your routing configuration

Adım adım yönergeler için bkz: ExpressRoute bağlantı hattı yönlendirme yapılandırması makale oluşturma ve değiştirme devre eşlemeleri.For step-by-step instructions, see the ExpressRoute circuit routing configuration article to create and modify circuit peerings.

Önemli

Bu yönergeler yalnızca Katman 2 bağlantı hizmetleri sunan hizmet sağlayıcıları ile oluşturulan bağlantı hatları için geçerlidir.These instructions only apply to circuits that are created with service providers that offer layer 2 connectivity services. Yönetilen sunan bir hizmet sağlayıcısı kullanıyorsanız, Katman 3 Hizmetleri (genellikle bir IP VPN, MPLS gibi), bağlantı sağlayıcınız yapılandırır ve yönlendirmeyi sizin için yönetir.If you're using a service provider that offers managed layer 3 services (typically an IP VPN, like MPLS), your connectivity provider configures and manages routing for you.

Ardından, bir sanal ağ, ExpressRoute bağlantı hattına bağlayın.Next, link a virtual network to your ExpressRoute circuit. Kullanım sanal ağları ExpressRoute devresine bağlama makalesi.Use the Linking virtual networks to ExpressRoute circuits article.

Bir ExpressRoute bağlantı hattını değiştirmeModifying an ExpressRoute circuit

Belirli bir ExpressRoute bağlantı hattı özelliklerini bağlantıyı etkilemeden değiştirebilirsiniz.You can modify certain properties of an ExpressRoute circuit without impacting connectivity. Kapalı kalma süresi olmadan aşağıdaki değişiklikleri yapabilir:You can make the following changes with no downtime:

  • Etkinleştirebilir veya ExpressRoute bağlantı hattı için ExpressRoute premium eklenti devre dışı bırakın.You can enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • Sağlanmış kapasite kullanılabilir bağlantı noktası üzerinde ExpressRoute bağlantı hattı bant genişliğini artırabilirsiniz.You can increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. Ancak, bir bağlantı hattı bant önceki sürüme indirme desteklenmiyor.However, downgrading the bandwidth of a circuit is not supported.
  • Sınırsız veri ölçülen verilerden ölçüm planı değiştirebilirsiniz.You can change the metering plan from Metered Data to Unlimited Data. Ancak, ölçüm plan sınırsız verilerden ölçülen veri değiştirilmesi desteklenmiyor.However, changing the metering plan from Unlimited Data to Metered Data is not supported.
  • Etkinleştirebilir ve devre dışı Klasik işlemlere izin Ver'i.You can enable and disable Allow Classic Operations.

Sınırlar ve sınırlamalar hakkında daha fazla bilgi için bkz. ExpressRoute SSS.For more information on limits and limitations, see the ExpressRoute FAQ.

ExpressRoute premium eklentisi etkinleştirmek içinTo enable the ExpressRoute premium add-on

ExpressRoute premium eklentisi aşağıdaki komutu kullanarak, varolan bağlantı hattınız için etkinleştirebilirsiniz:You can enable the ExpressRoute premium add-on for your existing circuit by using the following command:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium

Bağlantı hattı artık etkin ExpressRoute premium eklenti özellikleri vardır.The circuit now has the ExpressRoute premium add-on features enabled. Komut başarıyla çalıştırıldı hemen sonra için premium eklenti özelliğini fatura başlamadan.We begin billing you for the premium add-on capability as soon as the command has successfully run.

ExpressRoute premium eklentisi devre dışı bırakmak içinTo disable the ExpressRoute premium add-on

Önemli

Bu işlem için standart devreyi izin daha büyük olan kaynaklar kullanıyorsanız, başarısız olabilir.This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

ExpressRoute premium eklentisi devre dışı bırakmadan önce aşağıdaki ölçütleri de anlamanız:Before disabling the ExpressRoute premium add-on, understand the following criteria:

  • Premium katmanından standart sürümüne düşürme önce işlem hattına bağlı 10'dan az sanal ağlara sahip emin olmanız gerekir.Before you downgrade from premium to standard, you must make sure that you have fewer than 10 virtual networks linked to the circuit. 10'dan fazla varsa, güncelleştirme isteği başarısız olur ve premium fiyatları üzerinden faturalandırılırsınız.If you have more than 10, your update request fails, and we bill you at premium rates.
  • Diğer jeopolitik bölgede tüm sanal ağları bağlantısını kaldırmanız gerekir.You must unlink all virtual networks in other geopolitical regions. Tüm sanal ağları bağlantısını yok ise, güncelleştirme isteği başarısız olur ve premium fiyatları üzerinden faturalandırılırsınız.If you don't unlink all your virtual networks, your update request fails and we bill you at premium rates.
  • Özel eşdüzey hizmet sağlama için 4000'den az yollar yol tablonuz olması gerekir.Your route table must be less than 4,000 routes for private peering. Rota tablosu boyutunuz 4000 yollara kıyasla daha büyükse, BGP oturumu bırakır.If your route table size is greater than 4,000 routes, the BGP session drops. Tanıtılan ön ek sayısı 4.000 olana kadar oturumu yeniden iler hale gerekmez.The session won't be reenabled until the number of advertised prefixes is below 4,000.

Aşağıdaki örneği kullanarak mevcut bir devreyi için ExpressRoute premium eklentisi devre dışı bırakabilirsiniz:You can disable the ExpressRoute premium add-on for the existing circuit by using the following example:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard

ExpressRoute bağlantı hattı bant genişliğini güncelleştirmek içinTo update the ExpressRoute circuit bandwidth

Denetimi sağlayıcınız için desteklenen bir bant genişliği seçenekleri için ExpressRoute SSS.For the supported bandwidth options for your provider, check the ExpressRoute FAQ. Mevcut bağlantı hattınızın boyutundan daha büyük herhangi bir boyutta seçebilirsiniz.You can pick any size greater than the size of your existing circuit.

Önemli

Var olan bağlantı noktası üzerinde yeterli kapasitesi varsa, ExpressRoute bağlantı hattı yeniden oluşturmanız gerekebilir.If there is inadequate capacity on the existing port, you may have to recreate the ExpressRoute circuit. Yoksa hiçbir ek kapasite kullanılabilir o konumda devre yükseltemezsiniz.You cannot upgrade the circuit if there is no additional capacity available at that location.

Kesintisiz bir ExpressRoute bağlantı hattı bant indiremezsiniz.You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. Bant genişliği eski sürüme düşürme, ExpressRoute bağlantı hattının sağlamasını kaldırma ve ardından yeni ExpressRoute bağlantı hattı yeniden sağlamak gerektirir.Downgrading bandwidth requires you to deprovision the ExpressRoute circuit, and then reprovision a new ExpressRoute circuit.

Gereksinim boyutu karar verdikten sonra bağlantı hattınızı yeniden boyutlandırmak için aşağıdaki komutu kullanın:After you decide the size you need, use the following command to resize your circuit:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000

Bağlantı hattınız Microsoft tarafında boyutlandırılır.Your circuit is sized up on the Microsoft side. Ardından, bu değişikliği eşleşecek şekilde kendi tarafında yapılandırmaları güncelleştirmek için bağlantı sağlayıcınıza başvurmanız gerekir.Next, you must contact your connectivity provider to update configurations on their side to match this change. Bu bildirim yaptıktan sonra güncelleştirilmiş bant seçeneği için faturalama başlayın.After you make this notification, we begin billing you for the updated bandwidth option.

SKU taşımak için sınırsız olarak ölçülürTo move the SKU from metered to unlimited

Aşağıdaki örneği kullanarak bir ExpressRoute bağlantı hattı SKU'su değiştirebilirsiniz:You can change the SKU of an ExpressRoute circuit by using the following example:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData

Klasik ve Resource Manager ortamları erişimi denetlemek içinTo control access to the classic and Resource Manager environments

Gözden geçirme yönergeleri Resource Manager dağıtım modeline taşıma ExpressRoute devreleri Klasikten.Review the instructions in Move ExpressRoute circuits from the classic to the Resource Manager deployment model.

Sağlama kaldırmayı ve bir ExpressRoute bağlantı hattı siliniyorDeprovisioning and deleting an ExpressRoute circuit

Sağlamasını kaldırma ve bir ExpressRoute bağlantı hattını silmek için aşağıdaki ölçütleri anladığınızdan emin olun:To deprovision and delete an ExpressRoute circuit, make sure you understand the following criteria:

  • ExpressRoute bağlantı hattınızdaki tüm sanal ağların bağlantısını kaldırmanız gerekir.You must unlink all virtual networks from the ExpressRoute circuit. Bu işlem başarısız olursa, tüm sanal ağları işlem hattına bağlı olmadığını denetleyin.If this operation fails, check to see if any virtual networks are linked to the circuit.
  • ExpressRoute bağlantı hattı Hizmet Sağlayıcısı sağlama durumu ise sağlama veya sağlanan, kendi tarafında bağlantı hattını sağlamasını kaldırmak için hizmet sağlayıcınızla birlikte çalışmanız gerekir.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. Kaynak ayırmanıza ve hizmeti sağlayıcısı devreyi sağlamayı kaldırma tamamlandıktan ve bize bildiren kadar faturalandırılırsınız devam ediyoruz.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • Hizmet sağlayıcısı devreyi sağlamayı durdurduğunda devre silebilirsiniz.You can delete the circuit if the service provider has deprovisioned the circuit. Bir devreyi sağlaması, hizmet sağlayıcısı sağlama durumu kümesine sağlanmadı.When a circuit is deprovisioned, the service provider provisioning state is set to Not provisioned. Bu durumda bağlantı hattının faturalandırılması durdurulur.This stops billing for the circuit.

Aşağıdaki komutu çalıştırarak, ExpressRoute devreniz silebilirsiniz:You can delete your ExpressRoute circuit by running the following command:

az network express-route delete  -n MyCircuit -g ExpressRouteResourceGroup

Sonraki adımlarNext steps

Bağlantı hattınızı oluşturduktan sonra aşağıdaki görevleri gerçekleştirmek emin olun:After you create your circuit, make sure that you do the following tasks: