Restore-AzRecoveryServicesBackupItem

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>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-TargetResourceGroupName] <String>
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-DiskEncryptionSetId <String>]
       [-RestoreToSecondaryRegion]
       [-TargetZoneNumber <Int32>]
       [-RehydratePriority <String>]
       [-UseSystemAssignedIdentity]
       [-UserAssignedIdentityId <String>]
       [-TargetVMName <String>]
       [-TargetVNetName <String>]
       [-TargetVNetResourceGroup <String>]
       [-TargetSubnetName <String>]
       [-TargetSubscriptionId <String>]
       [-RestoreToEdgeZone]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       -ResolveConflict <RestoreFSResolveConflictOption>
       [-SourceFilePath <String>]
       [-SourceFileType <SourceFileType>]
       [-TargetStorageAccountName <String>]
       [-TargetFileShareName <String>]
       [-TargetFolder <String>]
       [-MultipleSourceFilePath <String[]>]
       [-RestoreToSecondaryRegion]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-RestoreAsUnmanagedDisks]
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-UseOriginalStorageAccount]
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-RestoreToSecondaryRegion]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Restore-AzRecoveryServicesBackupItem
       [-VaultLocation <String>]
       [-RecoveryPoint] <RecoveryPointBase>
       [-StorageAccountName] <String>
       [-StorageAccountResourceGroupName] <String>
       [-TargetResourceGroupName] <String>
       [-UseOriginalStorageAccount]
       [-RestoreOnlyOSDisk]
       [-RestoreDiskList <String[]>]
       [-RestoreToSecondaryRegion]
       [-RestoreAsManagedDisk]
       [-RehydratePriority <String>]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-RehydrateDuration <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

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

Descrizione

Il cmdlet Restore-AzRecoveryServicesBackupItem ripristina i dati e la configurazione per un elemento 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 il parametro -VaultId, è necessario usare anche il parametro -VaultLocation.

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 "" -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 usare TargetResourceGroupName, RestoreAsUnmanagedDisks, TargetVMName, TargetVNetName, TargetVNetResourceGroup, TargetSubnetName parametri per l'esecuzione di OLR (Original Location Restore).

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 L'UTILITÀ DI RIPRISTINO SI passa il parametro -TargetZoneNumber. 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.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

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

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

-DiskEncryptionSetId

ID DES per crittografare i dischi ripristinati.

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

-MultipleSourceFilePath

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

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

-RecoveryPoint

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

Type:	RecoveryPointBase
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-RehydratePriority

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

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

-ResolveConflict

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

• Sovrascrivi
• Ignora

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

-RestoreAsManagedDisk

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

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

-RestoreAsUnmanagedDisks

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

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

-RestoreDiskList

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

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

-RestoreOnlyOSDisk

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-RestoreToSecondaryRegion

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

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

-SourceFilePath

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 validi per questo parametro sono:

• file
• Directory

Type:	Nullable<T>[SourceFileType]
Accepted values:	File, Directory
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageAccountName

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

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

-StorageAccountResourceGroupName

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

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

-TargetFileShareName

Condivisione file in cui deve essere ripristinata la condivisione file.

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

-TargetFolder

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

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

-TargetResourceGroupName

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

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

-TargetStorageAccountName

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-TargetSubscriptionId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

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

-TargetZoneNumber

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

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

-UseOriginalStorageAccount

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

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

-UserAssignedIdentityId

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

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

-UseSystemAssignedIdentity

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

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

-VaultId

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

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

-VaultLocation

Posizione dell'insieme di credenziali di Servizi di ripristino.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet.

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

-WLRecoveryConfig

Configurazione del ripristino

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

Input

String

RecoveryPointBase

Output

JobBase

Collegamenti correlati

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