Återställa Azure-filresurser med Azure CLI

Azure CLI tillhandahåller en kommandoradsupplevelse för hantering av Azure-resurser. Det är ett bra verktyg för att skapa anpassad automatisering för att använda Azure-resurser. Den här artikeln beskriver hur du återställer en hel filresurs eller specifika filer från en återställningspunkt som skapats av Azure Backup med hjälp av Azure CLI. Du kan också utföra de här stegen med Azure PowerShell eller Azure Portal.

I slutet av den här artikeln får du lära dig hur du utför följande åtgärder med Azure CLI:

• Visa återställningspunkter för en säkerhetskopierad Azure-filresurs.
• Återställa en fullständig Azure-filresurs.
• Återställa enskilda filer eller mappar.

Kommentar

Azure Backup stöder nu återställning av flera filer eller mappar till den ursprungliga eller en alternativ plats med hjälp av Azure CLI. Mer information finns i avsnittet Återställa flera filer eller mappar till den ursprungliga eller alternativa platsen i det här dokumentet.

Förutsättningar

Den här artikeln förutsätter att du redan har en Azure-filresurs som säkerhetskopieras av Azure Backup. Om du inte har någon kan du läsa Säkerhetskopiera Azure-filresurser med CLI för att konfigurera säkerhetskopiering för filresursen. I den här artikeln använder du följande resurser:

Filresurs	Lagringskonto	Region	Details
azurefiles	afsaccount	EastUS	Ursprunglig källa som säkerhetskopieras med hjälp av Azure Backup
azurefiles1	afaccount1	EastUS	Målkälla som används för alternativ platsåterställning

Du kan använda en liknande struktur för dina filresurser för att prova de olika typer av återställningar som beskrivs i den här artikeln.

Förbereda din miljö för Azure CLI

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.

  • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

• Den här självstudien kräver version 2.0.18 eller senare av Azure CLI. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.

Hämta återställningspunkter för Azure-filresursen

Använd cmdleten az backup recoverypoint list för att lista alla återställningspunkter för den säkerhetskopierade filresursen.

I följande exempel hämtas listan över återställningspunkter för azurefiles-filresursen i afsaccount-lagringskontot .

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

Du kan också köra den tidigare cmdleten med hjälp av det egna namnet för containern och objektet genom att ange följande två ytterligare parametrar:

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

Resultatuppsättningen är en lista över återställningspunkter med tids- och konsekvensinformation för varje återställningspunkt.

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

Attributet Namn i utdata motsvarar namnet på återställningspunkten som kan användas som ett värde för parametern --rp-name i återställningsåtgärder.

Fullständig resursåterställning med hjälp av Azure CLI

Du kan använda det här återställningsalternativet för att återställa den fullständiga filresursen på den ursprungliga eller en alternativ plats.

Definiera följande parametrar för att utföra återställningsåtgärder:

• --container-name: Namnet på lagringskontot som är värd för den säkerhetskopierade ursprungliga filresursen. Om du vill hämta namnet eller det egna namnet på containern använder du kommandot az backup container list .
• --item-name: Namnet på den säkerhetskopierade ursprungliga filresursen som du vill använda för återställningsåtgärden. Om du vill hämta namnet eller det egna namnet på det säkerhetskopierade objektet använder du kommandot az backup item list .

Återställa en fullständig resurs till den ursprungliga platsen

När du återställer till en ursprunglig plats behöver du inte ange målrelaterade parametrar. Endast Lös konflikt måste anges.

I följande exempel används cmdleten az backup restore restore-azurefileshare med återställningsläget inställt på originallocation för att återställa azurefiles-filresursen på den ursprungliga platsen. Du använder återställningspunkten 932883129628959823 som du hämtade i Hämta återställningspunkter för Azure-filresursen:

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

Attributet Namn i utdata motsvarar namnet på det jobb som skapas av säkerhetskopieringstjänsten för återställningsåtgärden. Om du vill spåra jobbets status använder du cmdleten az backup job show .

Återställa en fullständig resurs till en alternativ plats

Du kan använda det här alternativet för att återställa en filresurs till en alternativ plats och behålla den ursprungliga filresursen som den är. Ange följande parametrar för alternativ platsåterställning:

