通过

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

az vm disk

管理附加到 VM 的托管数据磁盘。

Azure 虚拟机使用磁盘作为存储操作系统、应用程序和数据的位置。 所有 Azure 虚拟机至少有两个磁盘：操作系统磁盘和临时磁盘。 操作系统磁盘是从映像创建的，操作系统磁盘和映像实际上是存储在 Azure 存储帐户中的虚拟硬盘（VHD）。 虚拟机还可以有一个或多个数据磁盘，这些磁盘也存储为 VHD。

Azure 托管和非托管数据磁盘的最大大小为 4095 GB（预览版中更大的磁盘除外）。 Azure 非托管磁盘的最大容量也为 4095 GB。

有关详细信息，请参阅：

命令

名称 说明 类型 Status
az vm disk attach

将托管永久性磁盘附加到 VM。

 Core GA
az vm disk detach

从 VM 分离托管磁盘。

 Core GA

az vm disk attach

编辑

将托管永久性磁盘附加到 VM。

这允许保留数据，即使 VM 由于维护或调整大小而重新预配也是如此。

az vm disk attach --vm-name
                  [--caching {None, ReadOnly, ReadWrite}]
                  [--disk-ids]
                  [--disks]
                  [--enable-write-accelerator]
                  [--lun]
                  [--name]
                  [--new]
                  [--new-names-of-rp --new-names-of-source-disk-restore-point]
                  [--new-names-of-source-snapshots-or-disks --new-names-of-sr]
                  [--resource-group]
                  [--size-gb]
                  [--sku {PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS}]
                  [--source-disk-restore-point --source-disk-rp]
                  [--source-resource --source-snapshots-or-disks]
                  [--subscription]

示例

将新的默认大小（1023 GB）托管数据磁盘附加到 VM。

az vm disk attach -g MyResourceGroup --vm-name MyVm --name disk_name --new

将托管永久性磁盘附加到 VM。 (autogenerated)

az vm disk attach --name $diskId --new --resource-group MyResourceGroup --size-gb 128 --sku Standard_LRS --vm-name MyVm

将多个托管磁盘附加到 VM。

az vm disk attach --vm-name MyVm --resource-group MyResourceGroup --sku Standard_LRS --disks diskId1 diskId2 diskId3

必需参数

--vm-name

虚拟机的名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vm=<name>。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--caching

磁盘缓存策略。

属性 值
接受的值: None, ReadOnly, ReadWrite
--disk-ids

托管磁盘的磁盘 ID（以空格分隔）。

--disks

托管磁盘的一个或多个名称或 ID（以空格分隔）。

--enable-write-accelerator

启用写入加速器。

属性 值
默认值: False
--lun

基于 0 的逻辑单元号（LUN）。 最大值取决于虚拟机大小。

--name -n

托管磁盘的名称或 ID。

属性 值
参数组: Resource Id Arguments
--new

创建新磁盘。

属性 值
默认值: False
--new-names-of-rp --new-names-of-source-disk-restore-point

从磁盘还原点创建新数据磁盘的名称。

--new-names-of-source-snapshots-or-disks --new-names-of-sr

从快照或其他磁盘创建新数据磁盘的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

属性 值
参数组: Resource Id Arguments
--size-gb -z

大小（以 GB 为单位）。 最大大小：4095 GB（某些预览磁盘可能更大）。

--sku

基础存储 SKU。

属性 值
接受的值: PremiumV2_LRS, Premium_LRS, Premium_ZRS, StandardSSD_LRS, StandardSSD_ZRS, Standard_LRS, UltraSSD_LRS
--source-disk-restore-point --source-disk-rp

从磁盘还原点创建数据磁盘。 可以使用磁盘还原点的 ID。

--source-resource --source-snapshots-or-disks

从快照或其他磁盘创建数据磁盘。 可以使用磁盘或快照的 ID。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

属性 值
参数组: Resource Id Arguments
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False

az vm disk detach

编辑

从 VM 分离托管磁盘。

az vm disk detach --resource-group
                  --vm-name
                  [--disk-ids]
                  [--force-detach]
                  [--name]

示例

从 VM 分离数据磁盘。

az vm disk detach -g MyResourceGroup --vm-name MyVm --name disk_name

强制从 VM 分离数据磁盘。

az vm disk detach -g MyResourceGroup --vm-name MyVm --name disk_name --force-detach

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--vm-name

虚拟机的名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vm=<name>。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--disk-ids

托管磁盘的磁盘 ID（以空格分隔）。

--force-detach

强制从 VM 分离托管数据磁盘。

--name -n

数据磁盘名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

属性 值
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性 值
默认值: False