Condividi tramite

Restore-AzRecoveryServicesBackupItem

  • Riferimento
Modulo:
Az.RecoveryServices

Ripristina i dati e la configurazione per un elemento di backup nel punto di ripristino specificato. I parametri obbligatori variano in base al tipo di elemento di backup. Lo stesso comando viene usato anche per ripristinare macchine virtuali di Azure, database in esecuzione in macchine virtuali di Azure e condivisioni file di Azure.

Sintassi

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

Descrizione

Il cmdlet Restore-AzRecoveryServicesBackupItem ripristina i dati e la configurazione per un elemento di Backup di Azure in un punto di ripristino specificato.

per il backup di macchine virtuali di Azure

È possibile eseguire il backup di macchine virtuali di Azure e ripristinare dischi (gestiti e non gestiti) usando questo comando. L'operazione di ripristino non ripristina la macchina virtuale completa. Se si tratta di una macchina virtuale del disco gestito, è necessario specificare un gruppo di risorse di destinazione in cui vengono mantenuti i dischi ripristinati. Quando si specifica il gruppo di risorse di destinazione, se gli snapshot sono presenti nel gruppo di risorse specificato nei criteri di backup, l'operazione di ripristino sarà immediata e i dischi vengono creati da snapshot locali e mantenuti nel gruppo di risorse di destinazione. È anche possibile ripristinarli come dischi non gestiti, ma questo sfrutta i dati presenti nell'insieme di credenziali dei servizi di ripristino di Azure e quindi sarà molto più lento. La configurazione della macchina virtuale e il modello di distribuzione che è possibile usare per creare una macchina virtuale dai dischi ripristinati verranno scaricati nell'account di archiviazione specificato. Se si tratta di una macchina virtuale disco non gestito, gli snapshot sono presenti nell'account di archiviazione originale del disco e/o nell'insieme di credenziali dei servizi di ripristino. Se l'utente offre un'opzione per usare l'account di archiviazione originale per il ripristino, è possibile fornire il ripristino istantaneo. In caso contrario, i dati vengono recuperati dall'insieme di credenziali di Servizi di ripristino di Azure e i dischi vengono creati nell'account di archiviazione specificato insieme alla configurazione della macchina virtuale e al modello di distribuzione.

Importante

Per impostazione predefinita, il backup di macchine virtuali di Azure esegue il backup di tutti i dischi. È possibile eseguire il backup selettivo dei dischi pertinenti usando i parametri exclusionList o InclusionList durante Enable-Backup. L'opzione per ripristinare in modo selettivo i dischi è disponibile solo se ne è stato eseguito il backup selettivo.

Per altre informazioni, vedere set di parametri e testo dei parametri diversi.

Nota

Se si usa -VaultId parametro, è necessario usare anche -VaultLocation parametro.

per il backup della condivisione file di Azure

È possibile ripristinare un'intera condivisione file o file/cartelle specifici/multipli nella condivisione. È possibile ripristinare il percorso originale o in un percorso alternativo.

per i carichi di lavoro di Azure

È possibile ripristinare database SQL all'interno di macchine virtuali di Azure

Esempio

Esempio 1: Ripristinare i dischi di una macchina virtuale di Azure su disco gestito di cui è stato eseguito il backup da un determinato punto di ripristino

$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

Il primo comando ottiene l'insieme di credenziali di Servizi di ripristino e lo archivia in $vault variabile. Il secondo comando ottiene l'elemento backup di tipo AzureVM, del nome "V2VM" e lo archivia nella variabile $BackupItem. Il terzo comando ottiene la data da sette giorni prima e quindi la archivia nella variabile $StartDate. Il quarto comando ottiene la data corrente e quindi lo archivia nella variabile $EndDate. Il quinto comando ottiene un elenco di punti di ripristino per l'elemento di backup specifico filtrato in base $StartDate e $EndDate. L'ultimo comando ripristina tutti i dischi nel gruppo di risorse di destinazione Target_RG e quindi fornisce le informazioni di configurazione della macchina virtuale e il modello di distribuzione nell'account di archiviazione DestAccount nel gruppo di risorse DestRG.

Esempio 2: Ripristinare una macchina virtuale di Azure gestita da un punto di ripristino specificato in un percorso originale/alternativo

$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

