Azure Files 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 Azure Files ook herstellen met behulp van Azure Portal, Azure PowerShell, REST API.

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

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

Notitie

• Herstellen van Azure Files wordt alleen ondersteund binnen hetzelfde abonnement wanneer u PowerShell of CLI gebruikt.
• 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.

Vereiste voorwaarden

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

Bestand delen	Opslagaccount	Regio	Bijzonderheden
azurefiles	afsaccount	Oost-VS	Back-up van de oorspronkelijke bron met behulp van Azure Backup
azurefiles1	afaccount1	Oost-VS	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.

Uw omgeving voorbereiden voor de Azure CLI

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met 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 uw terminal om het verificatieproces te voltooien. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Wanneer u hierom wordt gevraagd, installeert u de Azure CLI-extensie voor het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

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

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

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

In het volgende voorbeeld wordt de lijst met herstelpunten voor de azurefiles bestanden-share opgehaald vanuit het opslagaccount 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

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
• --workloadtype: 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.

Volledige herstelling van een 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 de vriendelijke naam van uw container wilt ophalen, kunt u de opdracht az backup container list gebruiken.
• --item-name: de naam van de oorspronkelijke bestandsshare waarvan u een back-up wilt maken voor de herstelbewerking. Als u de naam of vriendelijke naam van uw back-upitem wilt ophalen, kunt u de opdracht az backup item list gebruiken.

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 az backup restore restore-azurefileshare cmdlet gebruikt met de herstelmodus ingesteld om de originallocation bestandsshare op de oorspronkelijke locatie te herstellen. U gebruikt het herstelpunt 932883129628959823, dat u hebt verkregen in Herstelpunten ophalen voor De 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

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 gebruikt met herstelmodus alternatelocation 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 de vriendelijke naam van uw container wilt ophalen, kunt u de opdracht az backup container list gebruiken.
• --item-name: de naam van de oorspronkelijke bestandsshare waarvan u een back-up wilt maken voor de herstelbewerking. Als u de naam of vriendelijke naam van uw back-upitem wilt ophalen, kunt u de opdracht az backup item list gebruiken.

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

• SourceFilePath: het absolute pad van het bestand, dat moet worden hersteld in de bestandsshare, als een tekenreeks. 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 az backup restore restore-azurefiles cmdlet 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 waarvoor de az backup restore restore-azurefiles herstelmodus is ingesteld alternatelocation en geeft u de volgende doelgerelateerde parameters 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 in de azurefiles bestandsshare aanwezig is, hersteld naar een alternatieve locatie: de restoredata map 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 testing Report.docx bestanden op hun oorspronkelijke locatie hersteld.

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 ziet er ongeveer als volgt uit:

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

Azure Files-back-ups beheren met behulp van Azure Portal, Azure PowerShell, Azure CLI, REST API.