将 VHD 上传到Azure或将托管磁盘复制到另一个区域 - Azure PowerShell

适用于：✔️ Windows VM

本文介绍如何使用 Azure PowerShell 模块将 VHD 从本地计算机上传到 Azure 托管磁盘或将托管磁盘复制到另一个区域。 上传托管磁盘的过程（也称为直接上传）使你能够将最大为 32 TiB 的 VHD 直接上传到托管磁盘。 目前，超级磁盘、高级 SSD v2、高级 SSD、标准 SSD 和标准 HDD 支持直接上传。

如果要为 Azure 中的 IaaS 虚拟机提供备份解决方案，则应使用直接上传将客户备份还原到托管磁盘。 将 VHD 从外部的源上传到Azure时，速度取决于本地带宽。 从 Azure VM 上传或复制时，带宽与标准 HDD 相同。

如果使用 Microsoft Entra ID 来控制资源访问，则可以使用它来限制 Azure 托管磁盘的上传。 有关详细信息 ，请参阅 Azure 托管磁盘的安全下载和上传 。

开始

可通过两种方式通过 Azure PowerShell 模块上传 VHD：可以使用 Add-AzVHD 命令，这将自动执行大部分过程，也可以使用 AzCopy 手动执行上传。

对于高级 SSD、标准 SSD 和标准 HDD，通常应使用 Add-AzVHD。 但是，如果要上传到超级磁盘或高级 SSD v2，或者需要上传大于 50 GiB 的 VHD，则必须使用 AzCopy 手动上传 VHD 或 VHDX。 使用 AzCopy 可更快速上传 50 GiB 及以上的 VHD，而 Add-AzVhd 目前不支持上传到 Ultra Disk 或 Premium SSD v2。

有关如何将托管磁盘从一个区域复制到另一个区域的指导，请参阅复制托管磁盘。

使用 Add-AzVHD

先决条件

• 安装 Azure PowerShell 模块。
• 已准备好用于 Azure 的 VHD，存储于本地。
  • 在 Windows：无需将 VHD 转换为 VHDx，无需将其转换为固定大小，也无需重设大小以包含 512 字节偏移量。 Add-AZVHD 替你执行这些功能。
    • 必须启用 Hyper-V，Add-AzVHD 才能执行这些功能。
  • 在 Linux 上：必须手动执行这些操作。 有关详细信息，请参阅调整 VHD 大小。

上传 VHD

（可选）授予对磁盘的访问权限

如果 Microsoft Entra ID 用于在订阅或帐户级别上施加上传限制，那么只有当有适当的 RBAC 角色或必要权限的用户尝试执行时，Add-AzVHD 才会成功。 需要分配 RBAC 权限以授予磁盘访问权限，并生成一个可写入的 SAS。

New-AzRoleAssignment -SignInName <emailOrUserprincipalname> `
-RoleDefinitionName "Data Operator for Managed Disks" `
-Scope /subscriptions/<subscriptionId>

使用 Add-AzVHD

以下示例使用 Add-AzVHD 将 VHD 从本地计算机上传到新的 Azure 托管磁盘。 将 <your-filepath-here>、<your-resource-group-name>、<desired-region> 和 <desired-managed-disk-name> 替换为你的参数：

# Required parameters
$path = <your-filepath-here>.vhd
$resourceGroup = <your-resource-group-name>
$location = <desired-region>
$name = <desired-managed-disk-name>

# Optional parameters
# $Zone = <desired-zone>
# $sku=<desired-SKU>
# -DataAccessAuthMode 'AzureActiveDirectory'
# -DiskHyperVGeneration = V1 or V2. This applies only to OS disks.

# To use $Zone or #sku, add -Zone or -DiskSKU parameters to the command
Add-AzVhd -LocalFilePath $path -ResourceGroupName $resourceGroup -Location $location -DiskName $name

手动上传

先决条件

• 下载最新版本的 AzCopy v10。
• 安装 Azure PowerShell 模块。
• 已经为 Azure 准备好的固定大小 VHD，本地储存。

若要将 VHD 上传到Azure，需要创建为此上传过程配置的空托管磁盘。 在创建磁盘之前，应了解有关这些磁盘的一些附加信息。

这种托管磁盘有两种独特的状态：

• ReadyToUpload，这意味着磁盘已准备好接收上传，但尚未生成安全access签名（SAS）。
• ActiveUpload，表示磁盘已做好上传准备，并且已生成 SAS。

创建空托管磁盘

在创建用于上传的空标准 HDD 之前，需要要上传的 VHD 的文件大小（以字节为单位）。 示例代码将为你获取该信息，不过，如果你想自己实现，可以使用：$vhdSizeBytes = (Get-Item "<fullFilePathHere>").length。 指定 -UploadSizeInBytes 参数时将使用此值。

现在，在本地 shell 上，通过在 -CreateOption 参数中指定 Upload 设置以及 New-AzDiskConfig cmdlet 中的 -UploadSizeInBytes 参数来创建空的标准 HDD 进行上传。 然后调用 New-AzDisk 来创建磁盘。

替换 <yourdiskname>、<yourresourcegroupname> 和 <yourregion>，然后运行以下命令：

$vhdSizeBytes = (Get-Item "<fullFilePathHere>").length

## For Ultra Disks or Premium SSD v2, add -LogicalSectorSize and specify either 4096 or 512, depending on if you're using a VHDX or a VHD

$diskconfig = New-AzDiskConfig -SkuName 'Standard_LRS' -OsType 'Windows' -UploadSizeInBytes $vhdSizeBytes -Location '<yourregion>' -CreateOption 'Upload'

