az backup restore

从恢复服务保管库中的恢复点还原备份的项。

命令

名称	说明	类型	Status
az backup restore files	授予对恢复点的所有文件的访问权限。	Core	GA
az backup restore files mount-rp	下载装载恢复点文件的脚本。	Core	GA
az backup restore files unmount-rp	关闭对恢复点的访问。	Core	GA
az backup restore restore-azurefiles	将文件共享中备份的 Azure 文件还原到已注册的存储帐户中的同一文件共享或其他文件共享。	Core	GA
az backup restore restore-azurefileshare	将备份的 Azure 文件共享还原到已注册的存储帐户中的同一文件共享或其他文件共享。	Core	GA
az backup restore restore-azurewl	将恢复服务保管库中备份的 Azure 工作负荷还原到另一个已注册的容器或同一容器。	Core	GA
az backup restore restore-disks	从指定的恢复点还原支持的 VM 的磁盘。	Core	GA

az backup restore restore-azurefiles

将文件共享中备份的 Azure 文件还原到已注册的存储帐户中的同一文件共享或其他文件共享。

az backup restore restore-azurefiles --resolve-conflict {Overwrite, Skip}
                                     --restore-mode {AlternateLocation, OriginalLocation}
                                     [--container-name]
                                     [--ids]
                                     [--item-name]
                                     [--resource-group]
                                     [--rp-name]
                                     [--source-file-path]
                                     [--source-file-type {Directory, File}]
                                     [--subscription]
                                     [--target-file-share]
                                     [--target-folder]
                                     [--target-storage-account]
                                     [--tenant-id]
                                     [--vault-name]

示例

将文件共享中备份的 Azure 文件还原到已注册的存储帐户中的同一文件共享或其他文件共享。

az backup restore restore-azurefiles --resource-group MyResourceGroup --vault-name MyVault --container-name MyContainer --item-name MyItem --rp-name recoverypoint --resolve-conflict Overwrite --restore-mode OriginalLocation --source-file-type File --source-file-path Filepath1 Filepath2

必需参数

--resolve-conflict

说明是否存在与还原的数据冲突。

属性	值
接受的值:	Overwrite, Skip

--restore-mode

指定还原模式。

属性	值
接受的值:	AlternateLocation, OriginalLocation

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container-name -c

备份容器的名称。 接受 az backup container list 命令输出中的“Name”或“FriendlyName”。 如果传递了“FriendlyName”，则需要 BackupManagementType。

属性	值
Parameter group:	Resource Id Arguments

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性	值
Parameter group:	Resource Id Arguments

--item-name -i

备份项的名称。

属性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--rp-name -r

恢复点的名称。

属性	值
Parameter group:	Resource Id Arguments

--source-file-path

要作为字符串在文件共享中还原的文件的绝对路径。 此路径与“az storage file download”或“az storage file show”CLI 命令中使用的路径相同。

--source-file-type

指定要选择的源文件类型。

属性	值
接受的值:	Directory, File

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--target-file-share

要将内容还原到的目标文件共享。

--target-folder

将内容还原到的目标文件夹。 若要将内容还原到根目录，请将文件夹名称留空。

--target-storage-account

将内容还原到的目标存储帐户。

--tenant-id

如果保护保管库的资源防护存在于其他租户中，则租户的 ID。

--vault-name -v

恢复服务保管库的名称。

属性	值
Parameter group:	Resource Id Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az backup restore restore-azurefileshare

将备份的 Azure 文件共享还原到已注册的存储帐户中的同一文件共享或其他文件共享。

az backup restore restore-azurefileshare --resolve-conflict {Overwrite, Skip}
                                         --restore-mode {AlternateLocation, OriginalLocation}
                                         [--container-name]
                                         [--ids]
                                         [--item-name]
                                         [--resource-group]
                                         [--rp-name]
                                         [--subscription]
                                         [--target-file-share]
                                         [--target-folder]
                                         [--target-resource-group-name --target-rg-name]
                                         [--target-storage-account]
                                         [--tenant-id]
                                         [--vault-name]

示例

将备份的 Azure 文件共享还原到已注册的存储帐户中的同一文件共享或其他文件共享。

az backup restore restore-azurefileshare --resource-group MyResourceGroup --vault-name MyVault --container-name MyContainer --item-name MyItem --rp-name recoverypoint --resolve-conflict Overwrite --restore-mode OriginalLocation

