Wiederherstellen von Azure-Dateien mit der Azure CLI

Azure CLI ist die Befehlszeilenumgebung zum Verwalten von Azure-Ressourcen. Azure CLI ist ein großartiges Tool zum Erstellen einer benutzerdefinierten Automatisierung zur Verwendung von Azure-Ressourcen. In diesem Artikel wird erläutert, wie Sie eine vollständige Dateifreigabe oder bestimmte Dateien von einem von Azure Backup erstellten Wiederherstellungspunkt mithilfe der Azure-Befehlszeilenschnittstelle wiederherstellten. Sie können Azure Files auch mithilfe des Azure-Portals, Azure PowerShell, REST-API wiederherstellen.

Am Ende dieses Artikels erfahren Sie, wie Sie die folgenden Vorgänge mit der Azure CLI ausführen:

• Zeigen Sie die Wiederherstellungspunkte für eine gesicherte Azure Files an.
• Wiederherstellen einer vollständigen Azure Files-Sicherung
• Wiederherstellen einzelner Dateien oder Ordner.

Hinweis

• Azure Files Restore wird nur innerhalb desselben Abonnements unterstützt, wenn PowerShell oder CLI verwendet wird.
• Azure Backup unterstützt jetzt das Wiederherstellen mehrerer Dateien oder Ordner am ursprünglichen oder alternativen Speicherort mithilfe der Azure CLI. Weitere Informationen finden Sie im Abschnitt "Mehrere Dateien oder Ordner am ursprünglichen oder alternativen Speicherort wiederherstellen" dieses Dokuments.

Voraussetzungen

In diesem Artikel wird davon ausgegangen, dass Sie bereits über eine Azure-Dateien verfügen, die von Azure Backup gesichert werden. Wenn Sie noch nicht über eine Sicherung verfügen, erfahren Sie unter Sichern von Azure Files mithilfe der Befehlszeilenschnittstelle, wie Sie die Sicherung für Ihre Dateifreigabe konfigurieren. In diesem Artikel verwenden Sie die folgenden Ressourcen:

Dateifreigabe	Speicherkonto	Region	Einzelheiten
azurefiles	afsaccount	Ost-USA	Originalquelle, gesichert mithilfe von Azure Backup
azurefiles1	afaccount1	Ost-USA	Zielquelle, die für die Wiederherstellung alternativer Speicherorte verwendet wird

Sie können eine ähnliche Struktur für Ihre Dateifreigaben verwenden, um die verschiedenen Typen von Wiederherstellungen auszuprobieren, die in diesem Artikel beschrieben werden.

Vorbereiten der Umgebung für die Azure CLI

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter "Erste Schritte mit Azure Cloud Shell".

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen möchten, installieren Sie die Azure CLI. Wenn Sie mit Windows oder macOS arbeiten, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.

  • Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Um den Authentifizierungsprozess abzuschließen, führen Sie die schritte aus, die in Ihrem Terminal angezeigt werden. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe der Azure CLI.

  • Wenn Sie dazu aufgefordert werden, installieren Sie die Azure CLI-Erweiterung bei der ersten Verwendung. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden und Verwalten von Erweiterungen mit der Azure CLI.

  • Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um auf die neueste Version zu aktualisieren.

• Für dieses Tutorial ist mindestens Version 2.0.18 der Azure CLI erforderlich. Wenn Sie Azure Cloud Shell verwenden, ist die neueste Version bereits installiert.

Abrufen von Wiederherstellungspunkten für Azure Files

Verwenden Sie das Cmdlet az backup recoverypoint list, um alle Wiederherstellungspunkte für die gesicherte Dateifreigabe aufzulisten.

Im folgenden Beispiel wird die Liste der Wiederherstellungspunkte für die Dateifreigabe azurefiles im Speicherkonto afsaccount abgerufen.

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

Sie können das vorherige Cmdlet auch ausführen, indem Sie den benutzerfreundlichen Namen für den Container und das Element verwenden, indem Sie die folgenden beiden zusätzlichen Parameter angeben:

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

Das Resultset ist eine Liste von Wiederherstellungspunkten mit Zeit- und Konsistenzdetails für jeden Wiederherstellungspunkt.

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