New-AzDisk -ResourceGroupName '<yourresourcegroupname>' -DiskName '<yourdiskname>' -Disk $diskconfig

如果要上传其他磁盘类型，请将 Standard_LRS 替换为 Premium_LRS、Premium_ZRS、StandardSSD_ZRS、StandardSSD_LRS 或 UltraSSD_LRS。

生成可写 SAS

现在，你已创建了一个针对上传过程配置的空托管磁盘，可以将 VHD 上传到其中了。 若要将 VHD 上传到磁盘，需要一个可写的 SAS，以便将此磁盘作为上传目标引用。

如果存储帐户的托管磁盘或快照的 SAS 的过期时间超过 60 天，请取消对其的访问权限，并生成一个新的 SAS，请求访问权限为 60 天（5,184,000 秒）或更少。 通过使用有效期更短的 SAS 来提高整体安全性。 请在 2025 年 2 月 15 日之前进行这些更改，以防止服务中断。 以下链接可用于查找、撤销和请求新的 SAS。

• 若要检查磁盘是否具有活动的 SAS， 可以使用 REST API、Azure CLI 或 Azure PowerShell 模块，并检查 DiskState 属性。
• 若要撤销 SAS，可以使用 REST API、Azure CLI 或 Azure PowerShell 模块。
• 若要创建 SAS，可以使用 REST API、Azure CLI 或 Azure PowerShell 模块，并将access持续时间设置为 5,184,000 秒或更少。

若要生成空托管磁盘的可写 SAS，请替换 <yourdiskname> 和 <yourresourcegroupname>，然后使用以下命令：

$diskSas = Grant-AzDiskAccess -ResourceGroupName '<yourresourcegroupname>' -DiskName '<yourdiskname>' -DurationInSecond 86400 -Access 'Write'

$disk = Get-AzDisk -ResourceGroupName '<yourresourcegroupname>' -DiskName '<yourdiskname>'

上传 VHD 或 VHDX

生成了空托管磁盘的 SAS 后，您可以使用该 SAS 将您的托管磁盘设置为上传命令的目标。

使用 AzCopy v10，通过指定生成的 SAS URI 将本地 VHD 或 VHDX 文件上传到托管磁盘。

此上传的吞吐量与等效 的标准 HDD 相同。 例如，如果大小等于 S4，则最高吞吐量为 60 MiB/秒。 但是，如果大小等于 S70，则最高吞吐量为 500 MiB/秒。

AzCopy.exe copy "c:\somewhere\mydisk.vhd" $diskSas.AccessSAS --blob-type PageBlob

上传完成后，如果你不再需要将更多数据写入磁盘，请吊销 SAS。 吊销 SAS 会更改托管磁盘的状态，使你可以将磁盘附加到 VM。

替换 <yourdiskname> 和 <yourresourcegroupname>，然后运行以下命令：

Revoke-AzDiskAccess -ResourceGroupName '<yourresourcegroupname>' -DiskName '<yourdiskname>'

复制托管磁盘

直接上传还能简化复制托管磁盘的过程。 可以在同一区域中进行复制，或者将托管磁盘复制到其他区域。

以下脚本可自动完成此操作，此过程类似于前面所述的步骤，但由于处理的是现有磁盘，因此存在一些差异。

请将 <sourceResourceGroupHere>、<sourceDiskNameHere>、<targetDiskNameHere>、<targetResourceGroupHere>、<yourOSTypeHere> 和 <yourTargetLocationHere>（例如，位置值为 chinanorth2）替换为自己的值，然后运行以下脚本来复制托管磁盘。

$sourceRG = <sourceResourceGroupHere>
$sourceDiskName = <sourceDiskNameHere>
$targetDiskName = <targetDiskNameHere>
$targetRG = <targetResourceGroupHere>
$targetLocate = <yourTargetLocationHere>
$targetVmGeneration = "V1" # either V1 or V2
#Expected value for OS is either "Windows" or "Linux"
$targetOS = <yourOSTypeHere>

$sourceDisk = Get-AzDisk -ResourceGroupName $sourceRG -DiskName $sourceDiskName

# Adding the sizeInBytes with the 512 offset, and the -Upload flag
$targetDiskconfig = New-AzDiskConfig -SkuName 'Standard_LRS' -osType $targetOS -UploadSizeInBytes $($sourceDisk.DiskSizeBytes+512) -Location $targetLocate -CreateOption 'Upload' -HyperVGeneration $targetVmGeneration

$targetDisk = New-AzDisk -ResourceGroupName $targetRG -DiskName $targetDiskName -Disk $targetDiskconfig

$sourceDiskSas = Grant-AzDiskAccess -ResourceGroupName $sourceRG -DiskName $sourceDiskName -DurationInSecond 86400 -Access 'Read'

$targetDiskSas = Grant-AzDiskAccess -ResourceGroupName $targetRG -DiskName $targetDiskName -DurationInSecond 86400 -Access 'Write'

azcopy copy $sourceDiskSas.AccessSAS $targetDiskSas.AccessSAS --blob-type PageBlob

Revoke-AzDiskAccess -ResourceGroupName $sourceRG -DiskName $sourceDiskName

Revoke-AzDiskAccess -ResourceGroupName $targetRG -DiskName $targetDiskName 

后续步骤

成功将 VHD 上传到托管磁盘后，即可将磁盘附加到 VM 并开始使用它。

若要了解如何将数据磁盘附加到 VM，请参阅有关此主题的文章：使用 PowerShell 将数据磁盘附加到 Windows VM。 若要将磁盘用作 OS 磁盘，请参阅从专用磁盘创建 Windows VM。

如果还有其他问题，请参阅常见问题解答中的上传托管磁盘部分。