你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

从经典部署模型迁移到 Azure 资源管理器部署模型的过程中经常出现的错误

项目
09/26/2024

适用于：✔️ Linux VM ✔️ Windows VM

重要

目前，大约有 90% 的 IaaS VM 在使用 Azure 资源管理器。自 2020 年 2 月 28 日起，经典 VM 已弃用，并将于 2023 年 9 月 6 日完全停用。详细了解此弃用以及它对你的影响。

本文编录了将 IaaS 资源从 Azure 经典部署模型迁移到 Azure Resource Manager 堆栈期间的最常见错误和缓解措施。

错误列表

错误字符串	缓解措施
内部服务器错误	在某些情况下，这是重试时消失的暂时性错误。如果该错误仍然存在，请联系 Azure 支持人员，因为它需要调查平台日志。注意：支持团队跟踪事件后，请不要尝试任何自我缓解措施，因为这可能会对环境造成意想不到的后果。
托管服务 {hosted-service-name} 中的部署 {deployment-name} 不支持迁移，因为它是 PaaS 部署（Web/辅助角色）。	当部署包含 Web/辅助角色时，会发生这种情况。由于只有虚拟机才支持迁移，请从部署中删除 Web/辅助角色，并重试迁移。
模板 {template-name} 部署失败。 CorrelationId={guid}	在迁移服务的后端，我们使用 Azure Resource Manager 模板在 Azure Resource Manager 堆栈中创建资源。由于模板是幂等的，通常可以安全地重试迁移操作，以忽略此错误。如果此错误仍然存在，请联系 Azure 支持，并向其提供 CorrelationId。注意：支持团队跟踪事件后，请不要尝试任何自我缓解措施，因为这可能会对环境造成意想不到的后果。
虚拟网络 {virtual-network-name} 不存在。	如果在新的 Azure 门户中创建虚拟网络，则可能会发生这种情况。实际的虚拟网络名称遵循模式“Group * <VNET name>”
托管服务 {hosted-service-name} 中的 VM {vm-name} 包含 Azure 资源管理器不支持的扩展 {extension-name}。建议从 VM 中卸载该扩展，再继续迁移。	注意：错误消息正在进行更新，Azure 资源管理器不支持移动“迁移前需要先卸载扩展”XML 扩展，如 BGInfo 1.*。因此，无法迁移这些扩展。
HostedService {hosted-service-name} 中的 VM {vm-name} 包含当前不支持进行迁移的扩展 VMSnapshot/VMSnapshotLinux。请从 VM 中卸载该扩展，在迁移完成后再使用 Azure Resource Manager 重新添加它	这是为 Azure 备份配置虚拟机的方案。由于这是当前不支持的方案，请按照 https://aka.ms/vmbackupmigration 中的解决方法进行操作
托管服务 {hosted-service-name} 中的 VM {vm-name} 包含未从 VM 报告其状态的扩展 {extension-name}。因此，此 VM 无法迁移。确保 VM 报告该扩展状态或从 VM 中卸载该扩展，并重试迁移。托管服务 {hosted-service-name} 中的 VM {vm-name} 包含报告处理程序状态：{handler-status} 的扩展 {extension-name}。因此，该 VM 无法迁移。确保所报告的扩展处理程序状态为 {handler-status} 或从 VM 中卸载该扩展，并重试迁移。托管服务 {hosted-service-name} 中 VM {vm-name} 的 VM 代理报告的总体代理状态为“未就绪”。因此，该 VM 可能不会迁移（如果它包含可迁移的扩展）。请确保 VM 代理将总体代理状态报告为“就绪”。请参阅 https://aka.ms/classiciaasmigrationfaqs 。	Azure 来宾代理和 VM 扩展需要对 VM 存储帐户进行出站 Internet 访问以填充其状态。状态失败的常见原因包括阻止出站访问 Internet 的网络安全组如果 VNET 有本地 DNS 服务器并且 DNS 连接已丢失如果仍然看到不支持的状态，则可以卸载该扩展以跳过此检查并继续进行迁移。
托管服务 {hosted-service-name} 中的部署 {deployment-name} 不支持迁移，因为它具有多个可用性集。	目前，仅具有 1 个或更少可用性集的托管服务可以迁移。若要解决此问题，请将其他可用性集以及其中的虚拟机移到其他托管服务。
托管服务 {hosted-service-name} 中的部署 {deployment-name} 不支持迁移，因为它的 VM 不属于可用性集，即使托管服务包含一个可用性集。	这种情况的解决方法是将所有虚拟机都移到单个可用性集中，或者从托管服务的可用性集中删除所有虚拟机。
存储帐户/托管服务/虚拟网络 {virtual-network-name} 正处于迁移过程中，因此无法更改	当资源已完成“准备”迁移操作并触发了对资源进行更改的操作时，会发生此错误。由于“准备”操作完成后对管理平面进行了锁定，将阻止对资源进行任何更改。若要解锁管理平面，可以运行“提交”迁移操作以完成迁移，或者“中止”迁移操作以回退“准备”操作。
托管服务 {hosted-service-name} 不允许迁移，因为它的 VM {vm-name} 处于 RoleStateUnknown 状态。仅当 VM 处于以下状态（“正在运行”、“已停止”、“已停止已解除分配”）之一时，才允许迁移。	该 VM 可能正在进行状态转换，这通常在对托管服务进行更新操作（例如，重新启动、安装扩展等）期间发生。建议先对托管服务完成更新操作，再尝试迁移。
托管服务 {hosted-service-name} 中的部署 {deployment-name} 包含具有数据磁盘 {data-disk-name} 的 VM {vm-name}，该数据磁盘的物理 Blob 大小 {size-of-the-vhd-blob-backing-the-data-disk} 字节数不匹配 VM 数据磁盘逻辑大小 {size-of-the-data-disk-specified-in-the-vm-api} 字节数。迁移会继续，但不会指定 Azure Resource Manager VM 的数据磁盘大小。	如果已调整 VHD Blob 的大小，而没有更新 VM API 模型中的大小，将发生此错误。详细的缓解措施步骤如下所述。
在云服务 {云服务名称} 中使用媒体链接 {数据磁盘 URI} 为 VM {VM 名称} 验证数据磁盘 {数据磁盘名称} 时发生存储异常。确保该虚拟机可以访问 VHD 媒体链接	如果 VM 的磁盘已被删除或不再可访问，则可能发生此错误。确保 VM 磁盘存在。
托管服务 {cloud-service-name} 中的 VM {vm-name} 包含具有 blob 名称为 {vhd-blob-name} 的 MediaLink {vhd-uri} 的磁盘，这在 Azure 资源管理器中不受支持。	当 Blob 的名称包含“/”（这当前在计算资源提供程序中不支持）时，将出现此错误。
托管服务 {cloud-service-name} 中的部署 {deployment-name} 不允许迁移，因为不在区域范围内。请参阅 https://aka.ms/regionalscope，了解如何将该部署移至区域范围。	在 2014 年，Azure 宣布：网络资源将从群集级别范围移至区域范围。有关详细信息，请参阅 https://aka.ms/regionalscope 。当要迁移的部署尚未进行更新操作（自动将其移至区域范围）时，会发生此错误。最好的解决办法是向 VM 添加终结点，或者向 VM 添加数据磁盘，并重试迁移。请参阅如何在 Azure 中的经典虚拟机上设置终结点或将数据磁盘附加到使用经典部署模型创建的虚拟机
虚拟网络 {vnet-name} 不支持迁移，因为它具有非网关 PaaS 部署。	当具有非网关 PaaS 部署（例如连接到虚拟网络的应用程序网关或 API 管理服务）时，将发生此错误。
由于正在进行迁移，因此不允许在 VM 上执行管理操作	发生此错误是因为 VM 处于准备状态，因此处于锁定状态，无法进行任何更新/删除操作。在 VM 上使用 PS/CLI 调用 Abort，以回滚迁移并解锁 VM 以进行更新/删除操作。调用 commit 还会解锁 VM，但会将迁移提交到 ARM。

