Share via


Restore-AzRecoveryServicesBackupItem

백업 항목의 데이터 및 구성을 지정된 복구 지점으로 복원합니다. 필요한 매개 변수는 백업 항목 유형에 따라 다릅니다. 동일한 명령은 Azure Virtual Machines, Azure Virtual Machines 내에서 실행되는 데이터베이스 및 Azure 파일 공유를 복원하는 데 사용됩니다.

Syntax

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>]
       [-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>]
       [-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>]
       [-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>]
       [-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>]
       [-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>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-WLRecoveryConfig] <RecoveryConfigBase>
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Restore-AzRecoveryServicesBackupItem cmdlet은 Azure Backup 항목의 데이터와 구성을 지정된 복구 지점으로 복원합니다.

Azure VM 백업의 경우

이 명령을 사용하여 Azure 가상 머신을 백업하고 디스크(관리 및 관리되지 않음)를 복원할 수 있습니다. 복원 작업은 전체 가상 머신을 복원하지 않습니다. 관리 디스크 VM인 경우 복원된 디스크가 유지되는 위치에 대상 리소스 그룹을 지정해야 합니다. 대상 리소스 그룹을 지정하면 백업 정책에 지정된 리소스 그룹에 스냅샷 있으면 복원 작업이 즉시 수행되고 디스크가 로컬 스냅샷 만들어지고 대상 리소스 그룹에 유지됩니다. 관리되지 않는 디스크로 복원하는 옵션도 있지만 Azure Recovery Services 자격 증명 모음에 있는 데이터를 활용하므로 속도가 훨씬 느려집니다. 복원된 디스크에서 VM을 만드는 데 사용할 수 있는 VM 및 배포 템플릿의 구성은 지정된 스토리지 계정에 다운로드됩니다. 관리되지 않는 디스크 VM인 경우 스냅샷 디스크의 원래 스토리지 계정 및/또는 복구 서비스 자격 증명 모음에 있습니다. 사용자가 원래 스토리지 계정을 사용하여 복원하는 옵션을 제공하는 경우 즉시 복원을 제공할 수 있습니다. 그렇지 않으면 Azure Recovery Services 자격 증명 모음에서 데이터를 가져오고 디스크는 VM 및 배포 템플릿의 구성과 함께 지정된 스토리지 계정에 만들어집니다.

Important

기본적으로 Azure VM 백업은 모든 디스크를 백업합니다. Enable-Backup 중에 exclusionList 또는 InclusionList 매개 변수를 사용하여 관련 디스크를 선택적으로 백업할 수 있습니다. 선택적으로 디스크를 복원하는 옵션은 선택적으로 백업한 경우에만 사용할 수 있습니다.

자세한 내용은 다양한 가능한 매개 변수 집합 및 매개 변수 텍스트를 참조하세요.

참고 항목

-VaultId 매개 변수를 사용하는 경우 -VaultLocation 매개 변수도 사용해야 합니다.

Azure 파일 공유 백업의 경우

전체 파일 공유 또는 공유의 특정/여러 파일/폴더를 복원할 수 있습니다. 원래 위치 또는 대체 위치로 복원할 수 있습니다.

Azure 워크로드의 경우

Azure VM 내에서 SQL DB를 복원할 수 있습니다.

예제

예제 1: 지정된 복구 지점에서 백업된 Managed Disk 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

첫 번째 명령은 Recovery Services 자격 증명 모음을 가져오고 $vault 변수에 저장합니다. 두 번째 명령은 이름이 "V2VM"인 AzureVM 형식의 Backup 항목을 가져오고 $BackupItem 변수에 저장합니다. 세 번째 명령은 7일 전의 날짜를 가져오고 $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

첫 번째 명령은 Recovery Services 자격 증명 모음을 가져오고 $vault 변수에 저장합니다. 두 번째 명령은 이름이 "V2VM"인 AzureVM 형식의 Backup 항목을 가져오고 $BackupItem 변수에 저장합니다. 세 번째 명령은 7일 전의 날짜를 가져오고 $StartDate 변수에 저장합니다. 네 번째 명령은 현재 날짜를 가져오고 $EndDate 변수에 저장합니다. 다섯 번째 명령은 $StartDate 및 $EndDate 필터링된 특정 백업 항목에 대한 복구 지점 목록을 가져옵니다. 여섯 번째 명령은 ALR(대체 위치 복원)을 트리거하여 targetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName 매개 변수로 지정된 입력에 따라 Target_RG 리소스 그룹에 새 VM을 만듭니다. 또는 사용자가 원래 위치에서 원래 백업된 VM에 대한 현재 위치 복원을 수행하려는 경우 마지막 명령을 사용하여 수행할 수 있습니다. OLR(원래 위치 복원)을 수행하기 위해 TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName 매개 변수를 사용하지 마세요.

예제 3: 지정된 복구 지점에서 백업된 Managed Disk 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

첫 번째 명령은 Recovery Services 자격 증명 모음을 가져오고 $vault 변수에 저장합니다. 두 번째 명령은 이름이 "V2VM"인 AzureVM 형식의 Backup 항목을 가져오고 $BackupItem 변수에 저장합니다. 세 번째 명령은 7일 전의 날짜를 가져오고 $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 변수에 저장합니다. 세 번째 명령은 7일 전의 날짜를 가져오고 $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 변수에 저장합니다. 세 번째 명령은 7일 전의 날짜를 가져오고 $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

