PowerShell を使用した ExpressRoute 回線の変更 (クラシック)Modify an ExpressRoute circuit using PowerShell (classic)

この記事では、ExpressRoute クラシック デプロイ モデル回線の状態確認、更新、または削除とプロビジョニング解除を行う手順について説明します。This article walks you through the steps to check the status, update, or delete and deprovision your ExpressRoute classic deployment model circuit. この記事は、クラシック デプロイ モデルに適用されます。This article applies to the classic deployment model.

重要

2017 年 3 月 1 日の時点で、クラシック デプロイ モデルに新しい ExpressRoute 回線を作成することはできません。As of March 1, 2017, you can't create new ExpressRoute circuits in the classic deployment model.

  • 接続のダウン タイムを発生させずに、クラシック デプロイ モデルから Resource Manager デプロイ モデルに既存の ExpressRoute 回線を移動できます。You can move an existing ExpressRoute circuit from the classic deployment model to the Resource Manager deployment model without experiencing any connectivity down time. 詳しくは、既存の回線の移動に関する記事をご覧ください。For more information, see Move an existing circuit.
  • allowClassicOperations を TRUE に設定することで、クラシック デプロイ モデル内の仮想ネットワークを接続できます。You can connect to virtual networks in the classic deployment model by setting allowClassicOperations to TRUE.

Resource Manager デプロイ モデルで ExpressRoute 回線を作成して管理するには、次のリンクを使用します。Use the following links to create and manage ExpressRoute circuits in the Resource Manager deployment model:

Azure のデプロイ モデルについてAbout Azure deployment models

Azure は現在、2 つのデプロイメント モデルで使用できます。Resource Manager とクラシックです。Azure currently works with two deployment models: Resource Manager and classic. これらの 2 つのモデルには、完全に互換性があるわけではありません。The two models are not completely compatible with each other. 作業を開始する前に、使用するモデルを把握しておく必要があります。Before you begin, you need to know which model that you want to work in. デプロイメント モデルについては、デプロイメント モデルの概要に関するページを参照してください。For information about the deployment models, see Understanding deployment models. Azure に慣れていない場合には、Resource Manager デプロイ モデルの使用をお勧めします。If you are new to Azure, we recommend that you use the Resource Manager deployment model.

注意

この記事は、新しい Azure PowerShell Az モジュールを使用するために更新されました。This article has been updated to use the new Azure PowerShell Az module. AzureRM モジュールはまだ使用でき、少なくとも 2020 年 12 月までは引き続きバグ修正が行われます。You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Az モジュールと AzureRM の互換性の詳細については、「Introducing the new Azure PowerShell Az module (新しい Azure PowerShell Az モジュールの概要)」を参照してください。To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az モジュールのインストール手順については、Azure PowerShell のインストールを参照してください。For Az module installation instructions, see Install Azure PowerShell.

開始する前にBefore you begin

最新バージョンの Azure Service Management (SM) PowerShell モジュールと ExpressRoute モジュールをインストールします。Install the latest versions of the Azure Service Management (SM) PowerShell modules and the ExpressRoute module. 次の例を使用する場合は、コマンドレットの新しいバージョンがリリースされると、バージョン番号 (この例では、5.1.1) が変わることに注意してください。When using the following example, note that the version number (in this example, 5.1.1) will change as newer versions of the cmdlets are released.

Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\Azure\Azure.psd1'
Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\ExpressRoute\ExpressRoute.psd1'

Azure PowerShell モジュールを使用するようにコンピューターを構成する方法の手順については、「Azure PowerShell コマンドレットの概要」を参照してください。If you need more information about Azure PowerShell, see Getting started with Azure PowerShell cmdlets for step-by-step guidance on how to configure your computer to use the Azure PowerShell modules.

Azure アカウントにサインインするには、次の例を使用します。To sign in to your Azure account, use the following example:

  1. 管理者特権で PowerShell コンソールを開き、アカウントに接続します。Open your PowerShell console with elevated rights and connect to your account. 接続については、次の例を参考にしてください。Use the following example to help you connect:

    Connect-AzAccount
    
  2. アカウントのサブスクリプションを確認します。Check the subscriptions for the account.

    Get-AzSubscription
    
  3. 複数のサブスクリプションがある場合は、使用するサブスクリプションを選択します。If you have more than one subscription, select the subscription that you want to use.

    Select-AzSubscription -SubscriptionName "Replace_with_your_subscription_name"
    
  4. 次に、次のコマンドレットを使用して、Azure サブスクリプションをクラシック デプロイ モデルの PowerShell に追加します。Next, use the following cmdlet to add your Azure subscription to PowerShell for the classic deployment model.

    Add-AzureAccount
    

回線の状態を取得するGet the status of a circuit

この情報は、 Get-AzureCircuit コマンドレットを使用していつでも取得できます。You can retrieve this information at any time by using the Get-AzureCircuit cmdlet. パラメーターを指定せずに呼び出しを実行すると、すべての回線が一覧表示されます。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

呼び出しに対するパラメーターとしてサービス キーを渡すことで、特定の ExpressRoute 回線に関する情報を取得できます。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

次の例を実行することで、すべてのパラメーターの詳細な説明を取得できます。You can get detailed descriptions of all the parameters by running the following example:

get-help get-azurededicatedcircuit -detailed

回線の変更Modify a circuit

ExpressRoute 回線の特定のプロパティは、接続に影響を与えることなく変更できます。You can modify certain properties of an ExpressRoute circuit without impacting connectivity.

