PowerShell を使用してクラシック デプロイ モデルから Resource Manager デプロイ モデルに ExpressRoute 回線を移行する

  • [アーティクル]

ExpressRoute 回線をクラシック デプロイ モデルと Resource Manager デプロイ モデルの両方で使用するには、その回線を Resource Manager デプロイ モデルに移行する必要があります。 次のセクションでは、PowerShell を使用して回線を移動する方法について説明します。

開始する前に

この記事の手順と例では、Azure PowerShell Az モジュールが使用されます。 Az モジュールをご利用のコンピューターにローカルにインストールするには、Azure PowerShell のインストールに関するページを参照してください。 Az モジュールの詳細については、「新しい Azure PowerShell Az モジュールの概要」を参照してください。 PowerShell コマンドレットは、頻繁に更新されます。 最新バージョンを実行していないと、手順で指定されている値は失敗する場合があります。 システムにインストールされている PowerShell のバージョンを確認するには、Get-Module -ListAvailable Az コマンドレットを使用します。

ExpressRoute 回線の移行

手順 1:クラシック デプロイ モデルからの回線の詳細を収集する

Azure クラシック環境にサインインし、サービス キーを収集します。

  1. Azure アカウントにサインインします。

    Add-AzureAccount

  2. 適切な Azure サブスクリプションを選択します。

    Select-AzureSubscription "<Enter Subscription Name here>"

  3. Azure および ExpressRoute 用の PowerShell モジュールをインポートします。

    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'

  4. 次のコマンドレットを使用して、すべての ExpressRoute 回線のサービス キーを取得します。 キーの取得後、Resource Manager デプロイ モデルに移行する回線のサービス キーをコピーします。

    Get-AzureDedicatedCircuit

手順 2:サインインし、リソース グループを作成する

Resource Manager 環境にサインインし、新しいリソース グループを作成します。

  1. Azure Resource Manager 環境にサインインします。

    Connect-AzAccount

  2. 適切な Azure サブスクリプションを選択します。

    Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription

  3. 次のスニペットを変更して、新しいリソース グループを作成します (まだリソース グループがない場合)。

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

手順 3:Resource Manager デプロイ モデルに ExpressRoute 回線を移行する

クラシック デプロイ モデルから Resource Manager デプロイ モデルに ExpressRoute 回線を移行する準備はできています。 先に進む前に、「クラシック デプロイ モデルから Resource Manager デプロイ モデルへの ExpressRoute 回線の移行」に記載されている情報を確認してください。

回線を移行するには、次のスニペットを変更して実行します。

Move-AzExpressRouteCircuit -Name "MyCircuit" -ResourceGroupName "DemoRG" -Location "West US" -ServiceKey "<Service-key>"

クラシック モードの場合、ExpressRoute 回線には、リージョンに関連付けられるという概念はありません。 しかし、Resource Manager の場合、すべてのリソースを Azure リージョンにマップする必要があります。 Move-AzExpressRouteCircuit コマンドレットに指定するリージョンは、技術的には任意のリージョンにすることが可能です。 組織化を目的とする場合は、ピアリングの場所を厳密に表すリージョンを選択してください。

Note

  • クラシック ExpressRoute 回線を Resource Manager デプロイ モデルに移行した後、既定でクラシック デプロイ モデルと Resource Manager デプロイ モデルの両方にアクセスできます。
  • 前のコマンドレットで表示される新しい名前を使用してリソースに対応します。 回線の名前は実質的に変更されます。

回線アクセスの変更

両方のデプロイメント モデルに対して ExpressRoute 回線アクセスを有効にするには

Resource Manager デプロイ モデルで作成された ExpressRoute 回線に対し、クラシック デプロイ モデルへのアクセスを有効にできます。 以下のコマンドレットを実行して、両方のデプロイメント モデルへのアクセスを有効にします。

  1. 回線の詳細を取得します。

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"

  2. [従来の操作の許可] を TRUE に設定します。

    $ckt.AllowClassicOperations = $true

  3. 回線を更新します。 この操作が正常に完了すると、クラシック デプロイ モデルで回線を表示できるようになります。

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

  4. 次のコマンドレットを実行して、ExpressRoute 回線の詳細を取得します。 表示されたサービス キーを確認できる必要があります。

    get-azurededicatedcircuit

  5. これで、クラシック VNet についてはクラシック デプロイ モデル コマンドを、Resource Manager VNet については Resource Manager コマンドを使用して、ExpressRoute 回線へのリンクを管理できます。 次の記事では、ExpressRoute 回線へのリンクを管理する方法について説明します。

クラシック デプロイ モデルへの ExpressRoute 回線アクセスを無効にするには

以下のコマンドレットを実行して、クラシック デプロイ モデルへのアクセスを無効にします。

  1. ExpressRoute 回線の詳細を取得します。

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"

  2. [従来の操作の許可] を FALSE に設定します。

    $ckt.AllowClassicOperations = $false

  3. 回線を更新します。 この操作が正常に完了すると、クラシック デプロイ モデルで回線を表示できなくなります。

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt

次のステップ