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>]
       [-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]
       [-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>]

Description

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

第一個命令會取得復原服務保存庫，並將其儲存在 $vault 變數中。 第二個命令會取得 AzureVM 類型的備份專案，名稱為 “V2VM”，並將它儲存在$BackupItem變數中。 第三個命令會從七天前取得日期，然後將它儲存在$StartDate變數中。 第四個命令會取得目前的日期，然後將它儲存在$EndDate變數中。 第五個命令會取得依$StartDate和$EndDate篩選之特定備份專案的恢復點清單。 最後一個命令會將所有磁碟還原至目標資源群組Target_RG，然後在 DestRG 資源群組的記憶體帳戶 DestAccount 中提供 VM 組態資訊和部署範本。

範例 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 "" -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 變數中。 第二個命令會取得 AzureVM 類型的備份專案，名稱為 “V2VM”，並將它儲存在$BackupItem變數中。 第三個命令會從七天前取得日期，然後將它儲存在$StartDate變數中。 第四個命令會取得目前的日期，然後將它儲存在$EndDate變數中。 第五個命令會取得依$StartDate和$EndDate篩選之特定備份專案的恢復點清單。 第六個命令會根據 TargetVMName、TargetVNetName、TargetVNetResourceGroup、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 變數中。 第二個命令會取得 AzureVM 類型的備份專案，名稱為 “V2VM”，並將它儲存在$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變數中。 第二個命令會取得Backup專案，然後將它儲存在 $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

第一個命令會取得 RecoveryServices 保存庫，並將其儲存在$vault變數中。 第二個命令會取得Backup專案，然後將它儲存在 $BackupItem變數中。 第三個命令會從七天前取得日期，然後將它儲存在$StartDate變數中。 第四個命令會取得目前的日期，然後將它儲存在$EndDate變數中。 第五個命令會取得依$StartDate和$EndDate篩選之特定備份專案的恢復點清單。 第六個命令會將磁碟還原為非受控磁碟至其原始記憶體帳戶

範例 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 DB 還原至另一個目標 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 DB 還原至另一個記錄恢復點的目標 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 保存庫中非區域釘選 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 保存庫中的非區域釘選 VM 觸發跨區域還原。 針對 CZR，我們會傳遞 -TargetZoneNumber 參數。 針對非區域釘選 VM，只有 ZRS 保存庫才支援 CZR。 ZRS 保存庫支援區域釘選 VM CZR，且跨區域還原至已啟用 CRR 的保存庫次要區域。 我們可以針對 CZR 使用已啟用快照集或保存庫層的恢復點，但快照集恢復點應超過 4 小時。

範例 11：受控 AzureVM 的 Edge 區域還原至替代位置

$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，則還原會隱含地成為邊緣區域還原。

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DiskEncryptionSetId

用來加密已還原磁碟的 DES 識別碼。

類型:	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

如果還原的專案也存在於目的地中，請使用此選項來指出是否要覆寫。 此參數可接受的值為：

• Overwrite
• 跳過

類型:	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

用於從檔案共用還原的特定專案。 要還原於檔案共享內之專案的型別。 此參數可接受的值為：

• 檔案
• Directory

類型:	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

-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

應還原資源的目標訂用帳戶標識碼。 針對跨訂用帳戶還原使用此參數

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TargetVMName

在替代位置還原至新 VM 的情況下，應該還原數據的 VM 名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TargetVNetName

應在其中建立目標 VM 的 VNet 名稱，在替代位置還原至新的 VM 時

類型:	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-xxxx-xxxxxxxxxxxx”）。擷取不同租用戶的授權令牌的令牌

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseOriginalStorageAccount

如果要將恢復點的磁碟還原到其原始記憶體帳戶，請使用此參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-UserAssignedIdentityId

UserAssigned Identity Id 以使用 UserAssigned Identity 觸發 MSI 型還原

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseSystemAssignedIdentity

使用此參數以 SystemAssigned Identity 觸發 MSI 型還原

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-VaultId

復原服務保存庫的 ARM 識別碼。

類型:	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

相關連結

• Backup-AzRecoveryServicesBackupItem
• Get-AzRecoveryServicesBackupItem
• Get-AzRecoveryServicesBackupRecoveryPoint