Il primo comando ottiene l'insieme di credenziali di Servizi di ripristino e lo archivia in $vault variabile. Il secondo comando ottiene l'elemento backup di tipo AzureVM, del nome "V2VM" e lo archivia nella variabile $BackupItem. Il terzo comando ottiene la data da sette giorni prima e quindi la archivia nella variabile $StartDate. Il quarto comando ottiene la data corrente e quindi lo archivia nella variabile $EndDate. Il quinto comando ottiene un elenco di punti di ripristino per l'elemento di backup specifico filtrato in base $StartDate e $EndDate. Il sesto comando attiva un ripristino percorso alternativo (ALR) per creare una nuova macchina virtuale in Target_RG gruppo di risorse in base agli input specificati dai parametri TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName. In alternativa, se un utente vuole eseguire un ripristino sul posto nella macchina virtuale di cui è stato originariamente eseguito il backup nel percorso originale, può essere eseguito con l'ultimo comando. È evitare di usando i parametri TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName per eseguire il ripristino del percorso originale (OLR).

Esempio 3: Ripristinare i dischi specificati di una macchina virtuale di Azure su disco gestito di cui è stato eseguito il backup da un determinato punto di ripristino

$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

Il primo comando ottiene l'insieme di credenziali di Servizi di ripristino e lo archivia in $vault variabile. Il secondo comando ottiene l'elemento backup di tipo AzureVM, del nome "V2VM" e lo archivia nella variabile $BackupItem. Il terzo comando ottiene la data da sette giorni prima e quindi la archivia nella variabile $StartDate. Il quarto comando ottiene la data corrente e quindi lo archivia nella variabile $EndDate. Il quinto comando ottiene un elenco di punti di ripristino per l'elemento di backup specifico filtrato in base $StartDate e $EndDate. Il sesto comando archivia l'elenco dei dischi da ripristinare nella variabile restoreDiskLUN. L'ultimo comando ripristina i dischi specificati, dei LUN specificati, nel gruppo di risorse di destinazione Target_RG e quindi fornisce le informazioni di configurazione della macchina virtuale e il modello di distribuzione nell'account di archiviazione DestAccount nel gruppo di risorse DestRG.

Esempio 4: Ripristinare i dischi di una macchina virtuale gestita come dischi non gestiti

$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

Il primo comando ottiene l'insieme di credenziali RecoveryServices e lo archivia in $vault variabile. Il secondo comando ottiene l'elemento Backup e quindi lo archivia nella variabile $BackupItem. Il terzo comando ottiene la data da sette giorni prima e quindi la archivia nella variabile $StartDate. Il quarto comando ottiene la data corrente e quindi lo archivia nella variabile $EndDate. Il quinto comando ottiene un elenco di punti di ripristino per l'elemento di backup specifico filtrato in base $StartDate e $EndDate. Il sesto comando ripristina i dischi come dischi non gestiti.

Esempio 5: Ripristinare una macchina virtuale non gestita come dischi non gestiti usando l'account di archiviazione originale

$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

Il primo comando ottiene l'insieme di credenziali RecoveryServices e lo archivia in $vault variabile. Il secondo comando ottiene l'elemento Backup e quindi lo archivia nella variabile $BackupItem. Il terzo comando ottiene la data da sette giorni prima e quindi la archivia nella variabile $StartDate. Il quarto comando ottiene la data corrente e quindi lo archivia nella variabile $EndDate. Il quinto comando ottiene un elenco di punti di ripristino per l'elemento di backup specifico filtrato in base $StartDate e $EndDate. Il sesto comando ripristina i dischi come dischi non gestiti negli account di archiviazione originali

Esempio 6: Ripristinare più file di un elemento 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

Il primo comando ottiene l'insieme di credenziali di Servizi di ripristino e lo archivia in $vault variabile. Il secondo comando ottiene l'elemento di backup denominato fileshareitem e quindi lo archivia nella variabile $BackupItem. Il terzo comando ottiene un elenco di punti di ripristino per l'elemento di backup specifico. Il quarto comando specifica i file da ripristinare e li archivia in $files variabile. L'ultimo comando ripristina i file specificati nel percorso originale.

Esempio 7: Ripristinare un database SQL all'interno di una macchina virtuale di Azure in un'altra macchina virtuale di destinazione per un punto di recupero completo distinto

