使用 PowerShell 在区域之间移动资源

本文介绍如何使用 Azure 资源转移器中的 PowerShell 将 Azure 资源转移到其他 Azure 区域。

在本教程中，你将了解如何执行以下操作：

验证以下要求：

无论是使用 Azure 门户还是 PowerShell，大多数移动资源操作是相同的，只有几个例外。

在脚本示例中使用以下值：

如果没有 Azure 订阅，请在开始前创建一个试用版订阅。 然后登录到 Azure 门户。

使用 Connect-AzAccount -Environment AzureChinaCloud cmdlet 登录到你的 Azure 订阅：

Connect-AzAccount -Environment AzureChinaCloud -Subscription "<subscription-id>"

MoveCollection 对象存储有关要移动的资源的元数据和配置信息。 若要设置移动集合，请执行以下操作：

• 为移动集合创建资源组。
• 将服务提供程序注册到订阅，以便可以创建 MoveCollection 资源。
• 创建具有托管标识的 MoveCollection 对象。 为使 MoveCollection 对象能够访问资源转移器服务所在的订阅，它需要一个受订阅信任的系统分配的托管标识（以前称为托管服务标识，MSI）。
• 为托管标识授予访问资源移动器订阅的权限。

1. 注册资源提供程序 Microsoft.Migrate，以便可以创建 MoveCollection 资源，如下所示：

   Register-AzResourceProvider -ProviderNamespace Microsoft.Migrate
   

2. 等待注册：

   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 对象，并为其分配托管标识，如下所示：

New-AzResourceMoverMoveCollection -Name "PS-chinaeast-chinanorth-demoRMS"  -ResourceGroupName "RG-MoveCollection-demoRMS" -SourceRegion "chinaeast" -TargetRegion "chinanorth" -Location "chinaeast2" -IdentityType "SystemAssigned"

输出：

为托管标识授予访问资源移动器订阅的权限，如下所示。 你必须是订阅所有者。

1. 检索 MoveCollection 对象的标识详细信息。

   $moveCollection = Get-AzResourceMoverMoveCollection -SubscriptionId $subscriptionId -ResourceGroupName "RG-MoveCollection-demoRMS" -Name "PS-chinaeast-chinanorth-demoRMS"
   
   $identityPrincipalId = $moveCollection.IdentityPrincipalId
   

2. 为标识分配所需角色，以便 Azure 资源移动器可以访问你的订阅，以帮助移动资源。

   New-AzRoleAssignment -ObjectId $identityPrincipalId -RoleDefinitionName Contributor -Scope "/subscriptions/$subscriptionId"
   
   New-AzRoleAssignment -ObjectId $identityPrincipalId -RoleDefinitionName "User Access Administrator" -Scope "/subscriptions/$subscriptionId"
   

检索想要移动的现有源资源的 ID。 创建目标资源设置对象，然后将资源添加到移动集合。

添加资源，如下所示：

1. 获取源资源 ID：

   Get-AzResource -Name PSDemoVM -ResourceGroupName PSDemoRM
   

   输出

   

2. 根据要移动的资源，创建目标资源设置对象。 在本例中，它是一个 VM。

   $targetResourceSettingsObj = New-Object Microsoft.Azure.PowerShell.Cmdlets.ResourceMover.Models.Api202101.VirtualMachineResourceSettings
   

3. 为对象设置资源类型和目标资源名称。

   $targetResourceSettingsObj.ResourceType = "Microsoft.Compute/virtualMachines"
   $targetResourceSettingsObj.TargetResourceName = "PSDemoVM"
   

   注意

   我们的目标 VM 与源区域中的 VM 具有相同的名称。 你可以选择其他名称。

4. 使用已检索/创建的资源 ID 和目标设置对象，将源资源添加到移动集合。

   Add-AzResourceMoverMoveResource -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS" -SourceId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx xxxxxxxxxxxx/resourceGroups/
   PSDemoRM/providers/Microsoft.Compute/virtualMachines/PSDemoVM" -Name "PSDemoVM" -ResourceSetting $targetResourceSettingsObj
   

   输出

检查已添加的资源是否对其他资源具有依赖性，并根据需要添加。

