使用 Azure PowerShell 将 IaaS 资源从经典部署模型迁移到 Azure 资源管理器

以下步骤演示了如何使用 Azure PowerShell 命令将基础结构即服务 (IaaS) 资源从经典部署模型迁移到 Azure 资源管理器部署模型。

也可根据需要通过 Azure 命令行接口 (Azure CLI) 迁移资源。


下面是一个流程图,用于确定在迁移过程中需要执行步骤的顺序

Screenshot that shows the migration steps

Note

本文进行了更新,以便使用新的 Azure PowerShell Az 模块。 AzureRM 将继续获取关键的 bug 修复更新,但新功能将只出现在 Az 模块中。

  • 若要在本地安装 Az 模块,请参阅安装 Azure PowerShell
  • 如果在本地安装 Az 模块,可通过运行 Enable-AzureRmAlias 来启用 AzureRM 兼容性。

步骤 1:规划迁移

下面是建议在将 IaaS 资源从经典部署模型迁移到 Resource Manager 部署模型时遵循的一些最佳实践:

  • 通读受支持的和不受支持的功能和配置。 如果虚拟机使用不受支持的配置或功能,建议等到我们宣布支持该配置/功能时再进行迁移。 也可根据需要删除该功能或移出该配置,以利迁移进行。
  • 如果通过自动化脚本来部署目前的基础结构和应用程序,则可尝试使用这些脚本进行迁移,以便创建类似的测试性设置。 也可以使用 Azure 门户设置示例环境。

Important

目前不支持通过应用程序网关从经典部署模型迁移到 Resource Manager 部署模型。 如果要迁移带应用程序网关的经典虚拟网络,请先删除该网关,然后运行准备操作来移动网络。 完成迁移后,在 Azure Resource Manager 中重新连接该网关。

无法自动迁移其他订阅中连接到 ExpressRoute 线路的 ExpressRoute 网关。 此类情况下,请删除 ExpressRoute 网关、迁移虚拟网络并重新创建网关。 有关详细信息,请参阅将 ExpressRoute 线路和关联的虚拟网络从经典部署模型迁移到资源管理器部署模型

步骤 2:安装最新版本的 Azure PowerShell

有两个主要选项可供安装 Azure PowerShell:PowerShell 库Web 平台安装程序 (WebPI)。 WebPI 接收每月的更新。 PowerShell 库会持续接收更新。 本文基于 Azure PowerShell 2.1.0 版。

如需安装说明,请参阅 How to install and configure Azure PowerShell(如何安装和配置 Azure PowerShell)。


步骤 3:确保你是 Azure 门户中订阅的管理员

若要执行此迁移,必须在 Azure 门户中将你添加为订阅的协同管理员。

  1. 登录到 Azure 门户
  2. 在“中心”菜单上,选择“订阅”。 如果看不到该选项,请选择“所有服务”。
  3. 查找相应订阅项,并查看“我的角色”字段。 对于协同管理员,该值应为“帐户管理员”。

如果无法添加协同管理员,请联系订阅的服务管理员或协同管理员,将自己添加为协同管理员。

步骤 4:设置订阅并针对迁移进行注册

首先,请启动 PowerShell 提示符。 对于迁移,需要针对经典部署模型和 Resource Manager 部署模型设置环境。

登录到 Resource Manager 模型的帐户。

    Connect-AzAccount -Environment AzureChinaCloud

使用以下命令获取可用订阅:

    Get-AzSubscription | Sort Name | Select Name

设置当前会话的 Azure 订阅。 此示例将默认订阅名称设置为 My Azure Subscription。 将示例订阅名称替换成自己的名称。

    Select-AzSubscription -SubscriptionName "My Azure Subscription"

Note

注册是一次性步骤,但必须在尝试迁移之前完成。 如果不注册,则会出现以下错误消息:

BadRequest:Subscription is not registered for migration.(BadRequest:订阅尚未注册迁移。)

使用以下命令向迁移资源提供程序注册:

    Register-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate

请等五分钟让注册完成。 可以使用以下命令来检查审批状态:

    Get-AzResourceProvider -ProviderNamespace Microsoft.ClassicInfrastructureMigrate

请确保在继续操作之前,RegistrationState 为 Registered

现在,请登录到经典模型的帐户。

    Add-AzureAccount -Environment AzureChinaCloud

使用以下命令获取可用订阅:

    Get-AzureSubscription | Sort SubscriptionName | Select SubscriptionName

设置当前会话的 Azure 订阅。 此示例将默认订阅设置为“我的 Azure 订阅”。 将示例订阅名称替换成自己的名称。

    Select-AzureSubscription -SubscriptionName "My Azure Subscription"

