Restaurer Azure Files avec Azure CLI

L’interface de ligne de commande Azure permet de gérer les ressources Azure. Elle constitue un excellent outil pour générer une automatisation personnalisée afin d'utiliser des ressources Azure. Cet article explique comment restaurer un partage de fichiers entier ou des fichiers spécifiques à partir d’un point de restauration créé par Sauvegarde Azure à l’aide d’Azure CLI. Vous pouvez également restaurer Azure Files à l’aide du portail Azure, d’Azure PowerShell, de l’API REST.

À la fin de cet article, vous allez apprendre à effectuer les opérations suivantes avec Azure CLI :

Affichez les points de restauration d’un fichier Azure Files sauvegardé.
Restaurez un fichier Azure Files complet.
restaurer des fichiers ou dossiers individuels ;

Remarque

La restauration d’Azure Files est prise en charge uniquement dans le même abonnement lors de l’utilisation de PowerShell ou de l’interface CLI.
Sauvegarde Azure prend désormais en charge la restauration de plusieurs fichiers ou dossiers vers l’emplacement d’origine ou d’un autre emplacement à l’aide d’Azure CLI. Pour plus d’informations, reportez-vous à la section Restaurer plusieurs fichiers ou dossiers à l’emplacement d’origine ou d’autre emplacement de ce document.

Conditions préalables

Cet article part du principe que vous disposez déjà d’un fichier Azure sauvegardé par Sauvegarde Azure. Si vous n’en avez pas, consultez Sauvegarder Azure Files avec l’interface CLI pour configurer la sauvegarde de votre partage de fichiers. Pour cet article, vous allez utiliser les ressources suivantes :

Partage de fichiers	Compte de stockage	Région	Détails
`azurefiles`	afsaccount	EastUS	Source d’origine sauvegardée à l’aide de sauvegarde Azure
azurefiles1	afaccount1	EastUS	Source de destination utilisée pour la récupération d’emplacement secondaire

Vous pouvez utiliser une structure similaire pour vos partages de fichiers afin d’essayer les différents types de restaurations expliqués dans cet article.

Préparation de votre environnement pour Azure CLI

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.
Si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser et gérer des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Ce tutoriel nécessite la version 2.0.18 ou ultérieure d’Azure CLI. Si vous utilisez Azure Cloud Shell, la dernière version est déjà installée.

Récupérer des points de récupération pour Azure Files

Utilisez l’applet az backup recoverypoint list de commande pour répertorier tous les points de récupération du partage de fichiers sauvegardé.

L’exemple suivant extrait la liste des points de récupération pour le azurefiles partage de fichiers dans le compte de stockage 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

Vous pouvez également exécuter l’applet de commande précédente à l’aide du nom convivial du conteneur et de l’élément en fournissant les deux paramètres supplémentaires suivants :

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

Le jeu de résultats est une liste de points de récupération avec des détails de temps et de cohérence pour chaque point de restauration.

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

L’attribut Name dans la sortie correspond au nom du point de récupération qui peut être utilisé comme valeur pour le paramètre --rp-name dans les opérations de récupération.

Vous pouvez utiliser cette option de restauration pour restaurer le partage de fichiers complet dans l’emplacement d’origine ou un autre emplacement.

Définissez les paramètres suivants pour effectuer des opérations de restauration :

--container-name : nom du compte de stockage qui héberge le partage de fichiers d’origine sauvegardé. Pour récupérer le nom ou le nom convivial de votre conteneur, utilisez la commande az backup container list .
--item-name : nom du partage de fichiers d’origine sauvegardé que vous souhaitez utiliser pour l’opération de restauration. Pour récupérer le nom ou le nom convivial de votre élément sauvegardé, utilisez la commande az backup item list .

Lorsque vous effectuez une restauration à un emplacement d’origine, vous n’avez pas besoin de spécifier les paramètres liés à la cible. Seul Résoudre le conflit doit être fourni.

L’exemple suivant utilise la cmdlet az backup restore restore-azurefileshare avec le mode de restauration défini sur originallocation pour restaurer le partage de fichiers azurefiles à l’emplacement d’origine. Vous utilisez le point de récupération 932883129628959823, que vous avez obtenu dans les points de récupération Fetch pour 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

L’attribut Name dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de restauration. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.

Vous pouvez utiliser cette option pour restaurer un partage de fichiers à un autre emplacement et conserver le partage de fichiers d’origine tel quel. Spécifiez les paramètres suivants pour la récupération dans un autre emplacement :