첫 번째 명령은 Recovery Services 자격 증명 모음을 가져오고 $vault 변수에 저장합니다. 두 번째 명령은 파일 공유 시스템이라는 Backup 항목을 가져오고 $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 자격 증명 모음에서 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 매개 변수를 전달합니다. Non-ZonedPinned VM의 경우 CZR은 ZRS 자격 증명 모음에 대해서만 지원됩니다. ZonePinned VM의 경우 CZR은 ZRS 자격 증명 모음에 대해 지원되며 CRR 사용 자격 증명 모음의 경우 보조 지역으로 지역 간 복원이 지원됩니다. 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에 대한 복원을 트리거합니다. 원본 VM이 에지 영역 VM인 경우 OLR(원래 위치 복원)의 경우 복원은 암시적으로 에지 영역 복원이 됩니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiskEncryptionSetId

복원된 디스크를 암호화할 DES ID입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MultipleSourceFilePath

파일 공유에서 여러 파일을 복원하는 데 사용됩니다. 파일 공유 내에서 복원할 항목의 경로입니다.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecoveryPoint

백업 항목을 복원할 복구 지점을 지정합니다. AzureRmRecoveryServicesBackupRecoveryPoint 개체를 가져오려면 Get-AzRecoveryServicesBackupRecoveryPoint cmdlet을 사용합니다.

Type:RecoveryPointBase
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RehydrateDuration

보관된 복구 지점을 리하디드 상태로 유지할 기간(일)입니다. 값의 범위는 10~30일이고 기본값은 15일입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RehydratePriority

복원을 트리거하는 동안 보관된 복구 지점에 대한 리하일레이션 우선 순위입니다. 허용되는 값은 Standard, High입니다.

Type:String
Accepted values:Standard, High
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResolveConflict

복원된 항목도 대상에 있는 경우 이를 사용하여 덮어쓸지 여부를 나타냅니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 덮어쓰기
  • Skip
Type:RestoreFSResolveConflictOption
Accepted values:Overwrite, Skip
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreAsManagedDisk

이 스위치를 사용하여 관리 디스크로 복원하도록 지정할 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreAsUnmanagedDisks

이 스위치를 사용하여 관리되지 않는 디스크로 복원하도록 지정합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RestoreDiskList

백업된 VM을 복구할 디스크 지정

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreOnlyOSDisk

이 스위치를 사용하여 백업된 VM의 OS 디스크만 복원

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreToEdgeZone

에지 영역 VM 복원을 나타내도록 매개 변수를 전환합니다. 이 매개 변수는 지역 간 및 corss 구독 복원 시나리오에서 사용할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreToSecondaryRegion

이 스위치를 사용하여 보조 지역으로 지역 간 복원을 트리거합니다.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceFilePath

파일 공유에서 특정 항목 복원에 사용됩니다. 파일 공유 내에서 복원할 항목의 경로입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceFileType

파일 공유에서 특정 항목 복원에 사용됩니다. 파일 공유 내에서 복원할 항목의 형식입니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 파일
  • 디렉터리
Type:Nullable<T>[SourceFileType]
Accepted values:File, Directory
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountName

구독에 있는 대상 Storage 계정의 이름을 지정합니다. 복원 프로세스의 일부로 이 cmdlet은 디스크와 구성 정보를 이 Storage 계정에 저장합니다.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StorageAccountResourceGroupName

구독에 대상 Storage 계정이 포함된 리소스 그룹의 이름을 지정합니다. 복원 프로세스의 일부로 이 cmdlet은 디스크와 구성 정보를 이 Storage 계정에 저장합니다.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetFileShareName

파일 공유를 복원해야 하는 파일 공유입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetFolder

파일 공유를 TargetFileShareName 내에서 복원해야 하는 폴더입니다. 백업된 콘텐츠를 루트 폴더로 복원해야 하는 경우 대상 폴더 값을 빈 문자열로 제공합니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetResourceGroupName

관리 디스크가 복원되는 리소스 그룹입니다. 관리 디스크를 사용하여 VM 백업에 적용 가능

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetStorageAccountName

파일 공유를 복원해야 하는 스토리지 계정입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetSubnetName

새 VM으로 대체 위치 복원의 경우 대상 VM을 만들어야 하는 서브넷의 이름

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetSubscriptionId

리소스를 복원해야 하는 대상 구독의 ID입니다. 구독 간 복원에 이 매개 변수 사용

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetVMName

대체 위치가 새 VM으로 복원되는 경우 데이터를 복원해야 하는 VM의 이름

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetVNetName

새 VM으로 대체 위치 복원의 경우 대상 VM을 만들어야 하는 VNet의 이름

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetVNetResourceGroup

새 VM으로 대체 위치 복원의 경우 대상 VNet을 포함하는 리소스 그룹의 이름

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetZoneNumber

복원된 디스크가 고정되는 대상 가용성 영역 번호입니다.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseOriginalStorageAccount

복구 지점의 디스크를 원래 스토리지 계정으로 복원하려면 이 스위치를 사용합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserAssignedIdentityId

UserAssigned ID를 사용하여 MSI 기반 복원을 트리거하는 UserAssigned ID ID

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSystemAssignedIdentity

이 스위치를 사용하여 SystemAssigned ID를 사용하여 MSI 기반 복원 트리거

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VaultId

Recovery Services 자격 증명 모음의 ARM ID입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VaultLocation

Recovery Services 자격 증명 모음의 위치입니다.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WLRecoveryConfig

복구 구성

Type:RecoveryConfigBase
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

입력

String

RecoveryPointBase

출력

JobBase