• --target-storage-account: Lagringskontot som det säkerhetskopierade innehållet återställs till. Mållagringskontot måste finnas på samma plats som valvet.
• --target-file-share: Filresursen i mållagringskontot som det säkerhetskopierade innehållet återställs till.
• --target-folder: Mappen under filresursen som data återställs till. Om det säkerhetskopierade innehållet ska återställas till en rotmapp ger du målmappsvärdena som en tom sträng.
• --resolve-conflict: Instruktion om det finns en konflikt med återställde data. Accepterar överskrivning eller hoppa över.

I följande exempel används az backup restore restore-azurefileshare med återställningsläge som alternativlokalisering för att återställa azurefiles-filresursen i lagringskontot afsaccount till azurefiles1-filresursen på lagringskontot 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

Attributet Namn i utdata motsvarar namnet på det jobb som skapas av säkerhetskopieringstjänsten för återställningsåtgärden. Om du vill spåra jobbets status använder du cmdleten az backup job show .

Återställning på objektnivå

Du kan använda det här återställningsalternativet för att återställa enskilda filer eller mappar på den ursprungliga eller en alternativ plats.

Definiera följande parametrar för att utföra återställningsåtgärder:

• --container-name: Namnet på lagringskontot som är värd för den säkerhetskopierade ursprungliga filresursen. Om du vill hämta namnet eller det egna namnet på containern använder du kommandot az backup container list .
• --item-name: Namnet på den säkerhetskopierade ursprungliga filresursen som du vill använda för återställningsåtgärden. Om du vill hämta namnet eller det egna namnet på det säkerhetskopierade objektet använder du kommandot az backup item list .

Ange följande parametrar för de objekt som du vill återställa:

• SourceFilePath: Den absoluta sökvägen till filen som ska återställas i filresursen som en sträng. Den här sökvägen är samma sökväg som används i az storage file download eller az storage file show CLI-kommandon.
• SourceFileType: Välj om en katalog eller en fil ska väljas. Accepterar katalog eller fil.
• ResolveConflict: Instruktion om det finns en konflikt med återställde data. Accepterar överskrivning eller hoppa över.

Återställa enskilda filer eller mappar till den ursprungliga platsen

Använd cmdleten az backup restore-azurefiles med återställningsläget inställt på originallocation för att återställa specifika filer eller mappar till den ursprungliga platsen.

I följande exempel återställs den RestoreTest.txt filen på den ursprungliga platsen: filresursen 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

Attributet Namn i utdata motsvarar namnet på det jobb som skapas av säkerhetskopieringstjänsten för återställningsåtgärden. Om du vill spåra jobbets status använder du cmdleten az backup job show .

Återställa enskilda filer eller mappar till en alternativ plats

Om du vill återställa specifika filer eller mappar till en annan plats använder du cmdleten az backup restore-azurefiles med återställningsläget inställt på alternatelocation och anger följande målrelaterade parametrar:

• --target-storage-account: Lagringskontot som det säkerhetskopierade innehållet återställs till. Mållagringskontot måste finnas på samma plats som valvet.
• --target-file-share: Filresursen i mållagringskontot som det säkerhetskopierade innehållet återställs till.
• --target-folder: Mappen under filresursen som data återställs till. Om det säkerhetskopierade innehållet ska återställas till en rotmapp ger du målmappens värde som en tom sträng.

I följande exempel återställs den RestoreTest.txt fil som ursprungligen fanns i azurefiles-filresursen till en annan plats: mappen restoredata i filresursen azurefiles1 som finns på lagringskontot 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

Attributet Namn i utdata motsvarar namnet på det jobb som skapas av säkerhetskopieringstjänsten för återställningsåtgärden. Om du vill spåra jobbets status använder du cmdleten az backup job show .

Återställa flera filer eller mappar till den ursprungliga eller alternativa platsen

Om du vill återställa flera objekt skickar du värdet för parametern source-file-path som blankstegsavgränsade sökvägar för alla filer eller mappar som du vill återställa.

I följande exempel återställs Restore.txt - och AFS-testningen Report.docx filer på den ursprungliga platsen.

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

Resultatet blir något som liknar:

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

Attributet Namn i utdata motsvarar namnet på det jobb som skapas av säkerhetskopieringstjänsten för återställningsåtgärden. Om du vill spåra jobbets status använder du cmdleten az backup job show .

Om du vill återställa flera objekt till en alternativ plats använder du kommandot ovan genom att ange målrelaterade parametrar enligt beskrivningen i avsnittet Återställ enskilda filer eller mappar till en alternativ plats .

Nästa steg

Lär dig hur du hanterar säkerhetskopieringar av Azure-filresurser med Azure CLI.