Udostępnij za pośrednictwem

Restore-AzRecoveryServicesBackupItem

  • Odwołanie
Moduł:
Az.RecoveryServices

Przywraca dane i konfigurację elementu kopii zapasowej do określonego punktu odzyskiwania. Wymagane parametry różnią się w zależności od typu elementu kopii zapasowej. To samo polecenie służy do przywracania maszyn wirtualnych platformy Azure, baz danych uruchomionych w ramach maszyn wirtualnych platformy Azure i udziałów plików platformy Azure.

Składnia

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

Opis

Polecenie cmdlet Restore-AzRecoveryServicesBackupItem przywraca dane i konfigurację elementu usługi Azure Backup do określonego punktu odzyskiwania.

na potrzeby tworzenia kopii zapasowych maszyn wirtualnych platformy Azure

Za pomocą tego polecenia można tworzyć kopie zapasowe maszyn wirtualnych platformy Azure i przywracać dyski (zarządzane i niezarządzane). Operacja przywracania nie przywraca pełnej maszyny wirtualnej. Jeśli jest to maszyna wirtualna dysku zarządzanego, należy określić docelową grupę zasobów, w której są przechowywane przywrócone dyski. Po określeniu docelowej grupy zasobów, jeśli migawki znajdują się w grupie zasobów określonej w zasadach tworzenia kopii zapasowych, operacja przywracania będzie natychmiastowa, a dyski są tworzone na podstawie migawek lokalnych i przechowywane w grupie zasobów docelowych. Istnieje również możliwość przywrócenia ich jako dysków niezarządzonych, ale spowoduje to wykorzystanie danych znajdujących się w magazynie usługi Azure Recovery Services i w związku z tym będzie znacznie wolniejsze. Konfiguracja maszyny wirtualnej i szablon wdrożenia, który może służyć do tworzenia maszyny wirtualnej z przywróconych dysków, zostanie pobrany do określonego konta magazynu. Jeśli jest to maszyna wirtualna dysku niezarządzanego, migawki znajdują się na oryginalnym koncie magazynu dysku i/lub w magazynie usługi Recovery Services. Jeśli użytkownik daje opcję użycia oryginalnego konta magazynu do przywrócenia, można podać natychmiastowe przywracanie. W przeciwnym razie dane są pobierane z magazynu usługi Azure Recovery Services, a dyski są tworzone na określonym koncie magazynu wraz z konfiguracją maszyny wirtualnej i szablonem wdrożenia.

Ważny

Domyślnie kopia zapasowa maszyny wirtualnej platformy Azure wykonuje kopię zapasową wszystkich dysków. Można selektywnie tworzyć kopie zapasowe odpowiednich dysków przy użyciu parametrów exclusionList lub InclusionList podczas włączania kopii zapasowej. Opcja selektywnego przywracania dysków jest dostępna tylko wtedy, gdy kopia zapasowa została selektywnie utworzona.

Aby uzyskać więcej informacji, zapoznaj się z różnymi możliwymi zestawami parametrów i tekstem parametrów.

Nuta

Jeśli -VaultId parametr jest używany, należy również użyć parametru -VaultLocation.

dla kopii zapasowej udziału plików platformy Azure

Można przywrócić cały udział plików lub określone/wiele plików/folderów w udziale. Możesz przywrócić do oryginalnej lokalizacji lub do lokalizacji alternatywnej.

dla obciążeń platformy Azure

Bazy danych SQL można przywrócić na maszynach wirtualnych platformy Azure

Przykłady

Przykład 1: Przywracanie dysków maszyny wirtualnej platformy Azure z dysku zarządzanego z danego punktu odzyskiwania

$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

Pierwsze polecenie pobiera magazyn usługi Recovery Services i przechowuje go w zmiennej $vault. Drugie polecenie pobiera element Kopii zapasowej typu AzureVM o nazwie "V2VM" i zapisuje go w zmiennej $BackupItem. Trzecie polecenie pobiera datę z siedmiu dni wcześniej, a następnie zapisuje ją w zmiennej $StartDate. Czwarte polecenie pobiera bieżącą datę, a następnie zapisuje ją w zmiennej $EndDate. Piąte polecenie pobiera listę punktów odzyskiwania dla określonego elementu kopii zapasowej filtrowanego przez $StartDate i $EndDate. Ostatnie polecenie przywraca wszystkie dyski do docelowej grupy zasobów Target_RG, a następnie udostępnia informacje o konfiguracji maszyny wirtualnej i szablon wdrożenia na koncie magazynu DestAccount w grupie zasobów DestRG.

Przykład 2. Przywracanie zarządzanej maszyny AzureVM z danego punktu odzyskiwania do lokalizacji oryginalnej/alternatywnej