必需参数

--resolve-conflict

说明是否存在与还原的数据冲突。

属性	值
接受的值:	Overwrite, Skip

--restore-mode

指定还原模式。

属性	值
接受的值:	AlternateLocation, OriginalLocation

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container-name -c

备份容器的名称。 接受 az backup container list 命令输出中的“Name”或“FriendlyName”。 如果传递了“FriendlyName”，则需要 BackupManagementType。

属性	值
Parameter group:	Resource Id Arguments

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性	值
Parameter group:	Resource Id Arguments

--item-name -i

备份项的名称。

属性	值
Parameter group:	Resource Id Arguments

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--rp-name -r

恢复点的名称。

属性	值
Parameter group:	Resource Id Arguments

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--target-file-share

要将内容还原到的目标文件共享。

--target-folder

将内容还原到的目标文件夹。 若要将内容还原到根目录，请将文件夹名称留空。

--target-resource-group-name --target-rg-name

要还原内容的目标存储帐户的资源组（如果与保管库资源组不同），则需要该资源组。

--target-storage-account

将内容还原到的目标存储帐户。

--tenant-id

如果保护保管库的资源防护存在于其他租户中，则租户的 ID。

--vault-name -v

恢复服务保管库的名称。

属性	值
Parameter group:	Resource Id Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False

az backup restore restore-azurewl

将恢复服务保管库中备份的 Azure 工作负荷还原到另一个已注册的容器或同一容器。

az backup restore restore-azurewl --recovery-config
                                  --resource-group
                                  --vault-name
                                  [--rehydration-duration]
                                  [--rehydration-priority {High, Standard}]
                                  [--tenant-id]
                                  [--use-secondary-region]

示例

将恢复服务保管库中备份的 Azure 工作负荷还原到另一个已注册的容器或同一容器。

az backup restore restore-azurewl --resource-group MyResourceGroup --vault-name MyVault --recovery-config MyRecoveryConfig

必需参数

--recovery-config

指定备份项的恢复配置。 可以从“backup recoveryconfig show”命令获取配置对象。

--resource-group -g

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

--vault-name -v

恢复服务保管库的名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--rehydration-duration

设置恢复点保持冻结状态的最长时间（介于 10-30 之间（含 10-30 天）。

属性	值
默认值:	15

--rehydration-priority

在解除恢复点冻结时要维护的优先级类型。

属性	值
接受的值:	High, Standard

--tenant-id

如果保护保管库的资源防护存在于其他租户中，则租户的 ID。

--use-secondary-region

使用此标志从次要区域中的恢复点还原。

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	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

az backup restore restore-disks

从指定的恢复点还原支持的 VM 的磁盘。

az backup restore restore-disks --storage-account
                                [--container-name]
                                [--disk-access-option {EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks, SameAsOnSourceDisks}]
                                [--disk-encryption-set-id]
                                [--diskslist]
                                [--ids]
                                [--item-name]
                                [--mi-system-assigned]
                                [--mi-user-assigned]
                                [--rehydration-duration]
                                [--rehydration-priority {High, Standard}]
                                [--resource-group]
                                [--restore-as-unmanaged-disks {false, true}]
                                [--restore-mode {AlternateLocation, OriginalLocation}]
                                [--restore-only-osdisk {false, true}]
                                [--restore-to-edge-zone {false, true}]
                                [--restore-to-staging-storage-account {false, true}]
                                [--rp-name]
                                [--storage-account-resource-group]
                                [--subscription]
                                [--target-disk-access-id]
                                [--target-resource-group]
                                [--target-subnet-name]
                                [--target-subscription-id]
                                [--target-vm-name]
                                [--target-vnet-name]
                                [--target-vnet-resource-group]
                                [--target-zone {1, 2, 3, NoZone}]
                                [--tenant-id]
                                [--use-secondary-region]
                                [--vault-name]

示例

从指定的恢复点还原支持的 VM 的磁盘。 (autogenerated)

az backup restore restore-disks --container-name MyContainer --item-name MyItem --resource-group MyResourceGroup --rp-name MyRp --storage-account mystorageaccount --vault-name MyVault

必需参数

--storage-account

