Dela via

Restore-AzRecoveryServicesBackupItem

  • Referens
Modul:
Az.RecoveryServices

Återställer data och konfiguration för ett säkerhetskopieringsobjekt till den angivna återställningspunkten. De obligatoriska parametrarna varierar beroende på typ av säkerhetskopieringsobjekt. Samma kommando används för att återställa virtuella Azure-datorer, databaser som körs i Virtuella Azure-datorer och Azure-filresurser.

Syntax

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

Description

Cmdleten Restore-AzRecoveryServicesBackupItem återställer data och konfiguration för ett Azure Backup-objekt till en angiven återställningspunkt.

För säkerhetskopiering av virtuella Azure-datorer

Du kan säkerhetskopiera virtuella Azure-datorer och återställa diskar (både hanterade och ohanterade) med det här kommandot. Återställningsåtgärden återställer inte den fullständiga virtuella datorn. Om det här är en virtuell dator med hanterade diskar ska en målresursgrupp anges där de återställde diskarna sparas. När målresursgruppen har angetts, om ögonblicksbilderna finns i resursgruppen som angavs i säkerhetskopieringsprincipen, kommer återställningsåtgärden att vara omedelbar och diskarna skapas från lokala ögonblicksbilder och sparas i målresursgruppen. Det finns också ett alternativ för att återställa dem som ohanterade diskar, men detta utnyttjar de data som finns i Azure Recovery Services-valvet och blir därför mycket långsammare. Konfigurationen av den virtuella datorn och distributionsmallen som kan användas för att skapa en virtuell dator från de återställda diskarna laddas ned till det angivna lagringskontot. Om det här är en icke-hanterad virtuell disk finns ögonblicksbilderna i diskens ursprungliga lagringskonto och/eller i Recovery Services-valvet. Om användaren ger ett alternativ för att använda det ursprungliga lagringskontot för att återställa kan omedelbar återställning tillhandahållas. Annars hämtas data från Azure Recovery Services-valv och diskar skapas i det angivna lagringskontot tillsammans med konfigurationen av den virtuella datorn och distributionsmallen.

Viktig

Som standard säkerhetskopierar säkerhetskopiering av virtuella Azure-datorer alla diskar. Du kan selektivt säkerhetskopiera relevanta diskar med hjälp av parametrarna exclusionList eller InclusionList under Aktivera säkerhetskopiering. Alternativet att selektivt återställa diskar är endast tillgängligt om man selektivt har säkerhetskopierat dem.

Mer information finns i olika möjliga parameteruppsättningar och parametertext.

Not

Om -VaultId parameter används bör även -VaultLocation parameter användas.

För säkerhetskopiering av Azure-filresurser

Du kan återställa en hel filresurs eller specifika/flera filer/mappar på resursen. Du kan återställa till den ursprungliga platsen eller till en alternativ plats.

För Azure-arbetsbelastningar

Du kan återställa SQL-databaser i virtuella Azure-datorer

Exempel

Exempel 1: Återställa diskarna för en säkerhetskopierad Virtuell Azure-dator med hanterad disk från en viss återställningspunkt

$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

Det första kommandot hämtar Recovery Services-valvet och lagrar det i $vault variabel. Det andra kommandot hämtar säkerhetskopieringsobjektet av typen AzureVM, med namnet "V2VM", och lagrar det i variabeln $BackupItem. Det tredje kommandot hämtar datumet från sju dagar tidigare och lagrar det sedan i variabeln $StartDate. Det fjärde kommandot hämtar det aktuella datumet och lagrar det sedan i variabeln $EndDate. Det femte kommandot hämtar en lista över återställningspunkter för det specifika säkerhetskopieringsobjektet som filtreras efter $StartDate och $EndDate. Det senaste kommandot återställer alla diskar till målresursgruppen Target_RG och tillhandahåller sedan konfigurationsinformation för den virtuella datorn och distributionsmallen i lagringskontot DestAccount i resursgruppen DestRG.

Exempel 2: Återställa en hanterad AzureVM från en viss återställningspunkt till ursprunglig/alternativ plats