Das Name-Attribut in der Ausgabe entspricht dem Wiederherstellungspunktnamen, der als Wert für den Parameter "--rp-name " in Wiederherstellungsvorgängen verwendet werden kann.

Wiederherstellung einer vollständigen Freigabe mithilfe der Azure-Befehlszeilenschnittstelle

Sie können diese Wiederherstellungsoption verwenden, um die vollständige Dateifreigabe am ursprünglichen oder einem alternativen Speicherort wiederherzustellen.

Definieren Sie die folgenden Parameter zum Ausführen von Wiederherstellungsvorgängen:

• --container-name: Name des Speicherkontos, in dem die gesicherte ursprüngliche Dateifreigabe gehostet wird. Verwenden Sie den Befehl az backup container list, um den Namen oder den freundlichen Namen Ihres Containers abzurufen.
• --item-name: Name der gesicherten Originaldateifreigabe, die Sie für den Wiederherstellungsvorgang verwenden möchten. Um den Namen oder Anzeigenamen Ihres gesicherten Elements abzurufen, verwenden Sie den Befehl az backup item list.

Wiederherstellen einer vollständigen Freigabe am ursprünglichen Speicherort

Wenn Sie einen ursprünglichen Speicherort wiederherstellen, müssen Sie keine zielbezogenen Parameter angeben. Nur Konflikt lösen muss angegeben werden.

Im folgenden Beispiel wird das Cmdlet az backup restore restore-azurefileshare mit dem Wiederherstellungsmodus originallocation verwendet, um die Dateifreigabe azurefiles am ursprünglichen Speicherort wiederherzustellen. Sie verwenden den Wiederherstellungspunkt 932883129628959823, den Sie in Fetch-Wiederherstellungspunkten für die Azure Files abgerufen haben:

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

Das Name-Attribut in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für den Wiederherstellungsvorgang erstellt wird. Verwenden Sie zum Nachverfolgen des Auftragsstatus das Cmdlet az backup job show.

Wiederherstellen einer vollständigen Freigabe an einem alternativen Speicherort

Mit dieser Option können Sie eine Dateifreigabe an einem alternativen Speicherort wiederherstellen und die ursprüngliche Dateifreigabe beibehalten. Geben Sie die folgenden Parameter für die Wiederherstellung an einem alternativen Standort an:

• --target-storage-account: Das Speicherkonto, in das der gesicherte Inhalt wiederhergestellt wird. Das Zielspeicherkonto muss sich am gleichen Speicherort wie der Tresor befinden.
• --target-file-share: Dateifreigabe in dem Zielspeicherkonto, in dem der gesicherte Inhalt wiederhergestellt wird.
• --target-folder: Ordner unter der Dateifreigabe, in dem die Daten wiederhergestellt werden. Wenn der gesicherte Inhalt in einem Stammordner wiederhergestellt werden soll, geben Sie den Zielordnerwerten eine leere Zeichenfolge.
• --resolve-conflict: Anweisung, wenn ein Konflikt mit den wiederhergestellten Daten vorliegt. Für diesen Parameter kann Overwrite oder Skip angegeben werden.

Im folgenden Beispiel wird az backup restore restore-azurefileshare mit dem Wiederherstellungsmodus alternatelocation verwendet, um die Dateifreigabe azurefiles im Speicherkonto afsaccount auf der Dateifreigabe azurefiles1" im Speicherkonto afaccount1 wiederherzustellen.

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

Das Name-Attribut in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für den Wiederherstellungsvorgang erstellt wird. Verwenden Sie zum Nachverfolgen des Auftragsstatus das Cmdlet az backup job show.

Wiederherstellung auf Elementebene

Sie können diese Wiederherstellungsoption verwenden, um einzelne Dateien oder Ordner am ursprünglichen oder einem alternativen Speicherort wiederherzustellen.

Definieren Sie die folgenden Parameter zum Ausführen von Wiederherstellungsvorgängen:

• --container-name: Name des Speicherkontos, in dem die gesicherte ursprüngliche Dateifreigabe gehostet wird. Verwenden Sie den Befehl az backup container list, um den Namen oder den freundlichen Namen Ihres Containers abzurufen.
• --item-name: Name der gesicherten Originaldateifreigabe, die Sie für den Wiederherstellungsvorgang verwenden möchten. Um den Namen oder Anzeigenamen Ihres gesicherten Elements abzurufen, verwenden Sie den Befehl az backup item list.

