Démarrage rapide : Créer et utiliser un partage de fichiers Azure SMB

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Option	Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure.

Pour utiliser Azure Cloud Shell :

1. Démarrez Cloud Shell.

2. Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.

3. Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.

4. Sélectionnez Entrer pour exécuter le code ou la commande.

Si vous souhaitez installer et utiliser PowerShell localement, vous avez besoin du module Az Azure PowerShell version 7.0.0 ou ultérieure. Nous vous recommandons d’installer la dernière version disponible. Pour connaître la version du module Azure PowerShell que vous exécutez, utilisez la commande Get-InstalledModule Az. Si vous devez effectuer une mise à niveau, consultez Installer le module Azure PowerShell. Si vous exécutez PowerShell en local, vous devez également exécuter Login-AzAccount pour vous connecter à votre compte Azure. Pour utiliser l’authentification multifacteur, vous devez fournir votre ID de locataire Azure, par exemple, Login-AzAccount -TenantId <TenantId>.

Prérequis

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface 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 finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec 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 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.

• Cet article nécessite la version 2.0.4 ou ultérieure de l’interface Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.

• Par défaut, les commandes Azure CLI retournent JSON (JavaScript Object Notation), qui est le moyen standard d’envoyer et de recevoir des messages à partir d’API REST. Pour simplifier l’utilisation des réponses JSON, quelques exemples dans cet article utilisent le paramètre query sur des commandes d’Azure CLI. Ce paramètre utilise le langage de requête JMESPath pour analyser JSON. Pour en savoir plus sur l’utilisation des résultats des commandes d’Azure CLI en suivant le langage de requête JMESPath, consultez le didacticiel JMESPath.

Un compte de stockage est un pool partagé de stockage dans lequel vous pouvez déployer un partage de fichiers Azure, ou d’autres ressources de stockage comme les objets blob ou les files d’attente. Un compte de stockage peut contenir un nombre illimité de partages. Un partage peut stocker un nombre illimité de fichiers, dans les limites de capacité du compte de stockage.

Pour créer un compte de stockage à l’aide du portail Azure :

1. Sous Services Azure, sélectionnez Comptes de stockage.

2. Sélectionnez + Créer pour créer un compte de stockage.

3. Sous Détails du projet, sélectionnez l’abonnement Azure dans lequel créer le compte de stockage. Si vous n’avez qu’un abonnement, il est proposé par défaut.

4. Si vous souhaitez créer un groupe de ressources, sélectionnez Créer et entrez un nom tel que myexamplegroup.

5. Sous Détails de l’instance, fournissez un nom pour le compte de stockage. Vous devrez peut-être ajouter quelques chiffres aléatoires pour en faire un nom global unique. Un nom de compte de stockage doit être composé uniquement de lettres minuscules et de chiffres, et compter de 3 à 24 caractères. Notez le nom de votre compte de stockage. Vous le réutiliserez ultérieurement.

6. Dans Région, sélectionnez la région dans laquelle vous souhaitez créer votre compte de stockage.

7. Dans Service principal, sélectionnez Azure Files.

8. Dans Performances, conservez la valeur par défaut (Standard).

9. Dans Redondance, sélectionnez Stockage localement redondant (LRS).

   

10. Sélectionnez Vérifier + créer pour passer en revue vos paramètres. Azure exécutera une validation finale.

11. Une fois la validation terminée, sélectionnez Créer. Un message de notification doit s’afficher et indiquer que le déploiement est en cours.

12. Lorsque vous voyez une notification indiquant que votre déploiement est terminé, sélectionnez Accéder à la ressource.

PowerShell – Créer un groupe de ressources

Un groupe de ressources est un conteneur logique dans lequel les ressources Azure sont déployées et gérées. Si vous n’avez pas encore de groupe de ressources Azure, créez-en un avec la cmdlet New-AzResourceGroup. Vous avez besoin d’un groupe de ressources pour créer un compte de stockage.

L’exemple suivant crée un groupe de ressources nommé myResourceGroup dans la région USA Ouest 2 :

$resourceGroupName = "myResourceGroup"
$region = "westus2"

New-AzResourceGroup `
    -Name $resourceGroupName `
    -Location $region | Out-Null

PowerShell – Créer un compte de stockage

Un compte de stockage est un pool partagé de stockage que vous pouvez utiliser pour déployer des partages de fichiers Azure.

Cet exemple crée un compte de stockage à l’aide de l’applet de commande New-AzStorageAccount. Le compte de stockage est nommé mystorageaccount<nombre aléatoire> et une référence à ce compte de stockage est stockée dans la variable $storageAcct. Les noms de compte de stockage doivent être uniques. Par conséquent, utilisez Get-Random pour ajouter un nombre aléatoire au nom afin de le rendre unique.

$storageAccountName = "mystorageacct$(Get-Random)"

$storageAcct = New-AzStorageAccount `
    -ResourceGroupName $resourceGroupName `
    -Name $storageAccountName `
    -Location $region `
    -Kind StorageV2 `
    -SkuName Standard_LRS `
    -EnableLargeFileShare

CLI – Créer un groupe de ressources

