Condividi tramite

Ripristinare condivisioni file di Azure con l'interfaccia della riga di comando di Azure

  • Articolo

L'interfaccia della riga di comando di Azure offre un'esperienza di tipo riga di comando per la gestione delle risorse di Azure. È un ottimo strumento per la creazione di automazione personalizzata per l'uso delle risorse di Azure. Questo articolo illustra come ripristinare un'intera condivisione file o file specifici da un punto di ripristino creato da Backup di Azure usando l'interfaccia della riga di comando di Azure. È anche possibile eseguire questa procedura con Azure PowerShell o nel portale di Azure.

Al termine di questo articolo si apprenderà come eseguire le operazioni seguenti con l'interfaccia della riga di comando di Azure:

  • Visualizzare i punti di ripristino per una condivisione file di Azure di cui è stato eseguito il backup.
  • Ripristinare una condivisione file di Azure completa.
  • Ripristinare singoli file o cartelle.

Nota

Backup di Azure ora supporta il ripristino di più file o cartelle nell'originale o in un percorso alternativo tramite l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere la sezione Ripristinare più file o cartelle in un percorso originale o alternativo di questo documento.

Prerequisiti

Questo articolo presuppone che sia già disponibile una condivisione file di Azure di cui è stato eseguito il backup da Backup di Azure. Se non è disponibile, vedere Eseguire il backup di condivisioni file di Azure con l'interfaccia della riga di comando per configurare il backup per la condivisione file. Per questo articolo, sono necessarie le risorse seguenti:

Condivisione file Account di archiviazione Paese Dettagli
azurefiles afsaccount EastUS Backup dell'origine originale con Backup di Azure
azurefiles1 afaccount1 EastUS Origine di destinazione usata per il ripristino alternativo della posizione

È possibile usare una struttura simile per le condivisioni file per provare i diversi tipi di ripristini illustrati in questo articolo.

Preparare l'ambiente per l'interfaccia della riga di comando di Azure

  • Questa esercitazione richiede la versione 2.0.18 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.

Recuperare i punti di ripristino per la condivisione file di Azure

Usare il cmdlet az backup recoverypoint list per elencare tutti i punti di ripristino per la condivisione file di cui è stato eseguito il backup.

L'esempio seguente recupera l'elenco dei punti di ripristino per la condivisione file azurefiles nell'account di archiviazione afsaccount .

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table

È anche possibile eseguire il cmdlet precedente usando il nome descrittivo per il contenitore e l'elemento fornendo i due parametri aggiuntivi seguenti:

  • --backup-management-type: azurestorage
  • --workload-type: azurefileshare
az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table

Il set di risultati è un elenco di punti di ripristino con dettagli di tempo e coerenza per ogni punto di ripristino.

Name                Time                        Consistency
------------------  -------------------------   --------------------
932887541532871865  2020-01-05T07:08:23+00:00   FileSystemConsistent
932885927361238054  2020-01-05T07:08:10+00:00   FileSystemConsistent
932879614553967772  2020-01-04T21:33:04+00:00   FileSystemConsistent

L'attributo Name nell'output corrisponde al nome del punto di ripristino che può essere usato come valore per il parametro --rp-name nelle operazioni di ripristino.

Ripristino della condivisione completa con l'interfaccia della riga di comando di Azure

È possibile usare questa opzione di ripristino per ripristinare la condivisione file completa nell'originale o in un percorso alternativo.

Definire i parametri seguenti per eseguire operazioni di ripristino:

  • --container-name: nome dell'account di archiviazione che ospita la condivisione file originale di cui è stato eseguito il backup. Per recuperare il nome o il nome descrittivo del contenitore, usare il comando az backup container list .
  • --item-name: nome della condivisione file originale di cui si vuole eseguire il backup per l'operazione di ripristino. Per recuperare il nome o il nome descrittivo dell'elemento di cui è stato eseguito il backup, usare il comando az backup item list .

Ripristinare una condivisione completa nel percorso originale

Quando si esegue il ripristino in una posizione originale, non è necessario specificare i parametri correlati alla destinazione. È necessario specificare solo Il conflitto di risoluzione.

L'esempio seguente usa il cmdlet az backup restore restore-azurefileshare con la modalità di ripristino impostata su originallocation per ripristinare la condivisione file azurefiles nel percorso originale. Usare il punto di ripristino 932883129628959823 ottenuto in Recuperare i punti di ripristino per la condivisione file di Azure:

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865   --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb  azurefiles

L'attributo Name nell'output corrisponde al nome del processo creato dal servizio di backup per l'operazione di ripristino. Per tenere traccia dello stato del processo, usare il cmdlet az backup job show.

Ripristinare una condivisione completa in un percorso alternativo

È possibile usare questa opzione per ripristinare una condivisione file in un percorso alternativo e mantenere la condivisione file originale così come è. Specificare i parametri seguenti per il ripristino del percorso alternativo:

  • --target-storage-account: account di archiviazione in cui viene ripristinato il contenuto di cui è stato eseguito il backup. L'account di archiviazione di destinazione deve trovarsi nella stessa posizione dell'insieme di credenziali.
  • --target-file-share: condivisione file all'interno dell'account di archiviazione di destinazione in cui viene ripristinato il contenuto sottoposto a backup.
  • --target-folder: cartella nella condivisione file in cui vengono ripristinati i dati. Se il contenuto sottoposto a backup deve essere ripristinato in una cartella radice, fornire i valori della cartella di destinazione come stringa vuota.
  • --resolve-conflict: istruzione in caso di conflitto con i dati ripristinati. Accetta Overwrite o skip.

L'esempio seguente usa az backup restore restore-azurefileshare con modalità di ripristino come alternatelocation per ripristinare la condivisione file azurefiles nell'account di archiviazione afsaccount nella condivisione file azurefiles1" nell'account di archiviazione afaccount1 .

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a  azurefiles

L'attributo Name nell'output corrisponde al nome del processo creato dal servizio di backup per l'operazione di ripristino. Per tenere traccia dello stato del processo, usare il cmdlet az backup job show.

Ripristino a livello di elemento

È possibile usare questa opzione di ripristino per ripristinare singoli file o cartelle nel percorso originale o alternativo.

Definire i parametri seguenti per eseguire operazioni di ripristino:

  • --container-name: nome dell'account di archiviazione che ospita la condivisione file originale di cui è stato eseguito il backup. Per recuperare il nome o il nome descrittivo del contenitore, usare il comando az backup container list .
  • --item-name: nome della condivisione file originale di cui si vuole eseguire il backup per l'operazione di ripristino. Per recuperare il nome o il nome descrittivo dell'elemento di cui è stato eseguito il backup, usare il comando az backup item list .

Specificare i parametri seguenti per gli elementi da ripristinare:

  • SourceFilePath: percorso assoluto del file da ripristinare all'interno della condivisione file, come stringa. Questo percorso è lo stesso percorso usato nei comandi az storage file download o az storage file show dell'interfaccia della riga di comando.
  • SourceFileType: scegliere se è selezionata una directory o un file. Accetta Directory o File.
  • ResolveConflict: istruzione in caso di conflitto con i dati ripristinati. Accetta Overwrite o skip.

Ripristinare singoli file o cartelle nel percorso originale

Usare il cmdlet az backup restore restore-azurefiles con la modalità di ripristino impostata su originallocation per ripristinare file o cartelle specifici nel percorso originale.

L'esempio seguente ripristina il file RestoreTest.txt nel percorso originale: la condivisione file azurefiles .

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite  --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

L'attributo Name nell'output corrisponde al nome del processo creato dal servizio di backup per l'operazione di ripristino. Per tenere traccia dello stato del processo, usare il cmdlet az backup job show.

Ripristinare singoli file o cartelle in un percorso alternativo

Per ripristinare file o cartelle specifici in un percorso alternativo, usare il cmdlet az backup restore restore-azurefiles con la modalità di ripristino impostata su alternatelocation e specificare i parametri correlati alla destinazione seguenti:

  • --target-storage-account: account di archiviazione in cui viene ripristinato il contenuto di cui è stato eseguito il backup. L'account di archiviazione di destinazione deve trovarsi nella stessa posizione dell'insieme di credenziali.
  • --target-file-share: condivisione file all'interno dell'account di archiviazione di destinazione in cui viene ripristinato il contenuto sottoposto a backup.
  • --target-folder: cartella nella condivisione file in cui vengono ripristinati i dati. Se il contenuto di cui è stato eseguito il backup deve essere ripristinato in una cartella radice, assegnare il valore della cartella di destinazione come stringa vuota.

L'esempio seguente ripristina il file RestoreTest.txt originariamente presente nella condivisione file azurefiles in un percorso alternativo: la cartella restoredata nella condivisione file azurefiles1 ospitata nell'account di archiviazione afaccount1 .

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

L'attributo Name nell'output corrisponde al nome del processo creato dal servizio di backup per l'operazione di ripristino. Per tenere traccia dello stato del processo, usare il cmdlet az backup job show.

Ripristinare più file o cartelle in un percorso originale o alternativo

Per eseguire il ripristino per più elementi, passare il valore per il parametro source-file-path come percorsi separati da spazi di tutti i file o cartelle da ripristinare.

Nell'esempio seguente vengono ripristinati i Restore.txt e i file di test AFS Report.docx nel percorso originale.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite  --out table

L'output sarà simile al seguente:

Name                                          ResourceGroup
------------------------------------          ---------------
649b0c14-4a94-4945-995a-19e2aace0305          azurefiles

L'attributo Name nell'output corrisponde al nome del processo creato dal servizio di backup per l'operazione di ripristino. Per tenere traccia dello stato del processo, usare il cmdlet az backup job show.

Per ripristinare più elementi in un percorso alternativo, usare il comando precedente specificando i parametri correlati alla destinazione, come illustrato nella sezione Ripristinare singoli file o cartelle in un percorso alternativo.

Passaggi successivi

Informazioni su come gestire i backup di condivisioni file di Azure con l'interfaccia della riga di comando di Azure.