この記事では、Azure Resource Mover で PowerShell を使用して Azure リソースを別の Azure リージョンに移動する方法について説明します。
このチュートリアルでは、以下の内容を学習します。
- Azure リソースを異なる Azure リージョンに移動する
Note
各チュートリアルでは、シナリオを試すための最も簡単な方法を紹介し、既定のオプションを使用します。
必須コンポーネント
次の要件を確認します。
| 要件 | 説明 |
|---|---|
| サブスクリプションのアクセス許可 | 移動するリソースを含むサブスクリプションに "所有者" アクセス権があることを確認します。 Azure サブスクリプションの特定のソースと宛先のペアに対してリソースを初めて追加すると、サブスクリプションによって信頼されているシステム割り当てマネージド ID (旧称: Managed Service ID (MSI)) が必要です。 ID を作成し、必要なロール (ソース サブスクリプションの共同作成者またはユーザー アクセス管理者) に割り当てるには、リソースを追加するのに使用するアカウントに、サブスクリプションに対する "所有者" 権限が必要です。 Azure ロールの詳細については、こちらを参照してください。 |
| Resource Mover のサポート | サポートされているリージョンとその他の一般的な質問を確認します。 |
| VM のサポート | 移動するすべての VM がサポートされていることを確認します。 - サポートされている Windows VM を確認します。 - サポートされている Linux VM とカーネルのバージョンを確認します。 - サポートされているコンピューティング、ストレージ、ネットワークの設定を確認します。 |
| SQL サポート | SQL リソースを移動する場合は、SQL の要件一覧を確認してください。 |
| 宛先サブスクリプション | 宛先リージョンのサブスクリプションには、ターゲット リージョンで移動するリソースを作成するのに十分なクォータが必要です。 クォータがない場合は、追加の制限を要求します。 |
| 宛先リージョンの料金 | VM の移動先となるターゲット リージョンに関連付する料金と課金を確認します。 料金計算ツールを使用すると便利です。 |
PowerShell の要件を確認する
リソースの移動操作は、Azure portal と PowerShell のいずれを使用しても、ほとんどの場合同じですが、いくつかの例外があります。
| 操作 | ポータル | PowerShell |
|---|---|---|
| 移動コレクションを作成する | 移動コレクション (移動しようとしているすべてのリソースの一覧) は、自動的に作成されます。 必要な ID のアクセス許可は、ポータルによってバックエンドで割り当てられます。 | 以下を実行するには、PowerShell コマンドレットを使用します。 - 移動コレクションのリソース グループを作成し、その場所を指定する。 - マネージド ID をコレクションに割り当てる。 - リソースをコレクションに追加する。 |
| 移動コレクションを削除する | ポータルでは、移動コレクションを直接削除することはできません。 | 移動コレクションを削除するには、PowerShell コマンドレットを使用します。 |
| リソースの移動操作 (準備、移動の開始、コミットなど)。 |
Resource Mover による自動検証を使用した単一の手順。 | 以下を実行するには、PowerShell コマンドレットを使用します。 1) 依存関係を検証する。 2) 移動を実行する。 |
| ソース リソースを削除する | Resource Mover ポータルで直接実行します。 | リソースの種類レベルで PowerShell コマンドレットを実行します。 |
サンプルの値
スクリプトの例では、以下の値を使用します。
| 設定 | Value |
|---|---|
| サブスクリプション ID | subscription-id |
| ソース リージョン | 米国中部 |
| ターゲット リージョン | 米国中西部 |
| リソース グループ (移動コレクションのメタデータを保持) | RG-MoveCollection-demoRMS |
| 移動コレクション名 | PS-centralus-westcentralus-demoRMS |
| リソース グループ (ソース リージョン) | PSDemoRM |
| リソース グループ (ターゲット リージョン) | PSDemoRM-target |
| リソース移動サービスの場所 | 米国東部 2 |
| IdentityType | SystemAssigned |
| 移動する VM | PSDemoVM |
Azure へのサインイン
Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。 次に、Azure Portal にサインインします。
Connect-AzAccount コマンドレットを使用して、Azure サブスクリプションにサインインします。
Connect-AzAccount –Subscription "<subscription-id>"
移動コレクションを設定する
MoveCollection オブジェクトには、移動するリソースに関するメタデータと構成情報が格納されます。 移動コレクションを設定するには、次の手順を実行します。
- 移動コレクションのリソース グループを作成します。
- MoveCollection リソースを作成できるように、サービス プロバイダーをサブスクリプションに登録します。
- マネージド ID を使用して MoveCollection オブジェクトを作成します。 Resource Mover サービスが配置されているサブスクリプションに MoveCollection オブジェクトがアクセスできるようにするには、サブスクリプションによって信頼されているシステム割り当てマネージド ID (旧称: マネージド サービス ID (MSI)) が必要です。
- マネージド ID に Resource Mover サブスクリプションへのアクセスを許可します。
リソース プロバイダーの登録
MoveCollection リソースを作成できるように、次のとおり、Microsoft.Migrate リソース プロバイダーを登録します。
Register-AzResourceProvider -ProviderNamespace Microsoft.Migrate登録を待機します。
While(((Get-AzResourceProvider -ProviderNamespace Microsoft.Migrate)| where {$_.RegistrationState -eq "Registered" -and $_.ResourceTypes.ResourceTypeName -eq "moveCollections"}|measure).Count -eq 0) { Start-Sleep -Seconds 5 Write-Output "Waiting for registration to complete." }
MoveCollection オブジェクトを作成する
次のとおり、MoveCollection オブジェクトを作成し、これにマネージド ID を割り当てます。
New-AzResourceMoverMoveCollection -Name "PS-centralus-westcentralus-demoRMS" -ResourceGroupName "RG-MoveCollection-demoRMS" -SourceRegion "centralus" -TargetRegion "westcentralus" -Location "centraluseuap" -IdentityType "SystemAssigned"
出力:
マネージド ID にアクセスを許可する
次のとおり、マネージド ID に Resource Mover サブスクリプションへのアクセスを許可します。 自分がサブスクリプションの所有者でなければなりません。
MoveCollection オブジェクトから ID の詳細を取得します。
$moveCollection = Get-AzResourceMoverMoveCollection -SubscriptionId $subscriptionId -ResourceGroupName "RG-MoveCollection-demoRMS" -Name "PS-centralus-westcentralus-demoRMS" $identityPrincipalId = $moveCollection.IdentityPrincipalIdAzure Resource Mover がサブスクリプションにアクセスしてリソースを移動しやすいように、必要なロールを ID に割り当てます。
New-AzRoleAssignment -ObjectId $identityPrincipalId -RoleDefinitionName Contributor -Scope "/subscriptions/$subscriptionId" New-AzRoleAssignment -ObjectId $identityPrincipalId -RoleDefinitionName "User Access Administrator" -Scope "/subscriptions/$subscriptionId"
移動コレクションにリソースを追加する
移動する既存のソース リソースの ID を取得します。 移動先リソース設定オブジェクトを作成し、移動コレクションにリソースを追加します。
注意
移動コレクションに追加されたリソースは、同じサブスクリプション内に存在する必要がありますが、異なるリソース グループに存在することができます。
次のとおり、リソースを追加します。
ソース リソース ID を取得します。
Get-AzResource -Name PSDemoVM -ResourceGroupName PSDemoRM出力
移動しようとしているリソースごとに、ターゲット リソース設定オブジェクトを作成します。 このケースでは VM です。
$targetResourceSettingsObj = New-Object Microsoft.Azure.PowerShell.Cmdlets.ResourceMover.Models.Api202101.VirtualMachineResourceSettingsオブジェクトに対し、リソースの種類とターゲット リソース名を設定します。
$targetResourceSettingsObj.ResourceType = "Microsoft.Compute/virtualMachines" $targetResourceSettingsObj.TargetResourceName = "PSDemoVM"注意
ターゲット VM には、ソース リージョン内の VM と同じ名前が付けられています。 別の名前を選択することもできます。
取得したリソース ID と作成したターゲット設定オブジェクトを使用して、ソース リソースを移動コレクションに追加します。
Add-AzResourceMoverMoveResource -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -SourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx xxxxxxxxxxxx/resourceGroups/ PSDemoRM/providers/Microsoft.Compute/virtualMachines/PSDemoVM" -Name "PSDemoVM" -ResourceSetting $targetResourceSettingsObj出力
依存関係を検証および追加する
追加したリソースが他のリソースに依存しているかどうかを確認し、必要に応じて追加します。
次のとおり、依存関係を検証します。
Resolve-AzResourceMoverMoveCollectionDependency -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS"出力 (依存関係が存在する場合)
不足している依存関係を特定します。
不足しているすべての依存関係の一覧を取得する場合:
Get-AzResourceMoverUnresolvedDependency -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -ResourceGroupName "RG-MoveCollection-demoRMS" -DependencyLevel Descendant出力
第 1 レベルの依存関係 (リソースの直接の依存関係) のみを取得する場合:
Get-AzResourceMoverUnresolvedDependency -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -ResourceGroupName "RG-MoveCollection-demoRMS" -DependencyLevel Direct出力
不足している未解決の依存関係を追加するには、上記の手順を繰り返してリソースを移動コレクションに追加し、未解決のリソースがなくなるまで再検証します。
注意
何かの理由でリソース コレクションからリソースを削除する場合は、こちらの記事の手順に従ってください。
リソースを準備する
通常は、移動前にソース リージョンでリソースを準備する必要があります。 次に例を示します。
- Azure 仮想ネットワーク、ネットワーク アダプター、ロード バランサー、ネットワーク セキュリティ グループなどのステートレス リソースを移動するには、Azure Resource Manager テンプレートのエクスポートが必要になることがあります。
- Azure VM や SQL データベースなどのステートフル リソースを移動するには、ソースからターゲット リージョンにリソースのレプリケートを開始する必要がある場合があります。
このチュートリアルでは VM を移動するので、ソース リソース グループを準備し、その移動を開始してコミットする必要があります。その後で、VM の準備を開始できます。
注意
既存のターゲット リソース グループがある場合は、ソース リソース グループの移動を直接コミットし、準備および移動の開始ステージをスキップできます。
VM リソースを準備する
ソース リソース グループを準備して移動した後で、移動する VM リソースを準備することができます。
VM リソースを準備する前に、依存関係を検証します。
$resp = Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResource $('psdemovm') -ValidateOnly出力
VM と共に準備する必要がある依存リソースを取得します。
$resp.AdditionalInfo[0].InfoMoveResource出力
すべての依存リソースの準備プロセスを開始します。
Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResource $('PSDemoVM','psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg')出力
Note
準備コマンドレットだけでなく、移動の開始コマンドレットやコミット コマンドレットでも、入力パラメーターとして、リソース名の代わりにソース リソース ID を指定することができます。 これを行うには、次を実行します。
Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResourceInputType MoveResourceSourceId -MoveResource $('/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/PSDemoRMS/providers/Microsoft.Network/networkSecurityGroups/PSDemoVM-nsg')
VM リソースの移動を開始する
VM リソースが "移動の開始が保留中" の状態になっていることを確認します。
Get-AzResourceMoverMoveResource -SubscriptionId " xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx " -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS " | Where-Object { $_.MoveStatusMoveState -eq “InitiateMovePending" } | Select Name出力
移動を開始します。
Invoke-AzResourceMoverInitiateMove -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResource $('psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg', 'PSDemoVM') -MoveResourceInputType "MoveResourceId"出力
破棄またはコミットしますか?
最初の移動後に、移動をコミットするか、破棄するかを決定できます。
- 破棄: テストする場合は移動を破棄できますが、実際にはソース リソースを移動したくありません。 移動を破棄すると、リソースが "移動の開始が保留中" の状態に戻ります。 このとき必要に応じて、移動をもう一度開始できます。
- コミット:コミットすると、ターゲット リージョンへの移動が完了します。 コミット後、ソース リソースは "ソースの削除が保留中" の状態になり、削除するかどうかを決定できます。
移動を破棄する
移動を破棄するには、以下を実行します。
Invoke-AzResourceMoverDiscard -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResource $('psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg', 'PSDemoVM') -MoveResourceInputType "MoveResourceId"
出力
移動をコミットする
次のようにして、移動をコミットします。
Invoke-AzResourceMoverCommit -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-centralus-westcentralus-demoRMS" -MoveResource $('psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg', ‘PSDemoVM’) -MoveResourceInputType "MoveResourceId"出力
すべてのリソースがターゲット リージョンに移動していることを確認します。
Get-AzResourceMoverMoveResource -ResourceGroupName "RG-MoveCollection-demoRMS " -MoveCollectionName "PS-centralus-westcentralus-demoRMS"すべてのリソースが、ターゲット リージョンで "ソースの削除が保留中" の状態になりました。
ソース リソースを削除する
移動をコミットし、ターゲット リージョンでリソースが想定どおりに動作することを確認したら、Azure portal、PowerShell、または Azure CLI を使用して各ソース リソースを削除できます。
次のステップ
ポータルでの Azure VM の移動に関する詳細を確認してください。