暂存存储帐户的名称或 ID。 VM 配置将还原到此存储帐户。 有关详细信息，请参阅 --restore-to-staging-storage-account 参数的帮助。 跨区域还原可能需要 ID，其中存储帐户和保管库不在同一资源组上。 若要获取 ID，请使用此处指定的存储帐户 show 命令（https://learn.microsoft.com/en-us/azure/storage/common/storage-account-get-info?tabs=azure-cli#get-the-resource-id-for-a-storage-account）。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--container-name -c

备份容器的名称。 接受 az backup container list 命令输出中的“Name”或“FriendlyName”。 如果传递了“FriendlyName”，则需要 BackupManagementType。

属性	值
Parameter group:	Resource Id Arguments

--disk-access-option

指定目标磁盘的磁盘访问选项。

属性	值
接受的值:	EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks, SameAsOnSourceDisks

--disk-encryption-set-id

磁盘加密集 ID 用于加密还原的磁盘。 请确保访问此处指定的磁盘加密集 ID。

--diskslist

要排除或包含的磁盘列表。

--ids

一个或多个资源 ID（以空格分隔）。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

属性	值
Parameter group:	Resource Id Arguments

--item-name -i

备份项的名称。

属性	值
Parameter group:	Resource Id Arguments

--mi-system-assigned

使用此标志可以指定是否应将系统分配的托管标识用于还原作。 MI 选项不适用于还原非托管磁盘。

--mi-user-assigned

用于还原作的用户分配托管标识的 ARM ID。 如果不想使用系统分配的 MI 还原备份项，请指定此参数的值。

--rehydration-duration

设置恢复点保持冻结状态的最长时间（介于 10-30 之间（含 10-30 天）。

属性	值
默认值:	15

--rehydration-priority

在解除恢复点冻结时要维护的优先级类型。

属性	值
接受的值:	High, Standard

--resource-group -g

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

属性	值
Parameter group:	Resource Id Arguments

--restore-as-unmanaged-disks

使用此标志可以指定还原为非托管磁盘。

属性	值
接受的值:	false, true

--restore-mode

指定还原模式。

属性	值
默认值:	AlternateLocation
接受的值:	AlternateLocation, OriginalLocation

--restore-only-osdisk

使用此标志仅还原已备份 VM 的 OS 磁盘。

属性	值
接受的值:	false, true

--restore-to-edge-zone

切换参数以指示边缘区域 VM 还原。 此参数不能用于跨区域和跨订阅还原方案。

属性	值
接受的值:	false, true

--restore-to-staging-storage-account

如果希望磁盘使用 --storage-account 参数还原到过渡存储帐户，请使用此标志。 如果未指定，磁盘将还原到其原始存储帐户。 Default: false.

属性	值
接受的值:	false, true

--rp-name -r

恢复点的名称。

属性	值
Parameter group:	Resource Id Arguments

--storage-account-resource-group

包含存储帐户的资源组的名称。 如果未指定默认值，则默认值将与 --resource-group 相同。

--subscription

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

属性	值
Parameter group:	Resource Id Arguments

--target-disk-access-id

当 --disk-access-option 设置为 EnablePrivateAccessForAllDisks 时指定目标磁盘访问 ID。

--target-resource-group -t

使用此函数可以指定将保存还原磁盘的目标资源组。

--target-subnet-name

在备用位置还原新 VM 时，应在其中创建目标 VM 的子网的名称。

--target-subscription-id

应将资源还原到的订阅的 ID。

--target-vm-name

在备用位置还原到新 VM 时，应将数据还原到的 VM 的名称。

--target-vnet-name

在将备用位置还原到新 VM 时，应在其中创建目标 VM 的 VNet 的名称。

--target-vnet-resource-group

在备用位置还原到新 VM 时，包含目标 VNet 的资源组的名称。

--target-zone

主要区域目前可以有三个 Azure 可用性区域。 使用此参数在执行跨区域还原时指定目标区域编号。

属性	值
接受的值:	1, 2, 3, NoZone

--tenant-id

如果保护保管库的资源防护存在于其他租户中，则租户的 ID。

--use-secondary-region

使用此标志从次要区域中的恢复点还原。

--vault-name -v

恢复服务保管库的名称。

属性	值
Parameter group:	Resource Id Arguments

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

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

--query

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

--verbose

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

属性	值
默认值:	False