Un groupe de ressources est un conteneur logique dans lequel les ressources Azure sont déployées et gérées. Si vous n’avez pas déjà un groupe de ressources Azure, vous pouvez utiliser la commande az group create pour en créer un. Vous avez besoin d’un groupe de ressources pour créer un compte de stockage.

L’exemple suivant crée un groupe de ressources nommé myResourceGroup à l’emplacement USA Ouest 2 :

export resourceGroupName="myResourceGroup"
region="westus2"

az group create \
    --name $resourceGroupName \
    --location $region \
    --output none

CLI – Créer un compte de stockage

Un compte de stockage est un pool partagé de stockage dans lequel vous pouvez déployer des partages de fichiers Azure.

L’exemple suivant crée un compte de stockage à l’aide de la commande az storage account create. Les noms de compte de stockage doivent être uniques. Par conséquent, utilisez $RANDOM pour ajouter un nombre aléatoire au nom afin de le rendre unique.

export storageAccountName="mystorageacct$RANDOM"

az storage account create \
    --resource-group $resourceGroupName \
    --name $storageAccountName \
    --location $region \
    --kind StorageV2 \
    --sku Standard_LRS \
    --enable-large-file-share \
    --output none

Pour créer un partage de fichiers Azure :

1. Sélectionnez le compte de stockage dans votre tableau de bord.

2. Dans le menu du service, sous Stockage de données, sélectionnez Partages de fichiers.

   

3. Dans le menu situé en haut de la page Partage de fichiers, sélectionnez + Partage de fichiers. La page Nouveau partage de fichier s’affiche.

4. Dans Nom, saisissez myshare. Les noms de partages de fichiers doivent être tous des lettres minuscules, des chiffres et des traits d’union simples, et doivent commencer et se terminer par une lettre minuscule ou un nombre. Le nom ne peut pas contenir deux traits d’union consécutifs. Pour des informations sur la façon de nommer des partages de fichiers et des fichiers, consultez la rubrique Affectation de noms et références aux partages, répertoires, fichiers et métadonnées.

5. Laissez l’option Transaction optimisée sélectionnée pour Niveau d’accès.

6. Sélectionnez l’onglet Sauvegarde. Par défaut, la sauvegarde est activée lorsque vous créez un partage de fichiers Azure via le portail Microsoft Azure. Si vous souhaitez désactiver la sauvegarde du partage de fichiers, décochez la case Activer la sauvegarde. Si vous souhaitez que la sauvegarde soit activée, vous pouvez conserver les valeurs par défaut ou créer un coffre Recovery Services dans la même région et le même abonnement que le compte de stockage. Pour créer une stratégie de sauvegarde, sélectionnez Créer une stratégie.

   

7. Sélectionnez Vérifier + créer, puis Créer pour créer le partage de fichiers Azure.

Maintenant que vous avez créé un compte de stockage, vous pouvez créer votre premier partage de fichiers Azure à l’aide de la cmdlet New-AzRmStorageShare. Cet exemple crée un partage nommé myshare avec un quota de 1024 Gio. Le quota peut être de 100 Tio au maximum.

$shareName = "myshare"

New-AzRmStorageShare `
    -StorageAccount $storageAcct `
    -Name $shareName `
    -EnabledProtocol SMB `
    -QuotaGiB 1024 | Out-Null

Maintenant que vous avez créé un compte de stockage, vous pouvez créer votre premier partage de fichiers Azure à l’aide de la cmdlet az storage share-rm create. Cet exemple crée un partage nommé myshare avec un quota de 1024 Gio. Le quota peut être de 100 Tio au maximum.

shareName="myshare"

az storage share-rm create \
    --resource-group $resourceGroupName \
    --storage-account $storageAccountName \
    --name $shareName \
    --quota 1024 \
    --enabled-protocols SMB \
    --output none

Pour créer un répertoire nommé myDirectory à la racine de votre partage de fichiers Azure :

1. Dans la page Paramètres de partage de fichiers, sélectionnez le partage de fichiers myshare. La page de votre partage de fichiers s’ouvre, indiquant qu’aucun fichier n’a été trouvé.
2. Dans le menu situé en haut de la page, sélectionnez + Ajouter un répertoire. La page Nouveau répertoire s’affiche.
3. Saisissez myDirectory et sélectionnez OK.

Pour créer un répertoire nommé myDirectory à la racine de votre partage de fichiers Azure, utilisez l’applet de commande New-AzStorageDirectory.