$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

Det första kommandot hämtar Recovery Services-valvet och lagrar det i $vault variabel. Det andra kommandot hämtar säkerhetskopieringsobjektet av typen AzureVM, med namnet "V2VM", och lagrar det i variabeln $BackupItem. Det tredje kommandot hämtar datumet från sju dagar tidigare och lagrar det sedan i variabeln $StartDate. Det fjärde kommandot hämtar det aktuella datumet och lagrar det sedan i variabeln $EndDate. Det femte kommandot hämtar en lista över återställningspunkter för det specifika säkerhetskopieringsobjektet som filtreras efter $StartDate och $EndDate. Det sjätte kommandot utlöser en alternativ platsåterställning (ALR) för att skapa en ny virtuell dator i Target_RG resursgrupp enligt de indata som anges av parametrarna TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName. Om en användare vill utföra en återställning på plats till den ursprungligen säkerhetskopierade virtuella datorn på den ursprungliga platsen kan det också göras med det senaste kommandot. undvika med hjälp av Parametrarna TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName för att utföra ORIGINAL Location Restore (OLR).

Exempel 3: Återställa angivna diskar för en säkerhetskopierad virtuell Azure-dator med hanterad disk från en viss återställningspunkt

$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

Det första kommandot hämtar Recovery Services-valvet och lagrar det i $vault variabel. Det andra kommandot hämtar säkerhetskopieringsobjektet av typen AzureVM, med namnet "V2VM", och lagrar det i variabeln $BackupItem. Det tredje kommandot hämtar datumet från sju dagar tidigare och lagrar det sedan i variabeln $StartDate. Det fjärde kommandot hämtar det aktuella datumet och lagrar det sedan i variabeln $EndDate. Det femte kommandot hämtar en lista över återställningspunkter för det specifika säkerhetskopieringsobjektet som filtreras efter $StartDate och $EndDate. Det sjätte kommandot lagrar listan över diskar som ska återställas i variabeln restoreDiskLUN. Det senaste kommandot återställer de angivna diskarna, för de angivna LUN:erna, till målresursgruppen Target_RG och tillhandahåller sedan konfigurationsinformation för den virtuella datorn och distributionsmallen i lagringskontot DestAccount i resursgruppen DestRG.

Exempel 4: Återställa diskar för en hanterad virtuell dator som ohanterade diskar

$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

Det första kommandot hämtar RecoveryServices-valvet och lagrar det i $vault variabel. Det andra kommandot hämtar objektet Säkerhetskopiering och lagrar det sedan i variabeln $BackupItem. Det tredje kommandot hämtar datumet från sju dagar tidigare och lagrar det sedan i variabeln $StartDate. Det fjärde kommandot hämtar det aktuella datumet och lagrar det sedan i variabeln $EndDate. Det femte kommandot hämtar en lista över återställningspunkter för det specifika säkerhetskopieringsobjektet som filtreras efter $StartDate och $EndDate. Det sjätte kommandot återställer diskarna som ohanterade diskar.

Exempel 5: Återställa en ohanterad virtuell dator som ohanterade diskar med hjälp av det ursprungliga lagringskontot

$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

Det första kommandot hämtar RecoveryServices-valvet och lagrar det i $vault variabel. Det andra kommandot hämtar objektet Säkerhetskopiering och lagrar det sedan i variabeln $BackupItem. Det tredje kommandot hämtar datumet från sju dagar tidigare och lagrar det sedan i variabeln $StartDate. Det fjärde kommandot hämtar det aktuella datumet och lagrar det sedan i variabeln $EndDate. Det femte kommandot hämtar en lista över återställningspunkter för det specifika säkerhetskopieringsobjektet som filtreras efter $StartDate och $EndDate. Det sjätte kommandot återställer diskarna som ohanterade diskar till sina ursprungliga lagringskonton

Exempel 6: Återställa flera filer för ett AzureFileShare-objekt

$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

