Freigeben über

Wiederherstellen von Azure-Dateifreigaben mit der Azure-Befehlszeilenschnittstelle

  • Artikel

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 von Azure CLI wiederherstellten können. Sie können diese Schritte auch mit Azure PowerShell oder im Azure-Portal ausführen.

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

  • Anzeigen von Wiederherstellungspunkten für eine gesicherte Azure-Dateifreigabe.
  • Wiederherstellen einer vollständigen Azure-Dateifreigabe.
  • Wiederherstellen einzelner Dateien oder Ordner.

Hinweis

Azure Backup unterstützt jetzt das Wiederherstellen mehrerer Dateien oder Ordner am ursprünglichen oder an einem alternativen Speicherort mit Azure CLI. Weitere Informationen finden Sie im Abschnitt Wiederherstellen mehrerer Dateien oder Ordner am ursprünglichen oder an einem alternativen Speicherort dieses Dokuments.

Voraussetzungen

In diesem Artikel wird vorausgesetzt, dass Sie bereits über eine Azure-Dateifreigabe verfügen, die durch Azure Backup gesichert wird. Wenn Sie noch nicht über eine Dateifreigabe verfügen, erfahren Sie unter Sichern von Azure-Dateifreigaben mit CLI, wie Sie die Sicherung für Ihre Dateifreigabe konfigurieren. In diesem Artikel verwenden Sie die folgenden Ressourcen:

Dateifreigabe Speicherkonto Region Details
azurefiles afsaccount EastUS Mit Azure Backup gesicherte ursprüngliche Quellressource
azurefiles1 afaccount1 EastUS Für die Wiederherstellung an einem alternativen Speicherort verwendete Zielressource

Sie können eine ähnliche Struktur für Ihre Dateifreigaben verwenden, um die verschiedenen Arten 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 Schnellstart für Bash in Azure Cloud Shell.

  • Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, 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. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.

    • Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden 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 das Upgrade auf die aktuelle Version durchzuführen.

  • Für dieses Tutorial ist mindestens Version 2.0.18 der Azure CLI erforderlich. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.

Abrufen von Wiederherstellungspunkten für die Azure-Dateifreigabe

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

Das folgende Beispiel ruft die Liste der Wiederherstellungspunkte für die Dateifreigabe azurefiles im Speicherkonto afsaccount ab.

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 vorstehende Cmdlet auch mit den Anzeigenamen für den Container und das Element ausführen, 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 Attribut Name in der Ausgabe entspricht dem Namen des Wiederherstellungspunkts, der als Wert für den Parameter --rp-name bei Wiederherstellungsvorgängen verwendet werden kann.

Wiederherstellung einer vollständigen Freigabe mit 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, um Wiederherstellungsvorgänge durchzuführen:

  • --container-name: Der Name des Speicherkontos, das die gesicherte ursprüngliche Dateifreigabe hostet. Um den Namen oder den Anzeigenamen Ihres Containers abzurufen, verwenden Sie den Befehl az backup container list.
  • --item-name: Der Name der gesicherten ursprünglichen Dateifreigabe, die Sie für den Wiederherstellungsvorgang verwenden wollen. 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 an einem ursprünglichen Speicherort eine Wiederherstellung vornehmen, müssen Sie nicht alle zielbezogenen Parameter angeben. Nur Resolve Conflict 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. Dabei wird der Wiederherstellungspunkt 932883129628959823 verwendet, den Sie unter Abrufen von Wiederherstellungspunkten für die Azure-Dateifreigabe 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 Attribut Name in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für Ihren 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 unverändert beibehalten. Geben Sie die folgenden Parameter für die Wiederherstellung an einem alternativen Standort an:

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

Im folgenden Beispiel wird das Cmdlet az backup restore restore-azurefileshare mit dem Wiederherstellungsmodus alternatelocation verwendet, um die Dateifreigabe azurefiles im Speicherkonto afsaccount auf die 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 Attribut Name in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für Ihren 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, um Wiederherstellungsvorgänge durchzuführen:

  • --container-name: Der Name des Speicherkontos, das die gesicherte ursprüngliche Dateifreigabe hostet. Um den Namen oder den Anzeigenamen Ihres Containers abzurufen, verwenden Sie den Befehl az backup container list.
  • --item-name: Der Name der gesicherten ursprünglichen Dateifreigabe, die Sie für den Wiederherstellungsvorgang verwenden wollen. 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: Der absolute Pfad der (in der Dateifreigabe wiederherzustellenden) Datei als Zeichenfolge. Dieser Pfad ist der gleiche Pfad, der in den CLI-Befehlen az storage file download oder az storage file show verwendet wird.
  • SourceFileType: Wählen Sie ein Verzeichnis oder eine Datei aus. 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 Cmdlet az backup restore restore-azurefiles, mit dem Wiederherstellungsmodus originallocation, 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 Attribut Name in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für Ihren 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 az backup restore restore-azurefiles mit dem Wiederherstellungsmodus alternatelocation, und geben Sie die folgenden zielbezogenen Parameter an:

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

Im folgenden Beispiel wird die Datei RestoreTest.txt, die ursprünglich in der Dateifreigabe azurefiles vorhanden war, an einem alternativen Speicherort wiederhergestellt: im Ordner restoredata in der im Speicherkonto afaccount1 gehosteten Dateifreigabeazurefiles1.

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 Attribut Name in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für Ihren 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

Wenn Sie die Wiederherstellung für mehrere Elemente durchführen möchten, übergeben Sie den Wert für den Parameter source-file-path als durch Leerzeichen getrennte Pfade aller Dateien oder Ordner, die wiederhergestellt werden sollen.

Im folgenden Beispiel werde die Dateien Restore.txt und AFS testing Report.docx an ihrem 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 sieht etwa wie folgt aus:

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

Das Attribut Name in der Ausgabe entspricht dem Namen des Auftrags, der vom Sicherungsdienst für Ihren 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 und geben Sie zielbezogene Parameter entsprechend der Beschreibung im Abschnitt Wiederherstellen einzelner Dateien oder Ordner an einem alternativen Speicherort an.

Nächste Schritte

Verwalten der Sicherungen von Azure-Dateifreigaben mit Azure CLI.