Back-ups van Azure-bestandsshares beheren met de Azure CLI
De Azure CLI biedt een opdrachtregel 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 taken uitvoert voor het beheren en bewaken van de Azure-bestandsshares waarvan een back-up wordt gemaakt door Azure Backup. U kunt deze stappen ook uitvoeren met de Azure Portal.
Vereisten
In dit artikel wordt ervan uitgegaan dat u al een back-up hebt gemaakt van een Azure-bestandsshare door Azure Backup. Als u nog geen back-up hebt, raadpleegt u Back-ups maken van Azure-bestandsshares met de CLI om back-ups voor uw bestandsshares te configureren. Voor dit artikel gebruikt u de volgende resources:
- Resourcegroep: azurefiles
- RecoveryServicesVault: azurefilesvault
- Opslagaccount: afsaccount
- Bestandsshare: azurefiles
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.
Taken controleren
Wanneer u back-up- of herstelbewerkingen activeert, maakt de back-upservice een taak voor tracering. Gebruik de cmdlet az backup job list om voltooide of actieve taken te controleren. Met de CLI kunt u ook een actieve taak onderbreken of wachten totdat een taak is voltooid.
In het volgende voorbeeld ziet u de status van back-uptaken voor de azurefilesvault Recovery Services-kluis:
az backup job list --resource-group azurefiles --vault-name azurefilesvault
[
{
"eTag": null,
"id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/d477dfb6-b292-4f24-bb43-6b14e9d06ab5",
"location": null,
"name": "d477dfb6-b292-4f24-bb43-6b14e9d06ab5",
"properties": {
"actionsInfo": null,
"activityId": "3cef43ed-0af4-43e2-b9cb-1322c496ccb4",
"backupManagementType": "AzureStorage",
"duration": "0:00:29.718011",
"endTime": "2020-01-13T08:05:29.180606+00:00",
"entityFriendlyName": "azurefiles",
"errorDetails": null,
"extendedInfo": null,
"jobType": "AzureStorageJob",
"operation": "Backup",
"startTime": "2020-01-13T08:04:59.462595+00:00",
"status": "Completed",
"storageAccountName": "afsaccount",
"storageAccountVersion": "MicrosoftStorage"
},
"resourceGroup": "azurefiles",
"tags": null,
"type": "Microsoft.RecoveryServices/vaults/backupJobs"
},
{
"eTag": null,
"id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/1b9399bf-c23c-4caa-933a-5fc2bf884519",
"location": null,
"name": "1b9399bf-c23c-4caa-933a-5fc2bf884519",
"properties": {
"actionsInfo": null,
"activityId": "2663449c-94f1-4735-aaf9-5bb991e7e00c",
"backupManagementType": "AzureStorage",
"duration": "0:00:28.145216",
"endTime": "2020-01-13T08:05:27.519826+00:00",
"entityFriendlyName": "azurefilesresource",
"errorDetails": null,
"extendedInfo": null,
"jobType": "AzureStorageJob",
"operation": "Backup",
"startTime": "2020-01-13T08:04:59.374610+00:00",
"status": "Completed",
"storageAccountName": "afsaccount",
"storageAccountVersion": "MicrosoftStorage"
},
"resourceGroup": "azurefiles",
"tags": null,
"type": "Microsoft.RecoveryServices/vaults/backupJobs"
}
]
Beleid maken
U kunt een back-upbeleid maken door de opdracht az backup policy create uit te voeren met de volgende parameters:
- --backup-management-type – Azure Storage
- --workload-type - AzureFileShare
- --name: naam van het beleid
- --policy - JSON-bestand met de juiste details voor planning en retentie
- --resource-group- Resourcegroep van de kluis
- --vault-name: naam van de kluis
Voorbeeld
az backup policy create --resource-group azurefiles --vault-name azurefilesvault --name schedule20 --backup-management-type AzureStorage --policy samplepolicy.json --workload-type AzureFileShare
Voorbeeld-JSON (samplepolicy.json)
{
"eTag": null,
"id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupPolicies/schedule20",
"location": null,
"name": "schedule20",
"properties": {
"backupManagementType": "AzureStorage",
"protectedItemsCount": 0,
"retentionPolicy": {
"dailySchedule": {
"retentionDuration": {
"count": 30,
"durationType": "Days"
},
"retentionTimes": [
"2020-01-05T08:00:00+00:00"
]
},
"monthlySchedule": null,
"retentionPolicyType": "LongTermRetentionPolicy",
"weeklySchedule": null,
"yearlySchedule": null
},
"schedulePolicy": {
"schedulePolicyType": "SimpleSchedulePolicy",
"scheduleRunDays": null,
"scheduleRunFrequency": "Daily",
"scheduleRunTimes": [
"2020-01-05T08:00:00+00:00"
],
"scheduleWeeklyFrequency": 0
},
"timeZone": "UTC",
"workLoadType": “AzureFileShare”
},
"resourceGroup": "azurefiles",
"tags": null,
"type": "Microsoft.RecoveryServices/vaults/backupPolicies"
}
Voorbeeld om een back-upbeleid te maken waarmee meerdere back-ups per dag worden geconfigureerd
Deze voorbeeld-JSON is voor de volgende vereisten:
- Planning: maak de komende 12 uurelke 4 uur vanaf 8:00 uur (UTC) een back-up.
- Retentie: dagelijks - 5 dagen, wekelijks - elke zondag gedurende 12 weken, maandelijks - eerste zondag van elke maand gedurende 60 maanden en jaarlijks - eerste zondag van januari gedurende 10 jaar.
{
"properties":{
"backupManagementType": "AzureStorage",
"workloadType": "AzureFileShare",
"schedulePolicy": {
"schedulePolicyType": "SimpleSchedulePolicy",
"scheduleRunFrequency": "Hourly",
"hourlySchedule": {
"interval": 4,
"scheduleWindowStartTime": "2021-09-29T08:00:00.000Z",
"scheduleWindowDuration": 12
}
},
"timeZone": "UTC",
"retentionPolicy": {
"retentionPolicyType": "LongTermRetentionPolicy",
"dailySchedule": {
"retentionTimes": null,
"retentionDuration": {
"count": 5,
"durationType": "Days"
}
},
"weeklySchedule": {
"daysOfTheWeek": [
"Sunday"
],
"retentionTimes": null,
"retentionDuration": {
"count": 12,
"durationType": "Weeks"
}
},
"monthlySchedule": {
"retentionScheduleFormatType": "Weekly",
"retentionScheduleDaily": null,
"retentionScheduleWeekly": {
"daysOfTheWeek": [
"Sunday"
],
"weeksOfTheMonth": [
"First"
]
},
"retentionTimes": null,
"retentionDuration": {
"count": 60,
"durationType": "Months"
}
},
"yearlySchedule": {
"retentionScheduleFormatType": "Weekly",
"monthsOfYear": [
"January"
],
"retentionScheduleDaily": null,
"retentionScheduleWeekly": {
"daysOfTheWeek": [
"Sunday"
],
"weeksOfTheMonth": [
"First"
]
},
"retentionTimes": null,
"retentionDuration": {
"count": 10,
"durationType": "Years"
}
}
}
}
}
Zodra het beleid is gemaakt, wordt in de uitvoer van de opdracht de beleids-JSON weergegeven die u hebt doorgegeven als een parameter tijdens het uitvoeren van de opdracht.
U kunt het schema en de retentiesectie van het beleid naar behoefte wijzigen.
Voorbeeld
Als u de back-up van de eerste zondag van elke maand twee maanden wilt bewaren, werkt u de maandelijkse planning bij zoals hieronder:
"monthlySchedule": {
"retentionDuration": {
"count": 2,
"durationType": "Months"
},
"retentionScheduleDaily": null,
"retentionScheduleFormatType": "Weekly",
"retentionScheduleWeekly": {
"daysOfTheWeek": [
"Sunday"
],
"weeksOfTheMonth": [
"First"
]
},
"retentionTimes": [
"2020-01-05T08:00:00+00:00"
]
}
Beleid wijzigen
U kunt een back-upbeleid wijzigen om de back-upfrequentie of het retentiebereik te wijzigen met behulp van az backup item set-policy.
Als u het beleid wilt wijzigen, definieert u de volgende parameters:
- --containernaam: de naam van het opslagaccount dat als host fungeert voor de bestandsshare. Gebruik de opdracht az backup container list om de naam of beschrijvende naam van uw container op te halen.
- --name: de naam van de bestandsshare waarvoor u het beleid wilt wijzigen. Als u de naam of beschrijvende naam van uw back-upitem wilt ophalen, gebruikt u de opdracht az backup item list .
- --policy-name: de naam van het back-upbeleid dat u wilt instellen voor uw bestandsshare. U kunt az backup policy list gebruiken om alle beleidsregels voor uw kluis weer te geven.
In het volgende voorbeeld wordt het back-upbeleid van schedule2 ingesteld voor de azurefiles-bestandsshare die aanwezig is in het afsaccount-opslagaccount .
az backup item set-policy --policy-name schedule2 --name azurefiles --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --name "AzureFileShare;azurefiles" --backup-management-type azurestorage --out table
U kunt de vorige opdracht ook uitvoeren met behulp van de beschrijvende namen voor de container en het item door de volgende twee extra parameters op te geven:
- --backup-management-type: azurestorage
- --workload-type: azurefileshare
az backup item set-policy --policy-name schedule2 --name azurefiles --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --name azurefiles --backup-management-type azurestorage --out table
Name ResourceGroup
------------------------------------ ---------------
fec6f004-0e35-407f-9928-10a163f123e5 azurefiles
Het kenmerk Name in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw wijzigingsbeleidsbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.
De beveiliging voor een bestandsshare stoppen
Er zijn twee manieren om het beveiligen van Azure-bestandsshares te stoppen:
- Stop alle toekomstige back-uptaken en verwijder alle herstelpunten.
- Stop alle toekomstige back-uptaken, maar laat de herstelpunten staan .
Er kunnen kosten verbonden zijn aan het bewaren van de herstelpunten in de opslag, omdat de onderliggende momentopnamen die door Azure Backup zijn gemaakt, worden bewaard. Het voordeel van het verlaten van de herstelpunten is de optie om de bestandsshare later te herstellen, als u dat wilt. Zie de prijsgegevens voor informatie over de kosten voor het verlaten van de herstelpunten. Als u ervoor kiest om alle herstelpunten te verwijderen, kunt u de bestandsshare niet herstellen.
Als u de beveiliging voor de bestandsshare wilt stoppen, definieert u de volgende parameters:
- --containernaam: de naam van het opslagaccount dat als host fungeert voor de bestandsshare. Gebruik de opdracht az backup container list om de naam of beschrijvende naam van uw container op te halen.
- --item-name: de naam van de bestandsshare waarvoor u de beveiliging wilt stoppen. Als u de naam of beschrijvende naam van uw back-upitem wilt ophalen, gebruikt u de opdracht az backup item list .
Beveiliging stoppen en herstelpunten behouden
Als u de beveiliging wilt stoppen terwijl gegevens worden bewaard, gebruikt u de cmdlet az backup protection disable .
In het volgende voorbeeld wordt de beveiliging voor de azurefiles-bestandsshare gestopt, maar worden alle herstelpunten behouden.
az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name “AzureFileShare;azurefiles” --out table
U kunt de vorige opdracht 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 protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --out table
Name ResourceGroup
------------------------------------ ---------------
fec6f004-0e35-407f-9928-10a163f123e5 azurefiles
Het kenmerk Name in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw stopbeveiligingsbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.
Beveiliging stoppen zonder herstelpunten te behouden
Als u de beveiliging wilt stoppen zonder herstelpunten te behouden, gebruikt u de cmdlet az backup protection disable met de optie delete-backup-data ingesteld op true.
In het volgende voorbeeld wordt de beveiliging voor de azurefiles-bestandsshare gestopt zonder herstelpunten te behouden.
az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name “AzureFileShare;azurefiles” --delete-backup-data true --out table
U kunt de vorige opdracht 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 protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --delete-backup-data true --out table
De beveiliging voor een bestandsshare hervatten
Als u de beveiliging voor een Azure-bestandsshare hebt gestopt, maar herstelpunten hebt behouden, kunt u de beveiliging later hervatten. Als u de herstelpunten niet behoudt, kunt u de beveiliging niet hervatten.
Als u de beveiliging voor de bestandsshare wilt hervatten, definieert u de volgende parameters:
- --containernaam: de naam van het opslagaccount dat als host fungeert voor de bestandsshare. Gebruik de opdracht az backup container list om de naam of beschrijvende naam van uw container op te halen.
- --item-name: de naam van de bestandsshare waarvoor u de beveiliging wilt hervatten. Als u de naam of beschrijvende naam van het back-upitem wilt ophalen, gebruikt u de opdracht az backup item list .
- --policy-name: de naam van het back-upbeleid waarvoor u de beveiliging voor de bestandsshare wilt hervatten.
In het volgende voorbeeld wordt de cmdlet az backup protection resume gebruikt om de beveiliging voor de azurefiles-bestandsshare te hervatten met behulp van het back-upbeleid schedule1 .
az backup protection resume --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount” --item-name “AzureFileShare;azurefiles” --policy-name schedule2 --out table
U kunt de vorige opdracht 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 protection resume --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --policy-name schedule2 --out table
Name ResourceGroup
------------------------------------ ---------------
75115ab0-43b0-4065-8698-55022a234b7f azurefiles
Het kenmerk Name in de uitvoer komt overeen met de naam van de taak die is gemaakt door de back-upservice voor uw hervattingsbeveiligingsbewerking. Gebruik de cmdlet az backup job show om de status van de taak bij te houden.
Registratie van opslagaccount ongedaan maken
Als u uw bestandsshares in een bepaald opslagaccount wilt beveiligen met behulp van een andere Recovery Services-kluis, stopt u eerst de beveiliging voor alle bestandsshares in dat opslagaccount. Hef vervolgens de registratie van het account op uit de Recovery Services-kluis die momenteel wordt gebruikt voor beveiliging.
U moet een containernaam opgeven om de registratie van het opslagaccount ongedaan te maken. Gebruik de opdracht az backup container list om de naam of de beschrijvende naam van uw container op te halen.
In het volgende voorbeeld wordt de registratie van het afsaccount storage-account bij azurefilesvault ongedaan gemaakt met behulp van de cmdlet az backup container unregister .
az backup container unregister --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --out table
U kunt de vorige cmdlet ook uitvoeren met behulp van de beschrijvende naam voor de container door de volgende extra parameter op te geven:
- --backup-management-type: azurestorage
az backup container unregister --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --out table
Volgende stappen
Zie Problemen met back-ups van Azure-bestandsshares oplossen voor meer informatie.
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor