Udostępnij za pośrednictwem

Przywracanie Azure Files za pomocą Azure CLI

Azure CLI zapewnia środowisko wiersza polecenia do zarządzania zasobami platformy Azure. Jest to doskonałe narzędzie do tworzenia niestandardowej automatyzacji w celu korzystania z zasobów platformy Azure. W tym artykule wyjaśniono, jak przywrócić cały udział plików lub określone pliki z punktu przywracania utworzonego przez Azure Backup przy użyciu Azure CLI. Możesz również przywrócić usługę Azure Files przy użyciu witryny Azure Portal, programu Azure PowerShell, interfejsu API REST.

Na końcu tego artykułu dowiesz się, jak wykonywać następujące operacje za pomocą interfejsu wiersza polecenia platformy Azure:

  • Wyświetl punkty przywracania dla kopii zapasowej usługi Azure Files.
  • Przywracanie pełnej usługi Azure Files.
  • Przywracanie pojedynczych plików lub folderów.

Uwaga

  • Przywracanie usługi Azure Files jest obsługiwane tylko w ramach tej samej subskrypcji w przypadku korzystania z programu PowerShell lub interfejsu wiersza polecenia.
  • Usługa Azure Backup obsługuje teraz przywracanie wielu plików lub folderów do oryginalnej lub alternatywnej lokalizacji przy użyciu interfejsu wiersza polecenia platformy Azure. Aby dowiedzieć się więcej, zapoznaj się z sekcją Przywracanie wielu plików lub folderów do oryginalnej lub alternatywnej lokalizacji tego dokumentu.

Wymagania wstępne

W tym artykule założono, że masz już kopię zapasową usługi Azure Files utworzoną przez usługę Azure Backup. Jeśli nie masz kopii zapasowej, zobacz Tworzenie kopii zapasowej usługi Azure Files za pomocą interfejsu wiersza polecenia, aby skonfigurować tworzenie kopii zapasowej dla udziału plików. W tym artykule są używane następujące zasoby:

Udział plików Konto magazynu Rejon Szczegóły
azurefiles afsaccount Wschodnie USA Oryginalne źródło zabezpieczone przy użyciu usługi Azure Backup
azurefiles1 afaccount1 Wschodnie USA Źródło docelowe używane do odzyskiwania lokalizacji alternatywnej

Możesz użyć podobnej struktury swojego udostępniania plików, aby wypróbować różne typy przywracania, które zostały wyjaśnione w tym artykule.

Przygotuj swoje środowisko dla Azure CLI

  • Ten samouczek wymaga wersji 2.0.18 lub nowszej interfejsu wiersza polecenia platformy Azure. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.

Pobierz punkty odzyskiwania dla Azure Files

Użyj polecenia cmdlet az backup recoverypoint list, aby wyświetlić listę wszystkich punktów odzyskiwania dla kopii zapasowej udziału plików.

Poniższy przykład pobiera listę punktów odzyskiwania dla azurefiles udziału w plikach na koncie magazynu 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

Możesz również uruchomić poprzednie polecenie cmdlet przy użyciu przyjaznej nazwy kontenera i elementu, podając następujące dwa dodatkowe parametry:

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

Zestaw wyników to lista punktów przywracania z informacjami o czasie i spójności dla każdego punktu przywracania.

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

Atrybut Name w danych wyjściowych odpowiada nazwie punktu odzyskiwania, która może być używana jako wartość parametru --rp-name w operacjach odzyskiwania.

Odzyskiwanie pełnego udziału przy użyciu Azure CLI

Tę opcję przywracania można użyć, aby przywrócić pełny zasób plików w oryginalnej lub lokalizacji alternatywnej.

Zdefiniuj następujące parametry, aby wykonać operacje przywracania:

  • --container-name: nazwa konta magazynującego, które hostuje oryginalny udział plików będący kopią zapasową. Aby pobrać nazwę lub przyjazną nazwę kontenera, użyj polecenia az backup container list .
  • --item-name: nazwa oryginalnego zarchiwizowanego udziału plików, którego chcesz użyć do operacji przywracania. Aby pobrać nazwę lub przyjazną nazwę swojego elementu kopii zapasowej, użyj polecenia az backup item list.

Przywróć pełny udział do oryginalnej lokalizacji

Podczas przywracania do oryginalnej lokalizacji nie trzeba określać parametrów związanych z obiektem docelowym. Należy podać tylko rozwiązanie konfliktu .

W poniższym przykładzie użyto polecenia cmdlet az backup restore restore-azurefileshare w trybie przywracania originallocation, aby przywrócić udział plików azurefiles w oryginalnej lokalizacji. Najpierw użyj punktu odzyskiwania 932883129628959823, który uzyskałeś w „Pobieranie punktów odzyskiwania dla usługi Azure Files”:

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

Atrybut Name w danych wyjściowych odpowiada nazwie zadania utworzonego przez usługę tworzenia kopii zapasowej dla operacji przywracania. Aby śledzić stan zadania, użyj polecenia cmdlet az backup job show.

Przywróć całkowity udział do lokalizacji alternatywnej