ダウンタイムなく、次のタスクを実行できます。You can do the following tasks with no downtime:

  • ExpressRoute 回線の ExpressRoute Premium アドオンを有効または無効にします。Enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • ポートに使用可能な容量があれば、ExpressRoute 回線の帯域幅を増やします。Increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. 回線の帯域幅のダウングレードはサポートされていません。Downgrading the bandwidth of a circuit is not supported.
  • 課金プランを従量制課金データから無制限データに変更します。Change the metering plan from Metered Data to Unlimited Data. 無制限データから従量制課金データへの課金プランの変更はサポートされていません。Changing the metering plan from Unlimited Data to Metered Data is not supported.
  • 従来の操作の許可を有効または無効にできます。You can enable and disable Allow Classic Operations.

制限および制約事項の詳細は、「 ExpressRoute の FAQ 」を参照してください。Refer to the ExpressRoute FAQ for more information on limits and limitations.

ExpressRoute Premium アドオンを有効にするEnable the ExpressRoute premium add-on

次の PowerShell コマンドレットを使用して、既存の回線の ExpressRoute Premium アドオンを有効にできます。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

これで、回線の ExpressRoute Premium アドオン機能が有効になります。Your circuit will now have the ExpressRoute premium add-on features enabled. このコマンドが正常に実行されるとすぐに、Premium アドオン機能の課金が始まります。As soon as the command has been successfully run, billing for the premium add-on capability begins.

ExpressRoute Premium アドオンを無効にするDisable the ExpressRoute premium add-on

重要

標準回線で許可されるリソースより多くのリソースを使用する場合、この操作は失敗することがあります。This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

考慮事項Considerations

  • Premium から Standard にダウングレードする前に、回線にリンクされている仮想ネットワークの数が 10 未満であることを確認します。Make sure that the number of virtual networks linked to the circuit is less than 10 before you downgrade from premium to standard. これを行わない場合、更新要求が失敗し、Premium 料金で課金されます。If you don't do this, your update request fails, and you are billed the premium rates.
  • 他の地理的リージョンではすべての仮想ネットワークのリンクを解除する必要があります。You must unlink all virtual networks in other geopolitical regions. そうしない場合、更新要求が失敗し、Premium 料金で課金されます。If you don't, your update request fails, and you are billed the premium rates.
  • プライベート ピアリングの場合、ルート テーブルのサイズを 4,000 ルート未満にする必要があります。Your route table must be less than 4,000 routes for private peering. ルート テーブルのサイズが 4,000 ルートを超える場合、BGP セッションがドロップし、アドバタイズされたプレフィックスの数が 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.

Premium アドオンを無効にするにはTo disable the premium add-on

次の PowerShell コマンドレットを使用して、既存の回線の ExpressRoute Premium アドオンを無効にできます。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

ExpressRoute 回線の帯域幅を更新するUpdate the ExpressRoute circuit bandwidth

プロバイダーでサポートされている帯域幅のオプションについては、「 ExpressRoute の FAQ 」を確認してください。Check the ExpressRoute FAQ for supported bandwidth options for your provider. 既存の回線のサイズを超えるサイズ (回線の作成先の物理ポートで許容されるだけのサイズ) を選択することができます。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.

重要

既存のポートの容量が不十分な場合、ExpressRoute 回線の再作成が必要になる可能性があります。You may have to recreate the ExpressRoute circuit if there is inadequate capacity on the existing port. その場所に使用可能な追加の容量がない場合、回路をアップグレードすることはできません。You cannot upgrade the circuit if there is no additional capacity available at that location.

中断せずに ExpressRoute 回線の帯域幅を減らすことはできません。You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. 帯域幅をダウングレードするには、ExpressRoute 回線のプロビジョニングを解除してから、新しい ExpressRoute 回線を再度プロビジョニングする必要があります。Downgrading bandwidth requires you to deprovision the ExpressRoute circuit and then reprovision a new ExpressRoute circuit.

回線のサイズ変更Resize a 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

Microsoft 側で回線のサイズが増やされたら、接続プロバイダーに連絡し、この変更に合わせて接続プロバイダー側の構成を更新するよう依頼する必要があります。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. 更新された帯域幅のオプションの課金は、この時点から開始されます。Billing begins for the updated bandwidth option from this point on.

回線の帯域幅を増やしたときに次のエラーが発生した場合は、既存の回線が作成されている物理ポートに十分な帯域幅がないことを意味します。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. この回線を削除し、必要なサイズの新しい回線を作成する必要があります。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

回線のプロビジョニング解除と削除Deprovision and delete a circuit

考慮事項Considerations

  • この操作を正常に行うには、ExpressRoute 回線からすべての仮想ネットワークのリンクを解除する必要があります。You must unlink all virtual networks from the ExpressRoute circuit for this operation to succeed. この操作が失敗した場合は、回線にリンクされている仮想ネットワークがないか確認してください。Check to see if you have any virtual networks that are linked to the circuit if this operation fails.
  • ExpressRoute 回線サービス プロバイダーのプロビジョニング状態がプロビジョニング中またはプロビジョニング済みの場合、サービス プロバイダー側の回線のプロビジョニングを解除するには、サービス プロバイダーに連絡する必要があります。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. Microsoft は、サービス プロバイダーが回線のプロビジョニング解除を完了し、通知するまで、リソースの予約と課金を続行します。We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • サービス プロバイダーが回線をプロビジョニング解除済み (サービス プロバイダーのプロビジョニング状態が未プロビジョニングに設定されている) の場合、回線を削除することができます。If the service provider has deprovisioned the circuit (the service provider provisioning state is set to Not provisioned), you can then delete the circuit. これによって回線の課金が停止されます。This stops billing for the circuit.

回線の削除Delete a circuit

ExpressRoute 回線は、次のコマンドを実行して削除できます。You can delete your ExpressRoute circuit by running the following command:

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