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

Restore-AzRecoveryServicesBackupItem

参考

模块:: Az.RecoveryServices

将备份项的数据和配置还原到指定的恢复点。所需的参数因备份项类型而异。相同的命令还用于还原 Azure 虚拟机、在 Azure 虚拟机和 Azure 文件共享中运行的数据库。

语法

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-DiskEncryptionSetId <String>]
       [-RestoreToSecondaryRegion]
       [-TargetZoneNumber <Int32>]
       [-RehydratePriority <String>]
       [-UseSystemAssignedIdentity]
       [-UserAssignedIdentityId <String>]
       [-DiskAccessOption <TargetDiskNetworkAccessOption>]
       [-TargetDiskAccessId <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       -ResolveConflict <RestoreFSResolveConflictOption>
       [-SourceFilePath <String>]
       [-SourceFileType <SourceFileType>]
       [-TargetStorageAccountName <String>]
       [-TargetFileShareName <String>]
       [-TargetFolder <String>]
       [-MultipleSourceFilePath <String[]>]
       [-RestoreToSecondaryRegion]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-RestoreAsUnmanagedDisks]
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-TargetResourceGroupName] <String>
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-DiskEncryptionSetId <String>]
       [-RestoreToSecondaryRegion]
       [-TargetZoneNumber <Int32>]
       [-RehydratePriority <String>]
       [-UseSystemAssignedIdentity]
       [-UserAssignedIdentityId <String>]
       [-TargetVMName <String>]
       [-TargetVNetName <String>]
       [-TargetVNetResourceGroup <String>]
       [-TargetSubnetName <String>]
       [-TargetSubscriptionId <String>]
       [-RestoreToEdgeZone]
       [-DiskAccessOption <TargetDiskNetworkAccessOption>]
       [-TargetDiskAccessId <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-UseOriginalStorageAccount]
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-TargetResourceGroupName] <String>
       [-UseOriginalStorageAccount]
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-RestoreToSecondaryRegion]
       [-RestoreAsManagedDisk]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-WLRecoveryConfig] <RecoveryConfigBase>
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-Token <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

说明

Restore-AzRecoveryServicesBackupItem cmdlet 将 Azure 备份项的数据和配置还原到指定的恢复点。

Azure VM 备份

可以使用此命令备份 Azure 虚拟机和还原磁盘（托管磁盘和非托管磁盘）。还原操作不会还原完整的虚拟机。如果这是托管磁盘 VM，则应在保留还原的磁盘的位置指定目标资源组。指定目标资源组时，如果快照存在于备份策略中指定的资源组中，还原操作将是即时的，并且磁盘是从本地快照创建的，并保存在目标资源组中。还可以选择将其还原为非托管磁盘，但这将利用 Azure 恢复服务保管库中存在的数据，因此速度会慢得多。 VM 的配置以及可用于从还原磁盘中创建 VM 的部署模板将下载到指定的存储帐户。如果这是非托管磁盘 VM，则快照存在于磁盘的原始存储帐户和/或恢复服务保管库中。如果用户提供了使用原始存储帐户还原的选项，则可以提供即时还原。否则，将从 Azure 恢复服务保管库提取数据，并在指定的存储帐户中创建磁盘，以及 VM 和部署模板的配置。

重要

默认情况下，Azure VM 备份备份所有磁盘。可以在 Enable-Backup 期间使用 exclusionList 或 InclusionList 参数选择性地备份相关磁盘。仅当有选择地备份磁盘时，才能选择还原磁盘。

有关详细信息，请参阅不同的可能的参数集和参数文本。

注意

如果使用 -VaultId 参数，则还应使用 -VaultLocation 参数。

Azure 文件共享备份

可以还原共享上的整个文件共享或特定/多个文件/文件夹。可以还原到原始位置或备用位置。

Azure 工作负荷

可以在 Azure VM 中还原 SQL DB

示例

示例 1：从给定恢复点还原已备份托管磁盘 Azure VM 的磁盘

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -VaultId $vault.ID -VaultLocation $vault.Location

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    V2VM            Restore         InProgress      26-Apr-16 1:14:01 PM   01-Jan-01 12:00:00 AM