步骤 5:确保在当前部署或 VNET 的 Azure 区域中有足够的 Azure 资源管理器虚拟机 vCPU

可以使用以下 PowerShell 命令检查 Azure 资源管理器中目前的 vCPU 数量。 若要了解有关 vCPU 配额的详细信息,请参阅限制和 Azure 资源管理器

此示例检查 中国北部 区域的可用性。 使用自己的区域名称替换示例名称。

Get-AzVMUsage -Location "China North"

步骤 6:运行迁移 IaaS 资源的命令

Note

此处描述的所有操作都是幂等的。 如果遇到功能不受支持或配置错误以外的问题,建议重试准备、中止或提交操作。 然后,平台会尝试再次操作。

步骤 6.1:选项 1 - 迁移云服务中的虚拟机(不在虚拟网络中)

使用以下命令获取云服务列表,并选取要迁移的云服务。 如果云服务中的 VM 在虚拟网络中或者具有 Web 角色或辅助角色,该命令会返回错误消息。

    Get-AzureService | ft Servicename

获取云服务的部署名称。 在此示例中,服务名称是 My Service。 使用自己的服务名称替换示例名称。

    $serviceName = "My Service"
    $deployment = Get-AzureDeployment -ServiceName $serviceName
    $deploymentName = $deployment.DeploymentName