$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

Esempio 8: Ripristinare un database SQL all'interno di una macchina virtuale di Azure in un'altra macchina virtuale di destinazione per un punto di ripristino del log

$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

Esempio 9: Riattivare il ripristino per IaasVM da un punto di ripristino archiviato

$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

Qui vengono filtrati i punti di ripristino presenti nel livello VaultArchive e viene attivato un ripristino con priorità di riattivazione e durata di riattivazione.

Esempio 10: Ripristino tra zone per una macchina virtuale non con zonePinned in un insieme di credenziali dell'archiviazione con ridondanza della zona

$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

Qui vengono filtrati i punti di ripristino presenti nel livello VaultStandard e viene attivato un ripristino tra zone per una macchina virtuale non ZonePinned in un insieme di credenziali dell'archiviazione con ridondanza della zona. Per LA FUNZIONE DI RIPRISTINO VIENE passato -TargetZoneNumber parametro. Per la macchina virtuale non con zonedPinned, ILR è supportato solo per gli insiemi di credenziali dell'archiviazione con ridondanza della zona. Per le macchine virtuali con zonepinte ILR è supportato per gli insiemi di credenziali dell'archiviazione con ridondanza della zona e il ripristino tra aree nell'area secondaria per gli insiemi di credenziali abilitati per CRR. È possibile usare punti di ripristino abilitati per snapshot o livelli con insiemi di credenziali per IL RIPRISTINO CON UNA limitazione che il punto di ripristino dello snapshot deve essere superiore a 4 ore prima.

Esempio 11: ripristino della zona perimetrale per una macchina virtuale di Azure gestita in una posizione alternativa

$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

In questo esempio viene usato il parametro RestoreToEdgeZone per attivare un ripristino alla nuova macchina virtuale della zona perimetrale in un percorso alternativo. Per il ripristino della posizione originale (OLR), il ripristino sarà implicitamente un ripristino della zona perimetrale se la macchina virtuale di origine è una macchina virtuale della zona perimetrale.

Esempio 12: Ripristinare una macchina virtuale di Azure gestita usando 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

In questo esempio viene usato il parametro DiskAccessOption per attivare un ripristino in una nuova macchina virtuale con accesso privato abilitato per tutti i dischi. Il parametro DiskAccessOption può essere usato per specificare l'opzione di accesso al disco per i dischi di destinazione. I valori accettabili per questo parametro sono: SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks. Il parametro TargetDiskAccessId viene usato per specificare l'ID di accesso al disco per i dischi di destinazione. Questo parametro è obbligatorio quando DiskAccessOption è impostato su EnablePrivateAccessForAllDisks.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DiskAccessOption

Specifica l'opzione di accesso al disco per i dischi di destinazione

Tipo:Nullable<T>[TargetDiskNetworkAccessOption]
Valori accettati:SameAsOnSourceDisks, EnablePrivateAccessForAllDisks, EnablePublicAccessForAllDisks
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DiskEncryptionSetId

ID DES per crittografare i dischi ripristinati.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MultipleSourceFilePath

Usato per il ripristino di più file da una condivisione file. Percorsi degli elementi da ripristinare all'interno della condivisione file.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RecoveryPoint

Specifica il punto di ripristino a cui ripristinare l'elemento di backup. Per ottenere un oggetto AzureRmRecoveryServicesBackupRecoveryPoint, usare il cmdlet Get-AzRecoveryServicesBackupRecoveryPoint.

Tipo:RecoveryPointBase
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RehydrateDuration

Durata in giorni per cui mantenere riattivato il punto di ripristino archiviato. Il valore può variare da 10 a 30 giorni, il valore predefinito è 15 giorni.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RehydratePriority

Priorità di riattivazione per un punto di ripristino archiviato durante l'attivazione del ripristino. I valori accettabili sono Standard, High.

Tipo:String
Valori accettati:Standard, High
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResolveConflict

Se l'elemento ripristinato esiste anche nella destinazione, usare questa opzione per indicare se sovrascrivere o meno. I valori accettabili per questo parametro sono:

  • Sovrascrivere
  • Saltare
Tipo:RestoreFSResolveConflictOption
Valori accettati:Overwrite, Skip
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RestoreAsManagedDisk

Usare questa opzione per specificare di eseguire il ripristino come dischi gestiti.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RestoreAsUnmanagedDisks