Możesz użyć tej opcji, aby przywrócić udział plików do lokalizacji alternatywnej i zachować oryginalny udział plików, tak jak to jest. Określ następujące parametry odzyskiwania lokalizacji alternatywnej:

  • --target-storage-account: konto magazynowe, do którego przywracana jest kopia zapasowa zawartości. Docelowe konto magazynowe musi znajdować się w tej samej lokalizacji co sejf.
  • --target-file-share: Udział plików na docelowym koncie magazynu, do którego przywracana jest zawartość kopii zapasowej.
  • --target-folder: folder w ramach udziału plików, do którego są przywracane dane. Jeśli kopia zapasowa zawartości ma zostać przywrócona do folderu głównego, ustaw wartości folderu docelowego jako pusty ciąg.
  • --resolve-conflict: Instrukcja, jeśli występuje konflikt z przywróconymi danymi. Akceptuje zastępowanie lub pomijanie.

W poniższym przykładzie użyto az backup restore restore-azurefileshare jako trybu przywracania w celu przywrócenia alternatelocation udziału plików na koncie magazynu azurefiles do udziału plików azurefiles1 na koncie magazynu 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

Atrybut Name w danych wyjściowych odpowiada nazwie zadania utworzonego przez usługę tworzenia kopii zapasowej dla operacji przywracania. Aby śledzić stan zadania, użyj polecenia cmdlet az backup job show.

Odzyskiwanie na poziomie elementu

Za pomocą tej opcji przywracania można przywrócić poszczególne pliki lub foldery w oryginalnej lub alternatywnej lokalizacji.

Zdefiniuj następujące parametry, aby wykonać operacje przywracania:

  • --container-name: nazwa konta magazynującego, które hostuje oryginalny udział plików będący kopią zapasową. Aby pobrać nazwę lub przyjazną nazwę kontenera, użyj polecenia az backup container list .
  • --item-name: nazwa oryginalnego zarchiwizowanego udziału plików, którego chcesz użyć do operacji przywracania. Aby pobrać nazwę lub przyjazną nazwę swojego elementu kopii zapasowej, użyj polecenia az backup item list.

Określ następujące parametry dla elementów, które chcesz odzyskać:

  • SourceFilePath: ścieżka bezwzględna pliku, która ma zostać przywrócona w udziale plików, jako ciąg. Ta ścieżka jest tę samą ścieżką używaną w poleceniach CLI az storage file download lub az storage file show.
  • SourceFileType: wybierz, czy wybrano katalog, czy plik. Akceptuje katalog lub plik.
  • ResolveConflict: Instrukcja, jeśli występuje konflikt z przywróconymi danymi. Akceptuje zastępowanie lub pomijanie.

Przywracanie pojedynczych plików lub folderów do oryginalnej lokalizacji

Użyj polecenia cmdlet, ustawiając tryb przywracania na az backup restore restore-azurefiles, aby przywrócić określone pliki lub foldery do ich oryginalnej lokalizacji.

Poniższy przykład przywraca plik RestoreTest.txt w jego oryginalnej lokalizacji: w udostępnionym zasobie plików 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

Atrybut Name w danych wyjściowych odpowiada nazwie zadania utworzonego przez usługę tworzenia kopii zapasowej dla operacji przywracania. Aby śledzić stan zadania, użyj polecenia cmdlet az backup job show.

Przywracanie pojedynczych plików lub folderów do lokalizacji alternatywnej

Aby przywrócić określone pliki lub foldery do lokalizacji alternatywnej, użyj az backup restore restore-azurefiles polecenia cmdlet z ustawionym alternatelocation trybem przywracania i określ następujące parametry związane z obiektem docelowym:

  • --target-storage-account: konto magazynowe, do którego przywracana jest kopia zapasowa zawartości. Docelowe konto magazynowe musi znajdować się w tej samej lokalizacji co sejf.
  • --target-file-share: Udział plików na docelowym koncie magazynu, do którego przywracana jest zawartość kopii zapasowej.
  • --target-folder: folder w ramach udziału plików, do którego są przywracane dane. Jeśli kopia zapasowa zawartości ma zostać przywrócona do folderu głównego, nadaj wartości folderu docelowego jako pusty ciąg.

Poniższy przykład przywraca plik RestoreTest.txt, który pierwotnie znajdował się w udziale plików azurefiles do alternatywnej lokalizacji: folder restoredata w udziale plików azurefiles1, który jest hostowany w koncie magazynu 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

Atrybut Name w danych wyjściowych odpowiada nazwie zadania utworzonego przez usługę tworzenia kopii zapasowej dla operacji przywracania. Aby śledzić stan zadania, użyj polecenia cmdlet az backup job show.

Przywracanie wielu plików lub folderów do oryginalnej lub alternatywnej lokalizacji

Aby wykonać przywracanie dla wielu elementów, przekaż wartość parametru source-file-path w postaci ścieżek wszystkich plików lub folderów oddzielonych spacją, które chcesz przywrócić.

Poniższy przykład przywraca Restore.txt i pliki testowe AFS Report.docx w ich oryginalnej lokalizacji.

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

Dane wyjściowe będą podobne do następujących:

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

Atrybut Name w danych wyjściowych odpowiada nazwie zadania utworzonego przez usługę tworzenia kopii zapasowej dla operacji przywracania. Aby śledzić stan zadania, użyj polecenia cmdlet az backup job show.

Jeśli chcesz przywrócić wiele elementów do lokalizacji alternatywnej, użyj powyższego polecenia, określając parametry związane z obiektem docelowym zgodnie z wyjaśnieniem w sekcji Przywracanie pojedynczych plików lub folderów do lokalizacji alternatywnej .

Następne kroki

Zarządzanie kopiami zapasowymi usługi Azure Files przy użyciu witryny Azure Portal, programu Azure PowerShell, interfejsu wiersza polecenia platformy Azure, interfejsu API REST.