Azure-bestandsshares herstellen met de Azure CLI

De Azure CLI biedt een opdrachtregelervaring voor het beheren van Azure-resources. Het is een uitstekend hulpprogramma voor het bouwen van aangepaste automatisering voor het gebruik van Azure-resources. In dit artikel wordt uitgelegd hoe u een volledige bestandsshare of specifieke bestanden herstelt vanaf een herstelpunt dat door Azure Backup is gemaakt met behulp van de Azure CLI. U kunt deze stappen ook uitvoeren met Azure PowerShell of in Azure Portal.

Aan het einde van dit artikel leert u hoe u de volgende bewerkingen uitvoert met de Azure CLI:

• Bekijk herstelpunten voor een back-up van een Azure-bestandsshare.
• Een volledige Azure-bestandsshare herstellen.
• Afzonderlijke bestanden of mappen herstellen.

Notitie

Azure Backup biedt nu ondersteuning voor het herstellen van meerdere bestanden of mappen naar de oorspronkelijke of een alternatieve locatie met behulp van Azure CLI. Raadpleeg de sectie Meerdere bestanden of mappen herstellen naar de oorspronkelijke of alternatieve locatiesectie van dit document voor meer informatie.

Vereisten

In dit artikel wordt ervan uitgegaan dat u al een Azure-bestandsshare hebt waarvan een back-up wordt gemaakt door Azure Backup. Als u er nog geen hebt, raadpleegt u Back-up maken van Azure-bestandsshares met de CLI om een back-up voor uw bestandsshare te configureren. Voor dit artikel gebruikt u de volgende bronnen:

Bestandsshare	Opslagaccount	Regio	DETAILS
azurefiles	afsaccount	EastUS	Back-up van de oorspronkelijke bron met behulp van Azure Backup
azurefiles1	afaccount1	EastUS	Doelbron die wordt gebruikt voor herstel van alternatieve locaties

U kunt een vergelijkbare structuur voor uw bestandsshares gebruiken om de verschillende typen herstelbewerkingen uit te proberen die in dit artikel worden uitgelegd.

De omgeving voorbereiden op de Azure CLI

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Voor deze zelfstudie is versie 2.0.18 of hoger Azure CLI vereist. Als u Azure Cloud Shell gebruikt, is de nieuwste versie al geïnstalleerd.

Herstelpunten ophalen voor de Azure-bestandsshare

Gebruik de cmdlet az backup recoverypoint list om alle herstelpunten voor de back-upbestandsshare weer te geven.

In het volgende voorbeeld wordt de lijst met herstelpunten voor de azurefiles-bestandsshare opgehaald in het afsaccount-opslagaccount .

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

U kunt de vorige cmdlet ook uitvoeren met behulp van de beschrijvende naam voor de container en het item door de volgende twee extra parameters op te geven:

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

De resultatenset is een lijst met herstelpunten met tijd- en consistentiedetails voor elk herstelpunt.

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

Het kenmerk Name in de uitvoer komt overeen met de naam van het herstelpunt dat kan worden gebruikt als een waarde voor de parameter --rp-name in herstelbewerkingen.

Herstel van volledige share met behulp van de Azure CLI

U kunt deze hersteloptie gebruiken om de volledige bestandsshare op de oorspronkelijke of een alternatieve locatie te herstellen.

Definieer de volgende parameters om herstelbewerkingen uit te voeren:

• --containernaam: de naam van het opslagaccount dat als host fungeert voor de oorspronkelijke bestandsshare waarvan een back-up is gemaakt. Als u de naam of beschrijvende naam van uw container wilt ophalen, gebruikt u de opdracht az backup container list .
• --item-name: de naam van de back-up van de oorspronkelijke bestandsshare die u wilt gebruiken voor de herstelbewerking. Als u de naam of beschrijvende naam van uw back-upitem wilt ophalen, gebruikt u de opdracht az backup item list .

Een volledige share herstellen naar de oorspronkelijke locatie

Wanneer u herstelt naar een oorspronkelijke locatie, hoeft u geen doelparameters op te geven. Alleen conflict oplossen moet worden opgegeven.

In het volgende voorbeeld wordt de cmdlet az backup restore-azurefileshare met de herstelmodus ingesteld op originallocation om de azurefiles-bestandsshare op de oorspronkelijke locatie te herstellen. U gebruikt het herstelpunt 932883129628959823, die u hebt verkregen in Herstelpunten ophalen voor de Azure-bestandsshare:

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

Het kenmerk Naam in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw herstelbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.

Een volledige share herstellen naar een alternatieve locatie

U kunt deze optie gebruiken om een bestandsshare te herstellen naar een alternatieve locatie en de oorspronkelijke bestandsshare te behouden. Geef de volgende parameters op voor herstel van alternatieve locaties:

• --target-storage-account: het opslagaccount waarnaar de back-upinhoud wordt hersteld. Het doelopslagaccount moet zich op dezelfde locatie bevinden als de kluis.
• --target-file-share: de bestandsshare in het doelopslagaccount waarnaar de back-upinhoud wordt hersteld.
• --target-folder: de map onder de bestandsshare waarnaar gegevens worden hersteld. Als de back-upinhoud moet worden hersteld naar een hoofdmap, geeft u de doelmapwaarden op als een lege tekenreeks.
• --resolve-conflict: Instructie als er een conflict is met de herstelde gegevens. Accepteert overschrijven of overslaan.

In het volgende voorbeeld wordt az backup restore restore-azurefileshare met de herstelmodus gebruikt als alternatieve locatie om de azurefiles-bestandsshare in het afsaccount-opslagaccount te herstellen naar de azurefiles1-bestandsshare in het afaccount1-opslagaccount .

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

Het kenmerk Naam in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw herstelbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.

Herstel op itemniveau

U kunt deze hersteloptie gebruiken om afzonderlijke bestanden of mappen op de oorspronkelijke of een alternatieve locatie te herstellen.

Definieer de volgende parameters om herstelbewerkingen uit te voeren:

• --containernaam: de naam van het opslagaccount dat als host fungeert voor de oorspronkelijke bestandsshare waarvan een back-up is gemaakt. Als u de naam of beschrijvende naam van uw container wilt ophalen, gebruikt u de opdracht az backup container list .
• --item-name: de naam van de back-up van de oorspronkelijke bestandsshare die u wilt gebruiken voor de herstelbewerking. Als u de naam of beschrijvende naam van uw back-upitem wilt ophalen, gebruikt u de opdracht az backup item list .

Geef de volgende parameters op voor de items die u wilt herstellen:

• SourceFilePath: het absolute pad van het bestand, dat als tekenreeks moet worden hersteld binnen de bestandsshare. Dit pad is hetzelfde pad dat wordt gebruikt in de az storage file download of az storage file show CLI-opdrachten.
• SourceFileType: Kies of een map of bestand is geselecteerd. Accepteert map of bestand.
• ResolveConflict: Instructie als er een conflict is met de herstelde gegevens. Accepteert overschrijven of overslaan.

Afzonderlijke bestanden of mappen herstellen naar de oorspronkelijke locatie

Gebruik de cmdlet az backup restore restore-azurefiles met de herstelmodus ingesteld op originallocation om specifieke bestanden of mappen te herstellen naar de oorspronkelijke locatie.

In het volgende voorbeeld wordt het RestoreTest.txt-bestand hersteld op de oorspronkelijke locatie: de azurefiles-bestandsshare .

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

Het kenmerk Naam in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw herstelbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.

Afzonderlijke bestanden of mappen herstellen naar een alternatieve locatie

Als u specifieke bestanden of mappen wilt herstellen naar een alternatieve locatie, gebruikt u de cmdlet az backup restore restore-azurefiles met de herstelmodus ingesteld op alternatelocation en geeft u de volgende doelparameters op:

• --target-storage-account: het opslagaccount waarnaar de back-upinhoud wordt hersteld. Het doelopslagaccount moet zich op dezelfde locatie bevinden als de kluis.
• --target-file-share: de bestandsshare in het doelopslagaccount waarnaar de back-upinhoud wordt hersteld.
• --target-folder: de map onder de bestandsshare waarnaar gegevens worden hersteld. Als de back-upinhoud moet worden hersteld naar een hoofdmap, geeft u de waarde van de doelmap op als een lege tekenreeks.

In het volgende voorbeeld wordt het RestoreTest.txt bestand dat oorspronkelijk aanwezig is in de azurefiles-bestandsshare hersteld naar een alternatieve locatie: de map restoredata in de azurefiles1-bestandsshare die wordt gehost in het afaccount1-opslagaccount .

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

Het kenmerk Naam in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw herstelbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.

Meerdere bestanden of mappen herstellen naar de oorspronkelijke of alternatieve locatie

Als u herstel wilt uitvoeren voor meerdere items, geeft u de waarde voor de parameter source-file-path door als door spaties gescheiden paden van alle bestanden of mappen die u wilt herstellen.

In het volgende voorbeeld worden de Restore.txt - en AFS-tests hersteld Report.docx bestanden op de oorspronkelijke locatie.

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

De uitvoer lijkt op de volgende:

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

Het kenmerk Naam in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw herstelbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.

Als u meerdere items naar een alternatieve locatie wilt herstellen, gebruikt u de bovenstaande opdracht door doelparameters op te geven, zoals wordt uitgelegd in de sectie Afzonderlijke bestanden of mappen herstellen naar een alternatieve locatie .

Volgende stappen

Meer informatie over het beheren van back-ups van Azure-bestandsshares met de Azure CLI.