1. 验证依赖项，如下所示：

   Resolve-AzResourceMoverMoveCollectionDependency -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"
   

   输出（如果依赖项存在）

   

2. 缺少依赖项的标识：

   • 若要检索所有缺失的依赖项的列表：

     Get-AzResourceMoverUnresolvedDependency -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS" -ResourceGroupName "RG-MoveCollection-demoRMS" -DependencyLevel Descendant
     

     输出

     

   • 若要仅检索第一级别的依赖项（资源的直接依赖项）：

     Get-AzResourceMoverUnresolvedDependency -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS" -ResourceGroupName "RG-MoveCollection-demoRMS" -DependencyLevel Direct
     

     输出

     

3. 若要添加任何未完成的缺失的依赖项，请重复上述说明，将资源添加到移动集合，并重新验证，直到没有未完成的资源。

在移动之前，通常需要在源区域中准备资源。 例如：

• 若要移动 Azure 虚拟网络、网络适配器、负载均衡器和网络安全组等无状态资源，可能需要导出 Azure 资源管理器模板。
• 若要移动 Azure VM 和 SQL 数据库等有状态的资源，可能需要开始将资源从源复制到目标区域。

在本教程中，由于我们要移动 VM，因此在开始准备 VM 前，我们需要准备源资源组，并且启用并提交其移动。

准备并移动源资源组后，我们可以为移动准备 VM 资源。

1. 在准备 VM 资源前，验证依赖项。

   $resp = Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"  -MoveResource $('psdemovm') -ValidateOnly
   

   输出

   

2. 获取需要与 VM 一起准备的依赖性资源。

   $resp.AdditionalInfo[0].InfoMoveResource
   

   输出

   

3. 为所有依赖性资源启动准备过程。

   Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"  -MoveResource $('PSDemoVM','psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg')
   

   输出

   

   注意

   可以提供源资源 ID（而不是资源名称）作为准备 cmdlet 的输入参数，在启动移动和提交 cmdlet 中同样如此。 若要执行此操作，请运行：

   Invoke-AzResourceMoverPrepare -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS" -MoveResourceInputType MoveResourceSourceId  -MoveResource $('/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/PSDemoRMS/providers/Microsoft.Network/networkSecurityGroups/PSDemoVM-nsg')
   

1. 验证 VM 资源是否处于启动移动挂起状态：

   Get-AzResourceMoverMoveResource  -SubscriptionId " xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx " -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS "   | Where-Object {  $_.MoveStatusMoveState -eq "InitiateMovePending" } | Select Name
   

   输出

   

2. 启动移动：

   Invoke-AzResourceMoverInitiateMove -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"  -MoveResource $('psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg', 'PSDemoVM') -MoveResourceInputType "MoveResourceId"
   

   输出

   

初始移动后，你可以决定是提交移动，还是放弃它。

• 放弃：如果要测试，并且不想实际移动源资源，则可能需要放弃移动。 放弃移动会将资源返回到“启动移动挂起”状态。 然后可以根据需要再次启动移动。
• 提交：提交即完成移动到目标区域的操作。 提交后，源资源将处于“删除源挂起”状态，你可以决定是否要删除它。

放弃移动：

Invoke-AzResourceMoverDiscard -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"  -MoveResource $('psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg', 'PSDemoVM') -MoveResourceInputType "MoveResourceId"

输出

1. 提交移动，如下所示：

   Invoke-AzResourceMoverCommit -ResourceGroupName "RG-MoveCollection-demoRMS" -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"  -MoveResource $('psdemovm111', 'PSDemoRM-vnet','PSDemoVM-nsg', 'PSDemoVM') -MoveResourceInputType "MoveResourceId"
   

   输出

   

2. 验证是否所有资源都已移动到目标区域：

   Get-AzResourceMoverMoveResource  -ResourceGroupName "RG-MoveCollection-demoRMS " -MoveCollectionName "PS-chinaeast-chinanorth-demoRMS"
   

   所有资源在目标区域中现在都处于“删除源挂起”状态。

提交移动并验证资源可在目标区域中按预期工作后，可以使用 PowerShell 或 Azure CLI 删除 Azure 门户中的每个源资源。

详细了解如何在门户中移动 Azure VM。