Det första kommandot hämtar Recovery Services-valvet och lagrar det i $vault variabel. Det andra kommandot hämtar säkerhetskopieringsobjektet med namnet fileshareitem och lagrar det sedan i variabeln $BackupItem. Det tredje kommandot hämtar en lista över återställningspunkter för det specifika säkerhetskopieringsobjektet. Det fjärde kommandot anger vilka filer som ska återställas och lagras i $files variabel. Det senaste kommandot återställer de angivna filerna till den ursprungliga platsen.

Exempel 7: Återställa en SQL DB i en virtuell Azure-dator till en annan virtuell måldator för en distinkt fullständig återställningspunkt

$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

Exempel 8: Återställa en SQL DB i en virtuell Azure-dator till en annan virtuell måldator för en loggåterställningspunkt

$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

Exempel 9: Extrahera återställning för IaasVM från en arkiverad återställningspunkt

$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

Här filtrerar vi de återställningspunkter som finns på VaultArchive-nivån och utlöser en återställning med rehydreringsprioritet och återhämtningstid.

Exempel 10: Kors zonindelad återställning för icke-zonindelad virtuell dator i ett ZRS-valv

$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

Här filtrerar vi de återställningspunkter som finns på VaultStandard-nivån och utlöser en korszonbaserad återställning för icke-zonindelad virtuell dator i ett ZRS-valv. För CZR skickar vi -TargetZoneNumber parameter. För icke-zonindelade virtuella datorer stöds CZR endast för ZRS-valv. För zonanvända virtuella datorer stöds CZR för ZRS-valv och återställning mellan regioner till sekundär region för CRR-aktiverade valv. Vi kan använda återställningspunkter på ögonblicksbild eller valvnivå för CZR med en begränsning att återställningspunkten för ögonblicksbilder ska vara mer än 4 timmar gammal.

Exempel 11: Edge-zonåterställning för en hanterad AzureVM till en annan plats

$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

I det här exemplet använder vi parametern RestoreToEdgeZone för att utlösa en återställning till en ny virtuell dator i gränszonen på en annan plats. För Återställning av ursprunglig plats (OLR) blir återställning implicit en återställning av gränszonen om den virtuella källdatorn är en virtuell dator i gränszonen.

Exempel 12: Återställa en hanterad AzureVM med 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

I det här exemplet använder vi parametern DiskAccessOption för att utlösa en återställning till en ny virtuell dator med privat åtkomst aktiverad för alla diskar. DiskAccessOption-parametern kan användas för att ange diskåtkomstalternativet för måldiskar. De acceptabla värdena för den här parametern är: SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks. TargetDiskAccessId-parametern används för att ange diskåtkomst-ID för måldiskarna. Den här parametern krävs när DiskAccessOption är inställt på EnablePrivateAccessForAllDisks.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskAccessOption

Anger diskåtkomstalternativet för måldiskar

Typ:Nullable<T>[TargetDiskNetworkAccessOption]
Godkända värden:SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DiskEncryptionSetId

DES-ID:t för att kryptera de återställde diskarna.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MultipleSourceFilePath

Används för återställning av flera filer från en filresurs. Sökvägarna för de objekt som ska återställas i filresursen.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RecoveryPoint

Anger den återställningspunkt som säkerhetskopieringsobjektet ska återställas till. Om du vill hämta ett AzureRmRecoveryServicesBackupRecoveryPoint--objekt använder du cmdleten Get-AzRecoveryServicesBackupRecoveryPoint.

Typ:RecoveryPointBase
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RehydrateDuration

Varaktighet i dagar för vilka den arkiverade återställningspunkten ska vara uttorkad. Värdet kan variera från 10 till 30 dagar, standardvärdet är 15 dagar.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RehydratePriority

Rehydreringsprioritet för en arkiverad återställningspunkt när återställningen utlöses. Godtagbara värden är Standard, Hög.

Typ:String
Godkända värden:Standard, High
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResolveConflict

Om det återställda objektet också finns i målet använder du detta för att ange om det ska skrivas över eller inte. De godtagbara värdena för den här parametern är:

  • Skriv över
  • Skippa