$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

Pierwsze polecenie pobiera magazyn usługi Recovery Services i przechowuje go w zmiennej $vault. Drugie polecenie pobiera element Kopii zapasowej typu AzureVM o nazwie "V2VM" i zapisuje go w zmiennej $BackupItem. Trzecie polecenie pobiera datę z siedmiu dni wcześniej, a następnie zapisuje ją w zmiennej $StartDate. Czwarte polecenie pobiera bieżącą datę, a następnie zapisuje ją w zmiennej $EndDate. Piąte polecenie pobiera listę punktów odzyskiwania dla określonego elementu kopii zapasowej filtrowanego przez $StartDate i $EndDate. Szóste polecenie wyzwala przywracanie alternatywnej lokalizacji (ALR) w celu utworzenia nowej maszyny wirtualnej w Target_RG grupie zasobów zgodnie z danymi wejściowymi określonymi przez parametry TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName. Alternatywnie, jeśli użytkownik chce wykonać przywracanie w miejscu do pierwotnie utworzonej kopii zapasowej maszyny wirtualnej w oryginalnej lokalizacji, można to zrobić za pomocą ostatniego polecenia. Należy uniknąć przy użyciu parametrów TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName parametrów do wykonywania przywracania oryginalnej lokalizacji (OLR).

Przykład 3. Przywracanie określonych dysków maszyny wirtualnej platformy Azure z określonego punktu odzyskiwania na dysku zarządzanym

$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

Pierwsze polecenie pobiera magazyn usługi Recovery Services i przechowuje go w zmiennej $vault. Drugie polecenie pobiera element Kopii zapasowej typu AzureVM o nazwie "V2VM" i zapisuje go w zmiennej $BackupItem. Trzecie polecenie pobiera datę z siedmiu dni wcześniej, a następnie zapisuje ją w zmiennej $StartDate. Czwarte polecenie pobiera bieżącą datę, a następnie zapisuje ją w zmiennej $EndDate. Piąte polecenie pobiera listę punktów odzyskiwania dla określonego elementu kopii zapasowej filtrowanego przez $StartDate i $EndDate. Szóste polecenie przechowuje listę dysków do przywrócenia w zmiennej restoreDiskLUN. Ostatnie polecenie przywraca podane dyski z określonych jednostek LUN do docelowej grupy zasobów Target_RG, a następnie udostępnia informacje o konfiguracji maszyny wirtualnej i szablon wdrożenia na koncie magazynu DestAccount w grupie zasobów DestRG.

Przykład 4. Przywracanie dysków zarządzanej maszyny wirtualnej jako dysków niezarządzanych

$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

Pierwsze polecenie pobiera magazyn RecoveryServices i przechowuje go w zmiennej $vault. Drugie polecenie pobiera element Kopia zapasowa, a następnie przechowuje go w zmiennej $BackupItem. Trzecie polecenie pobiera datę z siedmiu dni wcześniej, a następnie zapisuje ją w zmiennej $StartDate. Czwarte polecenie pobiera bieżącą datę, a następnie zapisuje ją w zmiennej $EndDate. Piąte polecenie pobiera listę punktów odzyskiwania dla określonego elementu kopii zapasowej filtrowanego przez $StartDate i $EndDate. Szóste polecenie przywraca dyski jako dyski niezarządzane.

Przykład 5. Przywracanie niezarządzanej maszyny wirtualnej jako dysków niezarządzanych przy użyciu oryginalnego konta magazynu

$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

Pierwsze polecenie pobiera magazyn RecoveryServices i przechowuje go w zmiennej $vault. Drugie polecenie pobiera element Kopia zapasowa, a następnie przechowuje go w zmiennej $BackupItem. Trzecie polecenie pobiera datę z siedmiu dni wcześniej, a następnie zapisuje ją w zmiennej $StartDate. Czwarte polecenie pobiera bieżącą datę, a następnie zapisuje ją w zmiennej $EndDate. Piąte polecenie pobiera listę punktów odzyskiwania dla określonego elementu kopii zapasowej filtrowanego przez $StartDate i $EndDate. Szóste polecenie przywraca dyski jako dyski niezarządzane do oryginalnych kont magazynu

Przykład 6. Przywracanie wielu plików elementu 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

Pierwsze polecenie pobiera magazyn usługi Recovery Services i przechowuje go w zmiennej $vault. Drugie polecenie pobiera element kopii zapasowej o nazwie fileshareitem, a następnie zapisuje go w zmiennej $BackupItem. Trzecie polecenie pobiera listę punktów odzyskiwania dla określonego elementu kopii zapasowej. Czwarte polecenie określa, które pliki mają być przywracane i przechowywane w zmiennej $files. Ostatnie polecenie przywraca określone pliki do oryginalnej lokalizacji.