准备迁移云服务中的虚拟机。 可以从两个选项中进行选择。

  • 选项 1.将 VM 迁移到平台所创建的虚拟网络上

    首先,使用以下命令验证用户是否可以迁移云服务:

    $validate = Move-AzureService -Validate -ServiceName $serviceName `
        -DeploymentName $deploymentName -CreateNewVirtualNetwork
    $validate.ValidationMessages
    

    以下命令会显示任何阻止迁移的警告和错误。 如果验证成功,可继续执行“准备”步骤:

    Move-AzureService -Prepare -ServiceName $serviceName `
        -DeploymentName $deploymentName -CreateNewVirtualNetwork
    
  • 选项 2.迁移到 Resource Manager 部署模型中的现有虚拟网络

    此示例将资源组名称设置为 myResourceGroup、将虚拟网络名称设置为 myVirtualNetwork 并将子网名称设置为 mySubNet。 将该示例中的名称替换成自己的资源名称。

    $existingVnetRGName = "myResourceGroup"
    $vnetName = "myVirtualNetwork"
    $subnetName = "mySubNet"
    

    首先,请使用以下命令验证用户是否可以迁移虚拟网络:

    $validate = Move-AzureService -Validate -ServiceName $serviceName `
        -DeploymentName $deploymentName -UseExistingVirtualNetwork -VirtualNetworkResourceGroupName $existingVnetRGName -VirtualNetworkName $vnetName -SubnetName $subnetName
    $validate.ValidationMessages
    

    以下命令会显示任何阻止迁移的警告和错误。 如果验证成功,则可继续执行以下准备步骤:

        Move-AzureService -Prepare -ServiceName $serviceName -DeploymentName $deploymentName `
        -UseExistingVirtualNetwork -VirtualNetworkResourceGroupName $existingVnetRGName `
        -VirtualNetworkName $vnetName -SubnetName $subnetName
    

使用前述任一选项成功完成准备操作以后,即可查询 VM 的迁移状态。 确保 VM 处于“ Prepared ”状态。

此示例将 VM 名称设置为 myVM。 使用自己的 VM 名称替换示例名称。

    $vmName = "myVM"
    $vm = Get-AzureVM -ServiceName $serviceName -Name $vmName
    $vm.VM.MigrationState

使用 PowerShell 或 Azure 门户查看准备就绪的资源的配置。 如果尚未做好迁移准备,因此想要回到旧的状态,请使用以下命令:

    Move-AzureService -Abort -ServiceName $serviceName -DeploymentName $deploymentName

如果准备好的配置看起来没问题,则可继续进行,使用以下命令提交资源:

    Move-AzureService -Commit -ServiceName $serviceName -DeploymentName $deploymentName

步骤 6.1:选项 2 - 迁移虚拟网络中的虚拟机

若要迁移虚拟网络中的虚拟机,可迁移虚拟网络。 虚拟机随虚拟网络自动迁移。 选取要迁移的虚拟网络。

Note

通过使用虚拟机的 VHD(OS 和数据)文件创建新的使用托管磁盘的 Resource Manager 虚拟机来迁移单个经典虚拟机

Note

虚拟网络名称可能和新门户中显示的名称不同。 新的 Azure 门户显示名称为 [vnet-name],但实际的虚拟网络名称的类型是 Group [resource-group-name] [vnet-name]。 迁移之前,使用命令 Get-AzureVnetSite | Select -Property Name 查找实际的虚拟网络名称,或者在旧版 Azure 门户中查看它。

此示例将虚拟网络名称设置为 myVnet。 使用自己的虚拟网络名称替换示例名称。

    $vnetName = "myVnet"

Note

如果虚拟网络包含的 Web 角色/辅助角色或 VM 的配置不受支持,则会出现验证错误消息。

首先,请使用以下命令验证用户是否可以迁移虚拟网络:

    Move-AzureVirtualNetwork -Validate -VirtualNetworkName $vnetName

以下命令会显示任何阻止迁移的警告和错误。 如果验证成功,则可继续执行以下准备步骤:

    Move-AzureVirtualNetwork -Prepare -VirtualNetworkName $vnetName

使用 Azure PowerShell 或 Azure 门户查看已准备就绪的虚拟机的配置。 如果尚未做好迁移准备,因此想要回到旧的状态,请使用以下命令:

    Move-AzureVirtualNetwork -Abort -VirtualNetworkName $vnetName

如果准备好的配置看起来没问题,则可继续进行,使用以下命令提交资源:

    Move-AzureVirtualNetwork -Commit -VirtualNetworkName $vnetName

步骤 6.2:迁移存储帐户

完成虚拟机迁移之后,建议先执行以下先决条件检查,然后再迁移存储帐户。

Note

如果存储帐户没有关联的磁盘或 VM 数据,则可以直接跳至“验证存储帐户并开始迁移”部分。

  • 关于是否迁移了 VM 或存储帐户是否有磁盘资源的先决条件检查

    • 迁移其磁盘存储在存储帐户中的经典虚拟机

      以下命令返回存储帐户中所有经典 VM 磁盘的 RoleName 和 DiskName 属性。 RoleName 是磁盘附加到的虚拟机的名称。 如果此命令返回了磁盘,请确保先迁移这些磁盘附加到的虚拟机,再迁移存储帐户。

       $storageAccountName = 'yourStorageAccountName'
        Get-AzureDisk | where-Object {$_.MediaLink.Host.Contains($storageAccountName)} | Select-Object -ExpandProperty AttachedTo -Property `
        DiskName | Format-List -Property RoleName, DiskName
      
      
    • 删除存储帐户中存储的未附加经典 VM 磁盘

      使用以下命令查找存储帐户中未附加的经典 VM 磁盘:

          $storageAccountName = 'yourStorageAccountName'
          Get-AzureDisk | where-Object {$_.MediaLink.Host.Contains($storageAccountName)} | Where-Object -Property AttachedTo -EQ $null | Format-List -Property DiskName  
      
      

      如果上述命令返回了磁盘,请使用以下命令删除这些磁盘:

         Remove-AzureDisk -DiskName 'yourDiskName'
      
    • 删除存储帐户中存储的 VM 映像

      以下命令返回 OS 磁盘存储在存储帐户中的所有 VM 映像。

      Get-AzureVmImage | Where-Object { $_.OSDiskConfiguration.MediaLink -ne $null -and $_.OSDiskConfiguration.MediaLink.Host.Contains($storageAccountName)`
                              } | Select-Object -Property ImageName, ImageLabel
      

      以下命令返回数据磁盘存储在存储帐户中的所有 VM 映像。

      
          Get-AzureVmImage | Where-Object {$_.DataDiskConfigurations -ne $null `
                                           -and ($_.DataDiskConfigurations | Where-Object {$_.MediaLink -ne $null -and $_.MediaLink.Host.Contains($storageAccountName)}).Count -gt 0 `
                                          } | Select-Object -Property ImageName, ImageLabel
      

      使用以下命令删除上述命令返回的所有 VM 映像:

      Remove-AzureVMImage -ImageName 'yourImageName'
      
  • 验证存储帐户并启动迁移

    使用以下命令验证要迁移的每个存储帐户。 在此示例中,存储帐户名称为 myStorageAccount。 使用自己的存储帐户名称替换示例名称。

        $storageAccountName = "myStorageAccount"
        Move-AzureStorageAccount -Validate -StorageAccountName $storageAccountName
    

    下一步是准备存储帐户以便进行迁移

        $storageAccountName = "myStorageAccount"
        Move-AzureStorageAccount -Prepare -StorageAccountName $storageAccountName
    

    使用 Azure PowerShell 或 Azure 门户检查准备就绪的存储帐户的配置。 如果尚未做好迁移准备,因此想要回到旧的状态,请使用以下命令:

        Move-AzureStorageAccount -Abort -StorageAccountName $storageAccountName
    

    如果准备好的配置看起来没问题,则可继续进行,使用以下命令提交资源:

        Move-AzureStorageAccount -Commit -StorageAccountName $storageAccountName
    

后续步骤