Typ:RestoreFSResolveConflictOption
Godkända värden:Overwrite, Skip
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RestoreAsManagedDisk

Använd den här växeln om du vill ange att återställa som hanterade diskar.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RestoreAsUnmanagedDisks

Använd den här växeln för att ange att återställa som ohanterade diskar

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RestoreDiskList

Ange vilka diskar som ska återställas för den säkerhetskopierade virtuella datorn

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RestoreOnlyOSDisk

Använd den här växeln om du bara vill återställa OS-diskar för en säkerhetskopierad virtuell dator

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RestoreToEdgeZone

Växla parameter för att ange återställning av virtuell dator i gränszonen. Den här parametern kan inte användas i scenariot för prenumerationsåterställning mellan regioner och corss

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RestoreToSecondaryRegion

Använd den här växeln för att utlösa återställningen mellan regioner till den sekundära regionen.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SourceFilePath

Används för en viss objektåterställning från en filresurs. Sökvägen till det objekt som ska återställas i filresursen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SourceFileType

Används för en viss objektåterställning från en filresurs. Typen av objekt som ska återställas i filresursen. De godtagbara värdena för den här parametern är:

  • Fil
  • Katalog
Typ:Nullable<T>[SourceFileType]
Godkända värden:File, Directory
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StorageAccountName

Anger namnet på mållagringskontot i din prenumeration. Som en del av återställningsprocessen lagrar den här cmdleten diskarna och konfigurationsinformationen i det här lagringskontot.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StorageAccountResourceGroupName

Anger namnet på resursgruppen som innehåller mållagringskontot i din prenumeration. Som en del av återställningsprocessen lagrar den här cmdleten diskarna och konfigurationsinformationen i det här lagringskontot.

Typ:String
Position:2
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetDiskAccessId

Anger måldiskens åtkomst-ID när DiskAccessOption är inställt på EnablePrivateAccessForAllDisks

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetFileShareName

Den filresurs som filresursen måste återställas till.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetFolder

Mappen under vilken filresursen måste återställas till i TargetFileShareName. Om det säkerhetskopierade innehållet ska återställas till en rotmapp ger du målmappsvärdena som en tom sträng.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetResourceGroupName

Den resursgrupp som de hanterade diskarna återställs till. Gäller för säkerhetskopiering av virtuell dator med hanterade diskar

Typ:String
Position:3
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetStorageAccountName

Lagringskontot som filresursen måste återställas till.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetSubnetName

Namnet på det undernät där den virtuella måldatorn ska skapas, om en alternativ plats återställs till en ny virtuell dator

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetSubscriptionId

ID för målprenumerationen som resursen ska återställas till. Använd den här parametern för återställning mellan prenumerationer

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetVMName

Namnet på den virtuella dator som data ska återställas till, vid återställning av alternativ plats till en ny virtuell dator

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetVNetName

Namnet på det virtuella nätverk där den virtuella måldatorn ska skapas, om en alternativ plats återställs till en ny virtuell dator

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetVNetResourceGroup

Namnet på resursgruppen som innehåller det virtuella målnätverket, om en alternativ plats återställs till en ny virtuell dator

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TargetZoneNumber

Målets tillgänglighetszonnummer där de återställda diskarna fästs.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Token

Parameter för att auktorisera åtgärder som skyddas av resursskydd mellan klientorganisationer. Använd kommandot (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx"). Token för att hämta auktoriseringstoken för olika klientorganisationer

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseOriginalStorageAccount

Använd den här växeln om diskarna från återställningspunkten ska återställas till sina ursprungliga lagringskonton.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserAssignedIdentityId

UserAssigned Id för att utlösa MSI-baserad återställning med UserAssigned Identity

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UseSystemAssignedIdentity

Använd den här växeln för att utlösa MSI-baserad återställning med SystemAssigned Identity

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VaultId

ARM-ID för Recovery Services-valvet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VaultLocation

Plats för Recovery Services-valvet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WLRecoveryConfig

Återställningskonfiguration

Typ:RecoveryConfigBase
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

RecoveryPointBase

Utdata

JobBase