Przykład 7. Przywracanie bazy danych SQL na maszynie wirtualnej platformy Azure do innej docelowej maszyny wirtualnej dla odrębnego pełnego punktu odzyskiwania

$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

Przykład 8. Przywracanie bazy danych SQL na maszynie wirtualnej platformy Azure do innej docelowej maszyny wirtualnej dla punktu odzyskiwania dziennika

$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

Przykład 9: Przywracanie ponownie dla maszyn wirtualnych IaasVM z zarchiwizowanego punktu odzyskiwania

$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

W tym miejscu filtrujemy punkty odzyskiwania obecne w warstwie VaultArchive i wyzwalamy przywracanie z priorytetem ponownego wypełniania i czasem trwania ponownego wypełniania.

Przykład 10: Przywracanie między strefami dla maszyny wirtualnej innej niż ZonePinned w magazynie magazynu ZRS

$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

W tym miejscu przefiltrujemy punkty odzyskiwania obecne w warstwie VaultStandard i wyzwolimy przywracanie między strefami dla maszyny wirtualnej innej niż ZonePinned w magazynie ZRS. W przypadku języka CZR przekazujemy parametr -TargetZoneNumber. W przypadku maszyn wirtualnych innych niż zonedPinned funkcja CZR jest obsługiwana tylko w przypadku magazynów magazynu ZRS. W przypadku maszyn wirtualnych strefyPinned CZR jest obsługiwana w przypadku magazynów magazynu ZRS i przywracania między regionami do regionu pomocniczego dla magazynów z włączoną obsługą magazynu CRR. Możemy użyć punktów odzyskiwania z obsługą migawki lub warstwy magazynu dla czR z ograniczeniem, że punkt odzyskiwania migawki powinien mieć więcej niż 4 godziny.

Przykład 11: Przywracanie strefy krawędzi dla zarządzanej maszyny AzureVM do lokalizacji alternatywnej

$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

W tym przykładzie użyjemy parametru RestoreToEdgeZone, aby wyzwolić przywracanie do nowej maszyny wirtualnej strefy krawędzi w lokalizacji alternatywnej. W przypadku przywracania oryginalnej lokalizacji (OLR) przywracanie niejawnie będzie przywracaniem strefy brzegowej, jeśli źródłowa maszyna wirtualna jest maszyną wirtualną strefy brzegowej.

Przykład 12: Przywracanie zarządzanej maszyny azureVM przy użyciu funkcji DiskAccessOption

$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

W tym przykładzie użyjemy parametru DiskAccessOption, aby wyzwolić przywracanie do nowej maszyny wirtualnej z włączonym dostępem prywatnym dla wszystkich dysków. Parametr DiskAccessOption może służyć do określenia opcji dostępu do dysku dla dysków docelowych. Dopuszczalne wartości tego parametru to: SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks. Parametr TargetDiskAccessId służy do określania identyfikatora dostępu dysku dla dysków docelowych. Ten parametr jest wymagany, gdy parametr DiskAccessOption jest ustawiony na Wartość EnablePrivateAccessForAllDisks.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DiskAccessOption

Określa opcję dostępu do dysku dla dysków docelowych

Typ:Nullable<T>[TargetDiskNetworkAccessOption]
Dopuszczalne wartości:SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DiskEncryptionSetId

Identyfikator DES do szyfrowania przywróconych dysków.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MultipleSourceFilePath

Służy do przywracania wielu plików z udziału plików. Ścieżki elementów do przywrócenia w udziale plików.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RecoveryPoint

Określa punkt odzyskiwania, do którego ma być przywracany element kopii zapasowej. Aby uzyskać obiekt AzureRmRecoveryServicesBackupRecoveryPoint, użyj polecenia cmdlet Get-AzRecoveryServicesBackupRecoveryPoint.

Typ:RecoveryPointBase
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RehydrateDuration

Czas trwania w dniach, dla których należy zachować zarchiwizowany punkt odzyskiwania ponownie. Wartość może wahać się od 10 do 30 dni, wartość domyślna to 15 dni.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RehydratePriority

Priorytet ponownego wypełniania dla zarchiwizowanego punktu odzyskiwania podczas wyzwalania przywracania. Dopuszczalne wartości to Standardowa, Wysoka.

Typ:String
Dopuszczalne wartości:Standard, High
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResolveConflict

Jeśli przywrócony element istnieje również w miejscu docelowym, użyj go, aby wskazać, czy zastąpić, czy nie. Dopuszczalne wartości tego parametru to:

  • Zastąpić
  • Pominąć
Typ:RestoreFSResolveConflictOption
Dopuszczalne wartości:Overwrite, Skip
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestoreAsManagedDisk

Użyj tego przełącznika, aby określić, aby przywrócić jako dyski zarządzane.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestoreAsUnmanagedDisks

Użyj tego przełącznika, aby określić, aby przywrócić jako dyski niezarządzane

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestoreDiskList

Określanie dysków do odzyskania kopii zapasowej maszyny wirtualnej

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestoreOnlyOSDisk

Użyj tego przełącznika, aby przywrócić tylko dyski systemu operacyjnego maszyny wirtualnej, których kopia zapasowa została utworzona

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestoreToEdgeZone

Przełącz parametr w celu wskazania przywracania maszyny wirtualnej strefy krawędzi. Nie można użyć tego parametru w scenariuszu przywracania subskrypcji corss i między regionami

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestoreToSecondaryRegion

Użyj tego przełącznika, aby wyzwolić przywracanie między regionami do regionu pomocniczego.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SourceFilePath

Służy do przywracania określonego elementu z udziału plików. Ścieżka elementu do przywrócenia w udziale plików.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SourceFileType

Służy do przywracania określonego elementu z udziału plików. Typ elementu do przywrócenia w udziale plików. Dopuszczalne wartości tego parametru to:

  • Plik
  • Katalog
Typ:Nullable<T>[SourceFileType]
Dopuszczalne wartości:File, Directory
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StorageAccountName

Określa nazwę docelowego konta magazynu w ramach subskrypcji. W ramach procesu przywracania to polecenie cmdlet przechowuje dyski i informacje o konfiguracji na tym koncie magazynu.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-StorageAccountResourceGroupName

Określa nazwę grupy zasobów, która zawiera docelowe konto magazynu w ramach subskrypcji. W ramach procesu przywracania to polecenie cmdlet przechowuje dyski i informacje o konfiguracji na tym koncie magazynu.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetDiskAccessId

Określa identyfikator dostępu do dysku docelowego, gdy parametr DiskAccessOption ma wartość EnablePrivateAccessForAllDisks

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetFileShareName

Udział plików, do którego należy przywrócić udział plików.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetFolder

Folder, w którym należy przywrócić udział plików w folderze TargetFileShareName. Jeśli kopia zapasowa zawartości ma zostać przywrócona do folderu głównego, nadaj wartościom folderu docelowego jako pusty ciąg.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetResourceGroupName

Grupa zasobów, do której są przywracane dyski zarządzane. Dotyczy tworzenia kopii zapasowej maszyny wirtualnej z dyskami zarządzanymi

Typ:String
Position:3
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetStorageAccountName

Konto magazynu, do którego należy przywrócić udział plików.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetSubnetName

Nazwa podsieci, w której ma zostać utworzona docelowa maszyna wirtualna, w przypadku przywracania lokalizacji alternatywnej do nowej maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetSubscriptionId

Identyfikator subskrypcji docelowej, do której ma zostać przywrócony zasób. Użyj tego parametru do przywracania między subskrypcjami

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetVMName

Nazwa maszyny wirtualnej, do której mają zostać przywrócone dane, w przypadku przywracania lokalizacji alternatywnej do nowej maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetVNetName

Nazwa sieci wirtualnej, w której ma zostać utworzona docelowa maszyna wirtualna, w przypadku przywracania lokalizacji alternatywnej do nowej maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetVNetResourceGroup

Nazwa grupy zasobów, która zawiera docelową sieć wirtualną, w przypadku przywracania lokalizacji alternatywnej do nowej maszyny wirtualnej

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetZoneNumber

Docelowy numer strefy dostępności, w którym przypięte są przywrócone dyski.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Token

Parametr umożliwiający autoryzację operacji chronionych przez funkcję ochrony zasobów między dzierżawami. Użyj polecenia (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token do pobierania tokenu autoryzacji dla innej dzierżawy

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UseOriginalStorageAccount

Użyj tego przełącznika, jeśli dyski z punktu odzyskiwania mają zostać przywrócone do oryginalnych kont magazynu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserAssignedIdentityId

UserAssigned Identity Id w celu wyzwolenia przywracania opartego na tożsamości usługi zarządzanej przy użyciu elementu UserAssigned Identity

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UseSystemAssignedIdentity

Użyj tego przełącznika, aby wyzwolić przywracanie oparte na tożsamości usługi zarządzanej przy użyciu elementu SystemAssigned Identity

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VaultId

Identyfikator ARM magazynu usługi Recovery Services.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VaultLocation

Lokalizacja magazynu usługi Recovery Services.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WLRecoveryConfig

Konfiguracja odzyskiwania

Typ:RecoveryConfigBase
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

RecoveryPointBase

Dane wyjściowe

JobBase