New-AzStorageDirectory `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Path "myDirectory"

Pour créer un répertoire nommé myDirectory à la racine de votre partage de fichiers Azure, exécutez la commande az storage directory create :

az storage directory create \
   --account-name $storageAccountName \
   --share-name $shareName \
   --name "myDirectory" \
   --output none

Tout d’abord, vous devez créer ou sélectionner un fichier à charger. Vous pouvez le faire selon la méthode de votre choix. Une fois que vous avez choisi le fichier que vous souhaitez charger, procédez comme suit :

1. Sélectionnez le répertoire myDirectory. Le volet myDirectory s’ouvre.

2. Dans le menu supérieur, sélectionnez Charger. Le panneau Télécharger des fichiers s’ouvre.

   

3. Sélectionnez l’icône de dossier pour ouvrir une fenêtre permettant de parcourir vos fichiers locaux.

4. Sélectionnez un fichier, puis sélectionnez Ouvrir.

5. Dans la page Charger des fichiers, vérifiez le nom du fichier, puis sélectionnez Charger.

6. Une fois terminé, le fichier apparaît dans la liste sur la page myDirectory.

Pour montrer comment charger un fichier avec l’applet de commande Set-AzStorageFileContent, nous devons d’abord créer un fichier dans le disque de travail de PowerShell Cloud Shell à charger.

Cet exemple place la date et l’heure actuelles dans un nouveau fichier sur votre disque de travail, puis charge le fichier vers le partage de fichiers.

# this expression will put the current date and time into a new file on your scratch drive
cd "~/CloudDrive/"
Get-Date | Out-File -FilePath "SampleUpload.txt" -Force

# this expression will upload that newly created file to your Azure file share
Set-AzStorageFileContent `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Source "SampleUpload.txt" `
   -Path "myDirectory\SampleUpload.txt"

Si vous exécutez PowerShell en local, remplacez ~/CloudDrive/ par un chemin existant sur votre machine.

Après avoir chargé le fichier, vous pouvez exécuter la cmdlet Get-AzStorageFile pour vérifier que le fichier a bien été chargé dans votre partage de fichiers Azure.

Get-AzStorageFile `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\" | Get-AzStorageFile

Pour illustrer comment charger un fichier à l’aide de la commande az storage file upload, créez d’abord un fichier à charger sur le lecteur de travail de Cloud Shell. Dans l’exemple suivant, vous créez puis chargez le fichier :

cd ~/clouddrive/
date > SampleUpload.txt

az storage file upload \
    --account-name $storageAccountName \
    --share-name $shareName \
    --source "SampleUpload.txt" \
    --path "myDirectory/SampleUpload.txt"

Si vous exécutez Azure CLI en local, remplacez ~/clouddrive par un chemin existant sur votre machine.

Après avoir chargé le fichier, vous pouvez exécuter la commande az storage file list pour vérifier que le fichier a bien été chargé dans votre partage de fichiers Azure :

az storage file list \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory" \
    --output table

Vous pouvez télécharger une copie du fichier que vous avez chargé en cliquant sur celui-ci avec le bouton droit, puis en sélectionnant Télécharger. L’expérience exacte dépendra du système d’exploitation et du navigateur que vous utilisez.

Vous pouvez utiliser l’applet de commande Get-AzStorageFileContent pour télécharger une copie du fichier que vous avez chargé sur le disque de travail de Cloud Shell.

# Delete an existing file by the same name as SampleDownload.txt, if it exists because you've run this example before.
Remove-Item `
    -Path "SampleDownload.txt" `
    -Force `
    -ErrorAction SilentlyContinue

Get-AzStorageFileContent `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\SampleUpload.txt" `
    -Destination "SampleDownload.txt"

Une fois le fichier téléchargé, vous pouvez utiliser la cmdlet Get-ChildItem pour voir si le fichier a été téléchargé sur votre disque de travail PowerShell Cloud Shell.

Get-ChildItem | Where-Object { $_.Name -eq "SampleDownload.txt" }

Vous pouvez exécuter la commande az storage file download pour télécharger une copie du fichier chargé sur le disque de travail de Cloud Shell :

# Delete an existing file by the same name as SampleDownload.txt, if it exists, because you've run this example before
rm -f SampleDownload.txt

az storage file download \
    --account-name $storageAccountName \
    --share-name $shareName \
    --path "myDirectory/SampleUpload.txt" \
    --dest "./SampleDownload.txt" \
    --output none

Lorsque vous avez terminé, supprimez le groupe de ressources. La suppression du groupe de ressources supprime aussi le compte de stockage, le partage de fichiers Azure et toutes autres ressources déployées dans le groupe de ressources.

Si des verrous existent pour le compte de stockage, vous devez d’abord les supprimer. Accédez au compte de stockage, puis sélectionnez Paramètres>Verrous. Si des verrous sont répertoriés, supprimez-les.

Vous allez peut-être également devoir supprimer le coffre Recovery Services de la sauvegarde Azure, avant d’être autorisé à supprimer le groupe de ressources.

1. Sélectionnez Accueil, puis Groupes de ressources.
2. Recherchez le groupe de ressources à supprimer.
3. Sélectionnez Supprimer le groupe de ressources. Une fenêtre s’ouvre et affiche un avertissement concernant les ressources qui seront supprimées avec le groupe de ressources.
4. Entrez le nom du groupe de ressources, puis sélectionnez Supprimer.

Une fois que vous avez terminé, vous pouvez utiliser la cmdlet Remove-AzResourceGroup pour supprimer le groupe de ressources et toutes les ressources contenues dans le groupe de ressources.

Remove-AzResourceGroup -Name myResourceGroup

Une fois que vous avez terminé, vous pouvez utiliser la commande az group delete pour supprimer le groupe de ressources et toutes les ressources contenues dans le groupe de ressources :

az group delete --name $resourceGroupName