详细的缓解措施

VM 中数据磁盘的物理 Blob 字节大小与 VM 数据磁盘的逻辑字节大小不匹配。

当数据磁盘逻辑大小与实际 VHD Blob 大小不同步时，会发生这种情况。可以轻松使用以下命令验证这种问题：

验证问题

# Store the VM details in the VM object
$vm = Get-AzureVM -ServiceName $servicename -Name $vmname

# Display the data disk properties
# NOTE the data disk LogicalDiskSizeInGB below which is 11GB. Also note the MediaLink Uri of the VHD blob as we'll use this in the next step
$vm.VM.DataVirtualHardDisks


HostCaching         : None
DiskLabel           : 
DiskName            : coreosvm-coreosvm-0-201611230636240687
Lun                 : 0
LogicalDiskSizeInGB : 11
MediaLink           : https://contosostorage.blob.core.windows.net/vhds/coreosvm-dd1.vhd
SourceMediaLink     : 
IOType              : Standard
ExtensionData       : 

# Now get the properties of the blob backing the data disk above
# NOTE the size of the blob is about 15 GB which is different from LogicalDiskSizeInGB above
$blob = Get-AzStorageblob -Blob "coreosvm-dd1.vhd" -Container vhds 

$blob

ICloudBlob        : Microsoft.WindowsAzure.Storage.Blob.CloudPageBlob
BlobType          : PageBlob
Length            : 16106127872
ContentType       : application/octet-stream
LastModified      : 11/23/2016 7:16:22 AM +00:00
SnapshotTime      : 
ContinuationToken : 
Context           : Microsoft.WindowsAzure.Commands.Common.Storage.AzureStorageContext
Name              : coreosvm-dd1.vhd