--target-storage-account : compte de stockage sur lequel le contenu sauvegardé est restauré. Le compte de stockage cible doit se trouver au même emplacement que le coffre.
--target-file-share : partage de fichiers dans le compte de stockage cible sur lequel le contenu sauvegardé est restauré.
--target-folder : dossier sous le partage de fichiers sur lequel les données sont restaurées. Si le contenu sauvegardé doit être restauré dans le dossier racine, indiquez les valeurs du dossier cible sous forme de chaîne vide.
--resolve-conflict : instruction s’il existe un conflit avec les données restaurées. Accepte Remplacer ou Ignorer.

L’exemple suivant utilise az backup restore restore-azurefileshare avec le mode de restauration en tant que alternatelocation pour restaurer le Partage de fichiers azurefiles dans le compte de stockage afsaccount vers le Partage de fichiers azurefiles1" dans le compte de stockage 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

Récupération au niveau de l'élément

Vous pouvez utiliser cette option de restauration pour restaurer des fichiers ou dossiers individuels à l’emplacement d’origine ou dans un autre emplacement.

Définissez les paramètres suivants pour effectuer des opérations de restauration :

--container-name : nom du compte de stockage qui héberge le partage de fichiers d’origine sauvegardé. Pour récupérer le nom ou le nom convivial de votre conteneur, utilisez la commande az backup container list .
--item-name : nom du partage de fichiers d’origine sauvegardé que vous souhaitez utiliser pour l’opération de restauration. Pour récupérer le nom ou le nom convivial de votre élément sauvegardé, utilisez la commande az backup item list .

Spécifiez les paramètres suivants pour les éléments à récupérer :

SourceFilePath : chemin absolu du fichier, à restaurer dans le partage de fichiers, sous forme de chaîne. Ce chemin est le même chemin d’accès que celui utilisé dans les commandes az storage file download ou az storage file show CLI.
SourceFileType : choisissez si un répertoire ou un fichier est sélectionné. Accepte Répertoire ou Fichier.
ResolveConflict : Instruction en cas de conflit avec les données restaurées. Accepte Remplacer ou Ignorer.

Restaurer des fichiers ou dossiers individuels à l’emplacement d’origine

Utilisez l'applet de commande az backup restore restore-azurefiles avec le mode de restauration originallocation pour restaurer des fichiers ou dossiers spécifiques à leur emplacement d'origine.

L’exemple suivant restaure le fichier RestoreTest.txt à son emplacement d’origine : le azurefiles partage de fichiers.

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

Restaurer des fichiers ou dossiers individuels à un autre emplacement

Pour restaurer des fichiers ou des dossiers spécifiques à un autre emplacement, utilisez le cmdlet avec le mode de restauration défini sur az backup restore restore-azurefiles et spécifiez les paramètres suivants liés à la cible alternatelocation.

--target-storage-account : compte de stockage sur lequel le contenu sauvegardé est restauré. Le compte de stockage cible doit se trouver au même emplacement que le coffre.
--target-file-share : partage de fichiers dans le compte de stockage cible sur lequel le contenu sauvegardé est restauré.
--target-folder : dossier sous le partage de fichiers sur lequel les données sont restaurées. Si le contenu sauvegardé doit être restauré dans un dossier racine, attribuez la valeur du dossier cible sous forme de chaîne vide.

L’exemple suivant restaure le fichier RestoreTest.txt initialement présent dans le azurefiles partage de fichiers à un autre emplacement : le restoredata dossier du partage de fichiers azurefiles1 hébergé dans le compte de stockage 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

Restaurer plusieurs fichiers ou dossiers à l'emplacement d'origine ou à un autre emplacement

Pour effectuer une restauration pour plusieurs éléments, transmettez la valeur du paramètre source-file-path en tant que chemins d’accès séparés par espace de tous les fichiers ou dossiers que vous souhaitez restaurer.

L’exemple suivant restaure les fichiersRestore.txt et AFS test Report.docx dans leur emplacement d’origine.

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

Vous devez obtenir un résultat semblable à ce qui suit :

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

Si vous souhaitez restaurer plusieurs éléments à un autre emplacement, utilisez la commande ci-dessus en spécifiant les paramètres liés à la cible, comme expliqué dans la section Restaurer des fichiers ou dossiers individuels dans une autre section d’emplacement .

Étapes suivantes

Gérez les sauvegardes Azure Files à l’aide du portail Azure, d’Azure PowerShell, d’Azure CLI, de l’API REST.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-06-10

Partager via