示例 2：将托管 AzureVM 从给定的恢复点还原到原始/备用位置

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$AlternateLocationRestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestStorageAccount" -StorageAccountResourceGroupName "DestStorageAccRG" -TargetVMName "TagetVirtualMachineName" -TargetVNetName "Target_VNet" -TargetVNetResourceGroup "Target_VNet_RG" -TargetSubnetName "subnetName" -VaultId $vault.ID -VaultLocation $vault.Location 
$OriginalLocationRestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -StorageAccountName "DestStorageAccount" -StorageAccountResourceGroupName "DestStorageAccRG" -VaultId $vault.ID -VaultLocation $vault.Location

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    V2VM            Restore         InProgress      26-Apr-16 1:14:01 PM   01-Jan-01 12:00:00 AM

第一个命令获取恢复服务保管库并将其存储在$vault变量中。第二个命令获取名为“V2VM”的 AzureVM 类型的备份项，并将其存储在$BackupItem变量中。第三个命令从七天前获取日期，然后将其存储在$StartDate变量中。第四个命令获取当前日期，然后将其存储在$EndDate变量中。第五个命令获取按$StartDate和$EndDate筛选的特定备份项的恢复点列表。第六个命令触发备用位置还原（ALR），根据 TargetVMName、TargetVNetName、TargetVNetResourceGroup、TargetSubnetName、TargetSubnetName 指定的输入，在Target_RG资源组中创建新 VM。或者，如果用户想要在原始位置对最初备份的 VM 执行就地还原，则可以使用最后一个命令完成。请 避免使用 TargetResourceGroupName、RestoreAsUnmanagedDisks、TargetVMName、TargetVNetName、TargetVNetResourceGroup、TargetSubnetName 参数执行原始位置还原（OLR）。

示例 3：从给定恢复点还原备份托管磁盘 Azure VM 的指定磁盘

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$restoreDiskLUNs = ("0", "1")
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -RestoreDiskList $restoreDiskLUNs -VaultId $vault.ID -VaultLocation $vault.Location

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    V2VM            Restore         InProgress      26-Apr-16 1:14:01 PM   01-Jan-01 12:00:00 AM

第一个命令获取恢复服务保管库并将其存储在$vault变量中。第二个命令获取名为“V2VM”的 AzureVM 类型的备份项，并将其存储在$BackupItem变量中。第三个命令从七天前获取日期，然后将其存储在$StartDate变量中。第四个命令获取当前日期，然后将其存储在$EndDate变量中。第五个命令获取按$StartDate和$EndDate筛选的特定备份项的恢复点列表。第六个命令存储要还原到 restoreDiskLUN 变量中的磁盘列表。最后一个命令将指定 LUN 的给定磁盘还原到目标资源组Target_RG，然后在 DestRG 资源组的存储帐户 DestAccount 中提供 VM 配置信息和部署模板。

示例 4：将托管 VM 的磁盘还原为非托管磁盘

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem[0] -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -RestoreAsUnmanagedDisks -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -VaultId $vault.ID -VaultLocation $vault.Location

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    V2VM            Restore         InProgress      26-Apr-16 1:14:01 PM   01-Jan-01 12:00:00 AM

第一个命令获取 RecoveryServices 保管库并将其存储在$vault变量中。第二个命令获取备份项，然后将其存储在$BackupItem变量中。第三个命令从七天前获取日期，然后将其存储在$StartDate变量中。第四个命令获取当前日期，然后将其存储在$EndDate变量中。第五个命令获取按$StartDate和$EndDate筛选的特定备份项的恢复点列表。第六个命令将磁盘还原为非托管磁盘。

示例 5：使用原始存储帐户将非托管 VM 还原为非托管磁盘

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -Name "UnManagedVM" -VaultId $vault.ID
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem[0] -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -UseOriginalStorageAccount -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -VaultId $vault.ID -VaultLocation $vault.Location

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    V2VM            Restore         InProgress      26-Apr-16 1:14:01 PM   01-Jan-01 12:00:00 AM