Geben Sie die folgenden Parameter für die Elemente an, die Sie wiederherstellen möchten:

• SourceFilePath: Absoluter Pfad der Datei, die in der Dateifreigabe wiederhergestellt werden soll, als Zeichenfolge. Dieser Pfad ist derselbe Pfad, der in den CLI-Befehlen az storage file download oder az storage file show verwendet wird.
• SourceFileType: Wählen Sie aus, ob ein Verzeichnis oder eine Datei ausgewählt ist. Für diesen Parameter kann Directory oder File angegeben werden.
• ResolveConflict: Die Anweisung bei einem Konflikt mit den wiederhergestellten Daten. Für diesen Parameter kann Overwrite oder Skip angegeben werden.

Wiederherstellen einzelner Dateien oder Ordner am ursprünglichen Speicherort

Verwenden Sie das az backup restore restore-azurefiles Cmdlet, bei dem der Wiederherstellungsmodus auf originallocation festgelegt ist, um bestimmte Dateien oder Ordner an ihrem ursprünglichen Speicherort wiederherzustellen.

Im folgenden Beispiel wird die Datei RestoreTest.txt an ihrem ursprünglichen Speicherort wiederhergestellt: in der Dateifreigabe 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

Das Name-Attribut in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für den Wiederherstellungsvorgang erstellt wird. Verwenden Sie zum Nachverfolgen des Auftragsstatus das Cmdlet az backup job show.

Wiederherstellen einzelner Dateien oder Ordner an einem alternativen Speicherort

Um bestimmte Dateien oder Ordner an einem alternativen Speicherort wiederherzustellen, verwenden Sie das Cmdlet mit dem Wiederherstellungsmodus auf az backup restore restore-azurefiles und geben Sie die folgenden zielbezogenen Parameter an:

• --target-storage-account: Das Speicherkonto, in das der gesicherte Inhalt wiederhergestellt wird. Das Zielspeicherkonto muss sich am gleichen Speicherort wie der Tresor befinden.
• --target-file-share: Dateifreigabe in dem Zielspeicherkonto, in dem der gesicherte Inhalt wiederhergestellt wird.
• --target-folder: Ordner unter der Dateifreigabe, in dem die Daten wiederhergestellt werden. Wenn der gesicherte Inhalt in einem Stammordner wiederhergestellt werden soll, geben Sie dem Zielordner den Wert als leere Zeichenfolge.

Im folgenden Beispiel wird die RestoreTest.txt Datei, die ursprünglich in der azurefiles Dateifreigabe vorhanden ist, auf einen alternativen Speicherort wiederhergestellt: der restoredata Ordner in der azurefiles1-Dateifreigabe , die im Afaccount1-Speicherkonto gehostet wird.

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

Das Name-Attribut in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für den Wiederherstellungsvorgang erstellt wird. Verwenden Sie zum Nachverfolgen des Auftragsstatus das Cmdlet az backup job show.

Wiederherstellen mehrerer Dateien oder Ordner am ursprünglichen oder an einem alternativen Speicherort

Um die Wiederherstellung für mehrere Elemente durchzuführen, übergeben Sie den Wert für den Parameter "Source-file-path " als leer getrennte Pfade aller Dateien oder Ordner, die Sie wiederherstellen möchten.

Im folgenden Beispiel werden die Restore.txt und AFS-Tests Report.docx Dateien am ursprünglichen Speicherort wiederhergestellt.

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

Die Ausgabe wird etwa wie folgt aussehen:

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

Das Name-Attribut in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für den Wiederherstellungsvorgang erstellt wird. Verwenden Sie zum Nachverfolgen des Auftragsstatus das Cmdlet az backup job show.

Wenn Sie mehrere Elemente an einem alternativen Speicherort wiederherstellen möchten, verwenden Sie den obigen Befehl, indem Sie zielbezogene Parameter angeben, wie im Abschnitt "Einzelne Dateien oder Ordner wiederherstellen" in einem alternativen Speicherortabschnitt erläutert wird.

Nächste Schritte

Verwalten Sie Azure Files-Sicherungen mithilfe des Azure-Portals, Azure PowerShell, Azure CLI, REST-API.