Usare questa opzione per specificare di eseguire il ripristino come dischi non gestiti

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RestoreDiskList

Specificare i dischi da ripristinare della macchina virtuale di cui è stato eseguito il backup

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RestoreOnlyOSDisk

Usare questa opzione per ripristinare solo i dischi del sistema operativo di una macchina virtuale di cui è stato eseguito il backup

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RestoreToEdgeZone

Cambiare il parametro per indicare il ripristino della macchina virtuale della zona perimetrale. Questo parametro non può essere usato nello scenario di ripristino della sottoscrizione tra aree e corss

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RestoreToSecondaryRegion

Usare questa opzione per attivare il ripristino tra aree nell'area secondaria.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourceFilePath

Utilizzato per un particolare ripristino di elementi da una condivisione file. Percorso dell'elemento da ripristinare all'interno della condivisione file.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourceFileType

Utilizzato per un particolare ripristino di elementi da una condivisione file. Tipo dell'elemento da ripristinare all'interno della condivisione file. I valori accettabili per questo parametro sono:

  • File
  • Directory
Tipo:Nullable<T>[SourceFileType]
Valori accettati:File, Directory
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccountName

Specifica il nome dell'account di archiviazione di destinazione nella sottoscrizione. Come parte del processo di ripristino, questo cmdlet archivia i dischi e le informazioni di configurazione in questo account di archiviazione.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccountResourceGroupName

Specifica il nome del gruppo di risorse che contiene l'account di archiviazione di destinazione nella sottoscrizione. Come parte del processo di ripristino, questo cmdlet archivia i dischi e le informazioni di configurazione in questo account di archiviazione.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetDiskAccessId

Specifica l'ID di accesso al disco di destinazione quando DiskAccessOption è impostato su EnablePrivateAccessForAllDisks

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetFileShareName

Condivisione file in cui deve essere ripristinata la condivisione file.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetFolder

Cartella in cui deve essere ripristinata la condivisione file all'interno di TargetFileShareName. Se il contenuto di cui è stato eseguito il backup deve essere ripristinato in una cartella radice, assegnare i valori della cartella di destinazione come stringa vuota.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetResourceGroupName

Gruppo di risorse in cui vengono ripristinati i dischi gestiti. Applicabile al backup della macchina virtuale con dischi gestiti

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetStorageAccountName

Account di archiviazione in cui deve essere ripristinata la condivisione file.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetSubnetName

Nome della subnet in cui deve essere creata la macchina virtuale di destinazione, nel caso di ripristino percorso alternativo in una nuova macchina virtuale

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetSubscriptionId

ID della sottoscrizione di destinazione a cui deve essere ripristinata la risorsa. Usare questo parametro per il ripristino tra sottoscrizioni

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetVMName

Nome della macchina virtuale a cui devono essere ripristinati i dati, nel caso di ripristino alternativo della posizione in una nuova macchina virtuale

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetVNetName

Nome della rete virtuale in cui deve essere creata la macchina virtuale di destinazione, nel caso di ripristino percorso alternativo in una nuova macchina virtuale

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetVNetResourceGroup

Nome del gruppo di risorse che contiene la rete virtuale di destinazione, nel caso di ripristino percorso alternativo in una nuova macchina virtuale

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TargetZoneNumber

Numero di zona di disponibilità di destinazione in cui vengono aggiunti i dischi ripristinati.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Token

Parametro per autorizzare le operazioni protette da Cross Tenant Resource Guard. Usare il comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token per recuperare il token di autorizzazione per un tenant diverso

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseOriginalStorageAccount

Usare questa opzione se i dischi dal punto di ripristino devono essere ripristinati negli account di archiviazione originali.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserAssignedIdentityId

UserAssigned Identity Id per attivare il ripristino basato su MSI con l'identità UserAssigned

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseSystemAssignedIdentity

Usare questa opzione per attivare il ripristino basato su MSI con SystemAssigned Identity

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VaultId

ID ARM dell'insieme di credenziali di Servizi di ripristino.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VaultLocation

Posizione dell'insieme di credenziali di Servizi di ripristino.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WLRecoveryConfig

Configurazione del ripristino

Tipo:RecoveryConfigBase
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

RecoveryPointBase

Output

JobBase