示例 6：还原 AzureFileShare 项的多个文件

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureStorage -WorkloadType AzureVM -VaultId $vault.ID -Name "fileshareitem"
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -VaultId $vault.ID
$files = ("file1.txt", "file2.txt")
$RestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -MultipleSourceFilePath $files -SourceFileType File -ResolveConflict Overwrite -VaultId $vault.ID -VaultLocation $vault.Location

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    fileshareitem   Restore         InProgress      26-Apr-16 1:14:01 PM   01-Jan-01 12:00:00 AM

第一个命令获取恢复服务保管库并将其存储在$vault变量中。第二个命令获取名为 fileshareitem 的备份项，然后将其存储在$BackupItem变量中。第三个命令获取特定备份项的恢复点列表。第四个命令指定要还原并将其存储在$files变量中的文件。最后一个命令将指定的文件还原到其原始位置。

示例 7：将 Azure VM 中的 SQL 数据库还原到另一个目标 VM，以获取不同的完整恢复点

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureWorkload -WorkloadType MSSQL -VaultId $vault.ID -Name "MSSQLSERVER;model"
$StartDate = (Get-Date).AddDays(-7)
$EndDate = Get-Date
$FullRP = Get-AzRecoveryServicesBackupRecoveryPoint -Item $BackupItem -StartDate $StartDate.ToUniversalTime() -EndDate $EndDate.ToUniversalTime() -VaultId $vault.ID
$TargetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL -ItemType SQLInstance -Name "<SQLInstance Name>" -ServerName "<SQL VM name>" -VaultId $vault.ID
$AnotherInstanceWithFullConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig -RecoveryPoint $FullRP -TargetItem $TargetInstance -AlternateWorkloadRestore -VaultId $vault.ID
Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $AnotherInstanceWithLogConfig -VaultId $vault.ID

WorkloadName       Operation        Status            StartTime                 EndTime          JobID
    ------------       ---------        ------            ---------                 -------          -----
    MSSQLSERVER/m...   Restore          InProgress        3/17/2019 10:02:45 AM                      3274xg2b-e4fg-5952-89b4-8cb566gc1748

示例 8：将 Azure VM 中的 SQL 数据库还原到日志恢复点的另一个目标 VM

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureWorkload -WorkloadType MSSQL -VaultId $vault.ID -Name "MSSQLSERVER;model"
$PointInTime = Get-Date -Date "2019-03-20 01:00:00Z"
$TargetInstance = Get-AzRecoveryServicesBackupProtectableItem -WorkloadType MSSQL -ItemType SQLInstance -Name "<SQLInstance Name>" -ServerName "<SQL VM name>" -VaultId $vault.ID
$AnotherInstanceWithLogConfig = Get-AzRecoveryServicesBackupWorkloadRecoveryConfig -PointInTime $PointInTime -Item $BackupItem -AlternateWorkloadRestore -VaultId $vault.ID
Restore-AzRecoveryServicesBackupItem -WLRecoveryConfig $AnotherInstanceWithLogConfig -VaultId $vault.ID

WorkloadName     Operation      Status           StartTime                 EndTime           JobID
    ------------     ---------      ------           ---------                 -------           -----
    MSSQLSERVER/m... Restore        InProgress       3/17/2019 10:02:45 AM                       3274xg2b-e4fg-5952-89b4-8cb566gc1748

示例 9：从存档恢复点解除对 IaasVM 的还原

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate (Get-Date).AddDays(-29).ToUniversalTime() -EndDate (Get-Date).AddDays(0).ToUniversalTime() -VaultId $vault.ID -Item $item[3] -Tier VaultArchive
$restoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $rp[0] -RehydratePriority "Standard" -RehydrateDuration "13" -TargetResourceGroupName "Target_RG" -StorageAccountName "DestAccount" -StorageAccountResourceGroupName "DestRG" -RestoreDiskList $restoreDiskLUNs -VaultId $vault.ID -VaultLocation $vault.Location

在这里，我们将筛选 VaultArchive 层中存在的恢复点，并触发具有解除冻结优先级和解除冻结持续时间的还原。