缓解问题

# Convert the blob size in bytes to GB into a variable which we'll use later
$newSize = [int]($blob.Length / 1GB)

# See the calculated size in GB
$newSize

15

# Store the disk name of the data disk as we'll use this to identify the disk to be updated
$diskName = $vm.VM.DataVirtualHardDisks[0].DiskName

# Identify the LUN of the data disk to remove
$lunToRemove = $vm.VM.DataVirtualHardDisks[0].Lun

# Now remove the data disk from the VM so that the disk isn't leased by the VM and it's size can be updated
Remove-AzureDataDisk -LUN $lunToRemove -VM $vm | Update-AzureVm -Name $vmname -ServiceName $servicename

OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Update-AzureVM       213xx1-b44b-1v6n-23gg-591f2a13cd16   Succeeded  

# Verify we have the right disk that's going to be updated
Get-AzureDisk -DiskName $diskName

AffinityGroup        : 
AttachedTo           : 
IsCorrupted          : False
Label                : 
Location             : East US
DiskSizeInGB         : 11
MediaLink            : https://contosostorage.blob.core.windows.net/vhds/coreosvm-dd1.vhd
DiskName             : coreosvm-coreosvm-0-201611230636240687
SourceImageName      : 
OS                   : 
IOType               : Standard
OperationDescription : Get-AzureDisk
OperationId          : 0c56a2b7-a325-123b-7043-74c27d5a61fd
OperationStatus      : Succeeded

# Now update the disk to the new size
Update-AzureDisk -DiskName $diskName -ResizedSizeInGB $newSize -Label $diskName

OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Update-AzureDisk     cv134b65-1b6n-8908-abuo-ce9e395ac3e7 Succeeded 

# Now verify that the "DiskSizeInGB" property of the disk matches the size of the blob 
Get-AzureDisk -DiskName $diskName


AffinityGroup        : 
AttachedTo           : 
IsCorrupted          : False
Label                : coreosvm-coreosvm-0-201611230636240687
Location             : East US
DiskSizeInGB         : 15
MediaLink            : https://contosostorage.blob.core.windows.net/vhds/coreosvm-dd1.vhd
DiskName             : coreosvm-coreosvm-0-201611230636240687
SourceImageName      : 
OS                   : 
IOType               : Standard
OperationDescription : Get-AzureDisk
OperationId          : 1v53bde5-cv56-5621-9078-16b9c8a0bad2
OperationStatus      : Succeeded

# Now we'll add the disk back to the VM as a data disk. First we need to get an updated VM object
$vm = Get-AzureVM -ServiceName $servicename -Name $vmname

Add-AzureDataDisk -Import -DiskName $diskName -LUN 0 -VM $vm -HostCaching ReadWrite | Update-AzureVm -Name $vmname -ServiceName $servicename

OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Update-AzureVM       b0ad3d4c-4v68-45vb-xxc1-134fd010d0f8 Succeeded

完成迁移后，将 VM 移动到其他订阅中

完成迁移过程后，建议将 VM 移动到另一个订阅中。但是，如果在引用 Key Vault 资源的 VM 上有密钥/证书，则当前不支持移动。可按照以下说明解决此问题。

PowerShell

$vm = Get-AzVM -ResourceGroupName "MyRG" -Name "MyVM"
Remove-AzVMSecret -VM $vm
Update-AzVM -ResourceGroupName "MyRG" -VM $vm

Azure CLI

az vm update -g "myrg" -n "myvm" --set osProfile.Secrets=[]

通过