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.
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.
Annotazioni
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
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
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
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
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
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
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
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
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
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.
Esempio 11: Ripristino tra zone per la macchina virtuale non con zonePinned in NoZone
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 13: Ripristinare una macchina virtuale di Azure gestita con DiskAccessOption
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-CVMOsDiskEncryptionSetId
Specificare l'ID del set di crittografia dischi da usare per la crittografia del disco del sistema operativo durante il ripristino di una macchina virtuale riservata. Questo è applicabile solo per le macchine virtuali riservate con dischi gestiti. Assicurarsi che il set di crittografia dischi abbia accesso all'insieme di credenziali delle chiavi.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-RecoveryPoint
Specifica il punto di ripristino a cui ripristinare l'elemento di backup.
Per ottenere un oggetto AzureRmRecoveryServicesBackupRecoveryPoint, usare il cmdlet Get-AzRecoveryServicesBackupRecoveryPoint.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureFileShareParameterSet
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreManagedAsUnmanaged
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureManagedVMCreateNewParameterSet
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMUnManagedDiskParameterSet
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreUnmanagedAsManaged
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
True
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreManagedAsUnmanaged
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureManagedVMCreateNewParameterSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMUnManagedDiskParameterSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreUnmanagedAsManaged
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureWorkloadParameterSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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:
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreManagedAsUnmanaged
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureManagedVMCreateNewParameterSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMUnManagedDiskParameterSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreUnmanagedAsManaged
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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 tra più aree e tra sottoscrizioni
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-SecureToken
Parametro per autorizzare le operazioni protette da Cross Tenant Resource Guard. Usare il comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx"). Token per recuperare il token di autorizzazione per un tenant diverso
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-SourceFilePath
Utilizzato per un particolare ripristino di elementi da una condivisione file. Percorso dell'elemento da ripristinare all'interno della condivisione file.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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:
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreManagedAsUnmanaged
Posizione:
1
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureManagedVMCreateNewParameterSet
Posizione:
1
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMUnManagedDiskParameterSet
Posizione:
1
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureVMRestoreUnmanagedAsManaged
Posizione:
1
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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.
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
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
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AzureManagedVMCreateNewParameterSet
Posizione:
Named
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Token
Parametro per autorizzare le operazioni protette da Cross Tenant Resource Guard. Usare il comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx"). Token per recuperare il token di autorizzazione per un tenant diverso
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.