示例 10：ZRS 保管库中非 ZonePinned VM 的跨区域还原

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate (Get-Date).AddDays(-29).ToUniversalTime() -EndDate (Get-Date).AddDays(0).ToUniversalTime() -VaultId $vault.ID -Item $item[3] -Tier VaultStandard
$restoreJob = Restore-AzRecoveryServicesBackupItem -VaultId $vault.ID -VaultLocation $vault.Location -RecoveryPoint $rp[0] -StorageAccountName "saName" -StorageAccountResourceGroupName $vault.ResourceGroupName -TargetResourceGroupName $vault.ResourceGroupName -TargetVMName "targetVMName" -TargetVNetName "targetVNet" -TargetVNetResourceGroup $vault.ResourceGroupName -TargetSubnetName "default" -TargetZoneNumber 2

在这里，我们将筛选 VaultStandard 层中存在的恢复点，并为 ZRS 保管库中的非 ZonePinned VM 触发跨区域还原。对于 CZR，我们传递 -TargetZoneNumber 参数。对于非区域固定 VM，仅 ZRS 保管库支持 CZR。对于已启用 CRR 的保管库，ZRS 保管库支持 ZonePinned VM CZR，跨区域还原到次要区域。我们可以对 CZR 使用启用了快照层或保管库层的恢复点，但快照恢复点应超过 4 小时。

示例 11：托管 AzureVM 的边缘区域还原到备用位置

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$item = Get-AzRecoveryServicesBackupItem -BackupManagementType AzureVM -WorkloadType AzureVM -VaultId $vault.ID
$rp = Get-AzRecoveryServicesBackupRecoveryPoint -StartDate (Get-Date).AddDays(-29).ToUniversalTime() -EndDate (Get-Date).AddDays(0).ToUniversalTime() -VaultId $vault.ID -Item $item[3]
$restoreJob = Restore-AzRecoveryServicesBackupItem -VaultId $vault.ID -VaultLocation $vault.Location -RecoveryPoint $rp[0] -StorageAccountName "saName" -StorageAccountResourceGroupName $vault.ResourceGroupName -TargetResourceGroupName $vault.ResourceGroupName -TargetVMName "targetVMName" -TargetVNetName "targetVNet" -TargetVNetResourceGroup $vault.ResourceGroupName -TargetSubnetName "default" -TargetZoneNumber 2 -RestoreToEdgeZone

在此示例中，我们使用 RestoreToEdgeZone 参数在备用位置触发到新边缘区域 VM 的还原。对于原始位置还原（OLR），如果源 VM 是边缘区域 VM，则还原将隐式成为边缘区域还原。

示例 12：使用 DiskAccessOption 还原托管 AzureVM

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$BackupItem = Get-AzRecoveryServicesBackupItem -BackupManagementType "AzureVM" -WorkloadType "AzureVM" -Name "V2VM" -VaultId $vault.ID
$RP = Get-AzRecoveryServicesBackupRecoveryPoint -VaultId $vault.ID -Item $item
$AlternateLocationRestoreJob = Restore-AzRecoveryServicesBackupItem -RecoveryPoint $RP[0] -TargetResourceGroupName "Target_RG" -StorageAccountName "DestStorageAccount" -StorageAccountResourceGroupName "DestStorageAccRG" -TargetVMName "TagetVirtualMachineName" -TargetVNetName "Target_VNet" -TargetVNetResourceGroup "Target_VNet_RG" -TargetSubnetName "subnetName" -VaultId $vault.ID -VaultLocation $vault.Location -DiskAccessOption EnablePrivateAccessForAllDisks -TargetDiskAccessId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rgName/providers/Microsoft.Compute/diskAccesses/target-diskaccess"

WorkloadName    Operation       Status          StartTime              EndTime
    ------------    ---------       ------          ---------              -------
    V2VM            Restore         InProgress      26-Jul-24 1:14:01 PM   01-Jan-01 12:00:00 AM

在此示例中，我们使用 DiskAccessOption 参数触发对所有磁盘启用专用访问的新 VM 的还原。 DiskAccessOption 参数可用于指定目标磁盘的磁盘访问选项。此参数的可接受值为：SameAsOnSourceDisks、EnablePrivateAccessForAllDisks、EnablePublicAccessForAllDisks。 TargetDiskAccessId 参数用于指定目标磁盘的磁盘访问 ID。当 DiskAccessOption 设置为 EnablePrivateAccessForAllDisks 时，此参数是必需的。

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DiskAccessOption

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

类型:	Nullable<T>[TargetDiskNetworkAccessOption]
接受的值:	SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DiskEncryptionSetId

用于加密已还原磁盘的 DES ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MultipleSourceFilePath

用于从文件共享还原多个文件。要还原到文件共享中的项的路径。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RecoveryPoint

指定要还原备份项的恢复点。若要获取 AzureRmRecoveryServicesBackupRecoveryPoint 对象，请使用 Get-AzRecoveryServicesBackupRecoveryPoint cmdlet。

类型:	RecoveryPointBase
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-RehydrateDuration

保留存档恢复点解除冻结的天数。值范围为 10 到 30 天，默认值为 15 天。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RehydratePriority

触发还原时，存档恢复点的解除冻结优先级。可接受的值为 Standard、High。

类型:	String
接受的值:	Standard, High
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResolveConflict

如果已还原的项也存在于目标中，请使用此选项指示是否覆盖。此参数的可接受值为：

改写
跳

类型:	RestoreFSResolveConflictOption
接受的值:	Overwrite, Skip
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RestoreAsManagedDisk

使用此开关可以指定还原为托管磁盘。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RestoreAsUnmanagedDisks

使用此开关可以指定还原为非托管磁盘

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RestoreDiskList

指定要恢复备份 VM 的磁盘

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RestoreOnlyOSDisk

使用此开关仅还原已备份 VM 的 OS 磁盘

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RestoreToEdgeZone

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RestoreToSecondaryRegion

使用此开关触发跨区域还原到次要区域。

类型:	SwitchParameter
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-SourceFilePath

用于从文件共享还原特定项。要在文件共享中还原的项的路径。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SourceFileType

用于从文件共享还原特定项。要还原到文件共享中的项的类型。此参数的可接受值为：

文件
目录

类型:	Nullable<T>[SourceFileType]
接受的值:	File, Directory
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StorageAccountName

指定订阅中目标存储帐户的名称。作为还原过程的一部分，此 cmdlet 将磁盘和配置信息存储在此存储帐户中。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-StorageAccountResourceGroupName

指定包含订阅中目标存储帐户的资源组的名称。作为还原过程的一部分，此 cmdlet 将磁盘和配置信息存储在此存储帐户中。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-TargetDiskAccessId

指定 DiskAccessOption 设置为 EnablePrivateAccessForAllDisks 时的目标磁盘访问 ID

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetFileShareName

文件共享必须还原到的文件共享。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetFolder

文件共享必须还原到 TargetFileShareName 中的文件夹。如果要将备份的内容还原到根文件夹，请为目标文件夹值指定为空字符串。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetResourceGroupName

将托管磁盘还原到的资源组。适用于使用托管磁盘的 VM 备份

类型:	String
Position:	3
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-TargetStorageAccountName

文件共享必须还原到的存储帐户。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetSubnetName

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetSubscriptionId

应将资源还原到的目标订阅的 ID。将此参数用于跨订阅还原

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetVMName

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetVNetName

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetVNetResourceGroup

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetZoneNumber

固定已还原磁盘的目标可用性区域编号。

类型:	Nullable<T>[Int32]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Token

用于授权受跨租户资源防护保护的操作的参数。使用命令（Get-AzAccessToken -TenantId“xxxxxxxx-xxxx-xxxx-xxxx-xxx”）。用于提取不同租户的授权令牌的令牌

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseOriginalStorageAccount

如果要将恢复点中的磁盘还原到其原始存储帐户，请使用此开关。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-UserAssignedIdentityId

使用 UserAssigned Identity 触发基于 MSI 的还原的 UserAssigned Identity

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseSystemAssignedIdentity

使用此开关通过 SystemAssigned Identity 触发基于 MSI 的还原

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VaultId

恢复服务保管库的 ARM ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-VaultLocation

恢复服务保管库的位置。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WLRecoveryConfig

恢复配置

类型:	RecoveryConfigBase
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输入

String

RecoveryPointBase

输出

JobBase

通过