Utilisation d'Azure PowerShell avec Azure StorageUsing Azure PowerShell with Azure Storage

Azure PowerShell est utilisé pour créer et gérer des ressources Azure à partir de la ligne de commande PowerShell ou dans des scripts.Azure PowerShell is used to create and manage Azure resources from the PowerShell command line or in scripts. Pour le stockage Azure, ces applets de commande se répartissent en deux catégories : le plan de contrôle et le plan de données.For Azure Storage, these cmdlets fall into two categories -- the control plane and the data plane. Les applets de commande de plan de contrôle sont utilisées pour gérer le compte de stockage, c’est-à-dire pour créer des comptes de stockage, définir des propriétés, supprimer des comptes de stockage, modifier les clés d’accès et ainsi de suite.The control plane cmdlets are used to manage the storage account -- to create storage accounts, set properties, delete storage accounts, rotate the access keys, and so on. Les applets de commande de plan de données sont utilisées pour gérer les données stockées dans le compte de stockage.The data plane cmdlets are used to manage the data stored in the storage account. Par exemple, le téléchargement d’objets blob, la création de partages de fichiers et l’ajout de messages à une file d’attente.For example, uploading blobs, creating file shares, and adding messages to a queue.

Cet article couvre les opérations courantes utilisant les applets de commande de plan de gestion pour gérer les comptes de stockage.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Vous allez apprendre à effectuer les actions suivantes :You learn how to:

  • Répertorier les comptes de stockageList storage accounts
  • Obtenir une référence à un compte de stockage existantGet a reference to an existing storage account
  • Créez un compte de stockage.Create a storage account
  • Définir les propriétés du compte de stockageSet storage account properties
  • Récupérer et régénérer les clés d’accèsRetrieve and regenerate the access keys
  • Protéger l’accès à votre compte de stockageProtect access to your storage account
  • Activer l’analyse du stockageEnable Storage Analytics

Cet article fournit des liens vers plusieurs autres articles de PowerShell pour le stockage, notamment sur l’activation et l’accès à Storage Analytics, l’utilisation des applets de commande de plan de données et l’accès aux clouds indépendants Azure tels que le cloud de Chine, le cloud allemand et le cloud Azure Government.This article provides links to several other PowerShell articles for Storage, such as how to enable and access the Storage Analytics, how to use the data plane cmdlets, and how to access the Azure independent clouds such as China Cloud, German Cloud, and Government Cloud.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

Notes

Cet article a été mis à jour pour tenir compte de l’utilisation du nouveau module Az d’Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Vous pouvez toujours utiliser le module AzureRM, qui continue à recevoir des correctifs de bogues jusqu’à au moins décembre 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Pour en savoir plus sur le nouveau module Az et la compatibilité avec AzureRM, consultez Présentation du nouveau module Az d’Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pour des instructions d’installation du module Az, consultez Installer Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Cet exercice nécessite le module Az Azure PowerShell version 0.7 ou ultérieure.This exercise requires the Azure PowerShell module Az version 0.7 or later. Exécutez Get-Module -ListAvailable Az pour trouver la version.Run Get-Module -ListAvailable Az to find the version. Si vous devez installer ou mettre à niveau, consultez Installer le module Azure PowerShell.If you need to install or upgrade, see Install Azure PowerShell module.

Dans cet exercice, vous pouvez saisir les commandes dans une fenêtre PowerShell normale, ou utiliser l’Environnement d'écriture de scripts intégré de Windows PowerShell (ISE) et saisir les commandes dans un éditeur, puis tester une ou plusieurs commandes à la fois en parcourant les exemples.For this exercise, you can type the commands into a regular PowerShell window, or you can use the Windows PowerShell Integrated Scripting Environment (ISE) and type the commands into an editor, then test one or more commands at a time as you go through the examples. Vous pouvez mettre en surbrillance les lignes que vous souhaitez exécuter et cliquer sur Exécuter la sélection pour exécuter uniquement ces commandes.You can highlight the rows you want to execute and click Run Selected to just run those commands.

Pour plus d’informations sur les comptes de stockage, consultez la page Introduction au stockage et À propos des comptes de stockage Azure.For more information about storage accounts, see Introduction to Storage and About Azure storage accounts.

Connexion à AzureSign in to Azure

Connectez-vous à votre abonnement Azure avec la commande Connect-AzAccount et suivez les instructions à l’écran.Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

Connect-AzAccount

Répertorier les comptes de stockage de l’abonnementList the storage accounts in the subscription

Exécutez l’applet de commande Get-AzStorageAccount pour récupérer la liste des comptes de stockage dans l’abonnement actuel.Run the Get-AzStorageAccount cmdlet to retrieve the list of storage accounts in the current subscription.

Get-AzStorageAccount | Select StorageAccountName, Location

Obtenir une référence à un compte de stockageGet a reference to a storage account

Vous avez ensuite besoin d’une référence à un compte de stockage.Next, you need a reference to a storage account. Vous pouvez créer un nouveau compte de stockage ou obtenir une référence à un compte de stockage existant.You can either create a new storage account or get a reference to an existing storage account. La section suivante illustre les deux méthodes.The following section shows both methods.

Utiliser un compte de stockage existantUse an existing storage account

Pour récupérer un compte de stockage existant, vous avez besoin du nom du groupe de ressources et du nom du compte de stockage.To retrieve an existing storage account, you need the name of the resource group and the name of the storage account. Définissez les variables pour ces deux champs, puis utilisez l’applet de commande Get-AzStorageAccount.Set the variables for those two fields, then use the Get-AzStorageAccount cmdlet.

$resourceGroup = "myexistingresourcegroup"
$storageAccountName = "myexistingstorageaccount"

$storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroup `
  -Name $storageAccountName

Vous avez maintenant $storageAccount, qui pointe vers un compte de stockage existant.Now you have $storageAccount, which points to an existing storage account.

Créez un compte de stockage.Create a storage account

Le script suivant montre comment créer un compte de stockage universel à l’aide de New-AzStorageAccount.The following script shows how to create a general-purpose storage account using New-AzStorageAccount. Après avoir créé le compte, récupérez son contexte, qui peut être utilisé dans les commandes suivantes au lieu de spécifier l’authentification à chaque appel.After you create the account, retrieve its context, which can be used in subsequent commands rather than specifying the authentication with each call.

# Get list of locations and select one.
Get-AzLocation | select Location
$location = "eastus"

# Create a new resource group.
$resourceGroup = "teststoragerg"
New-AzResourceGroup -Name $resourceGroup -Location $location

# Set the name of the storage account and the SKU name.
$storageAccountName = "testpshstorage"
$skuName = "Standard_LRS"

# Create the storage account.
$storageAccount = New-AzStorageAccount -ResourceGroupName $resourceGroup `
  -Name $storageAccountName `
  -Location $location `
  -SkuName $skuName

# Retrieve the context.
$ctx = $storageAccount.Context

Le script utilise les applets de commande PowerShell suivantes :The script uses the following PowerShell cmdlets:

  • Get-AzLocation -- récupère la liste des emplacements valides.Get-AzLocation -- retrieves a list of the valid locations. L’exemple utilise eastus pour l’emplacement.The example uses eastus for location.

  • New-AzResourceGroup -- crée un groupe de ressources.New-AzResourceGroup -- creates a new resource group. Un groupe de ressources est un conteneur logique dans lequel vos ressources Azure sont déployées et gérées.A resource group is a logical container into which your Azure resources are deployed and managed. Nous avons appelé le nôtre teststoragerg.Ours is called teststoragerg.

  • New-AzStorageAccount -- crée le compte de stockage.New-AzStorageAccount -- creates the storage account. L’exemple utilise testpshstorage.The example uses testpshstorage.

Le nom de référence (SKU) indique le type de réplication pour le compte de stockage, comme LRS (stockage localement redondant).The SKU name indicates the type of replication for the storage account, such as LRS (Locally Redundant Storage). Pour en savoir plus, consultez Réplication de Stockage Azure.For more information about replication, see Azure Storage Replication.

Important

Le nom de votre compte de stockage doit être unique dans Azure et être en minuscules.The name of your storage account must be unique within Azure and must be lowercase. Pour connaître les conventions et restrictions relatives aux attributions de noms, consultez la page Affectation de noms et références aux conteneurs, objets BLOB et métadonnées.For naming conventions and restrictions, see Naming and Referencing Containers, Blobs, and Metadata.

Vous disposez maintenant d’un compte de stockage et d’une référence à celui-ci.Now you have a new storage account and a reference to it.

Gérer le compte de stockageManage the storage account

Maintenant que vous avez une référence à un compte de stockage ou un compte de stockage existant, la section suivante présente certaines des commandes que vous pouvez utiliser pour gérer votre compte de stockage.Now that you have a reference to a new storage account or an existing storage account, the following section shows some of the commands you can use to manage your storage account.

Propriétés du compte de stockageStorage account properties

Pour changer les paramètres d’un compte de stockage, utilisez Set-AzStorageAccount.To change the settings for a storage account, use Set-AzStorageAccount. Si vous ne pouvez pas modifier l’emplacement d’un compte de stockage, ou le groupe de ressources dans lequel il réside, vous pouvez modifier la plupart des autres propriétés.While you can't change the location of a storage account, or the resource group in which it resides, you can change many of the other properties. La liste suivante décrit certaines des propriétés que vous pouvez modifier à l’aide de PowerShell.The following lists some of the properties you can change using PowerShell.

  • Le domaine personnalisé affecté au compte de stockage.The custom domain assigned to the storage account.

  • Les balises affectées au compte de stockage.The tags assigned to the storage account. Les balises sont souvent utilisées pour catégoriser les ressources à des fins de facturation.Tags are often used to categorize resources for billing purposes.

  • Le nom de référence (SKU) est le paramètre de réplication pour le compte de stockage, comme LRS (stockage localement redondant).The SKU is the replication setting for the storage account, such as LRS for Locally Redundant Storage. Par exemple, vous pouvez passer de Standard_LRS à Standard_GRS ou Standard_RAGRS.For example, you might change from Standard_LRS to Standard_GRS or Standard_RAGRS. Notez que vous ne pouvez pas passer du stockage Standard_ZRS, Standard_GZRS, Standard_RAGZRS ou Premium_LRS à d’autres références (SKU), ou modifier d’autres références sur celles-ci.Note that you can't change Standard_ZRS, Standard_GZRS, Standard_RAGZRS, or Premium_LRS to other SKUs, or change other SKUs to these.

  • Le niveau d’accès pour les comptes de stockage d’objets blob.The access tier for Blob storage accounts. La valeur du niveau d’accès est définie sur chaud ou froid, et vous permet de réduire les coûts en sélectionnant le niveau d’accès qui s’aligne avec l’utilisation du compte de stockage.The value for access tier is set to hot or cool, and allows you to minimize your cost by selecting the access tier that aligns with how you use the storage account. Pour plus d’informations, consultez Niveaux de stockage chauds et froid et d’archivage.For more information, see Hot, cool, and archive storage tiers.

  • Autorisez uniquement le trafic HTTPS.Only allow HTTPS traffic.

Gérer les clés d’accèsManage the access keys

Un compte Azure Storage est fourni avec deux clés de compte.An Azure Storage account comes with two account keys. Pour récupérer les clés, utilisez Get-AzStorageAccountKey.To retrieve the keys, use Get-AzStorageAccountKey. Cet exemple récupère la première clé.This example retrieves the first key. Pour récupérer l’autre, utilisez Value[1] au lieu de Value[0].To retrieve the other one, use Value[1] instead of Value[0].

$storageAccountKey = `
    (Get-AzStorageAccountKey `
    -ResourceGroupName $resourceGroup `
    -Name $storageAccountName).Value[0]

Pour regénérer la clé, utilisez New-AzStorageAccountKey.To regenerate the key, use New-AzStorageAccountKey.

New-AzStorageAccountKey -ResourceGroupName $resourceGroup `
  -Name $storageAccountName `
  -KeyName key1

Pour régénérer l’autre clé, utilisez key2 comme nom de clé à la place de key1.To regenerate the other key, use key2 as the key name instead of key1.

Régénérez un de vos clés, puis récupérez-la à nouveau pour voir la nouvelle valeur.Regenerate one of your keys and then retrieve it again to see the new value.

Notes

Vous devez planifier soigneusement la régénération de la clé pour un compte de stockage de production.You should perform careful planning before regenerating the key for a production storage account. La régénération d’une ou des deux clés invalidera l’accès pour n’importe quelle application utilisant la clé qui a été régénérée.Regenerating one or both keys will invalidate the access for any application using the key that was regenerated. Pour plus d’informations, consultez l’article Clés d’accès.For more information, see Access keys.

Suppression d'un compte de stockageDelete a storage account

Pour supprimer un compte de stockage, utilisez Remove-AzStorageAccount.To delete a storage account, use Remove-AzStorageAccount.

Remove-AzStorageAccount -ResourceGroup $resourceGroup -AccountName $storageAccountName

Important

Lorsque vous supprimez un compte de stockage, toutes les ressources stockées dans le compte sont également supprimées.When you delete a storage account, all of the assets stored in the account are deleted as well. Si vous supprimez accidentellement un compte, appelez le Support immédiatement et ouvrez un ticket pour restaurer le compte de stockage.If you delete an account accidentally, call Support immediately and open a ticket to restore the storage account. La récupération de vos données n’est pas garantie, mais elle fonctionne parfois.Recovery of your data is not guaranteed, but it does sometimes work. Ne créez pas un compte de stockage portant le même nom que l’ancien tant que le ticket de support n’a pas été résolu.Do not create a new storage account with the same name as the old one until the support ticket has been resolved.

Protéger votre compte de stockage à l’aide de réseaux virtuels et de pare-feuProtect your storage account using VNets and firewalls

Par défaut, tous les comptes de stockage sont accessibles par n’importe quel réseau ayant accès à Internet.By default, all storage accounts are accessible by any network that has access to the internet. Toutefois, vous pouvez configurer des règles de réseau pour autoriser uniquement les applications de réseaux virtuels spécifiques à accéder à un compte de stockage.However, you can configure network rules to only allow applications from specific virtual networks to access a storage account. Pour plus d’informations, consultez Configurer Pare-feu et réseaux virtuels dans Stockage Azure.For more information, see Configure Azure Storage Firewalls and Virtual Networks.

L’article explique comment gérer ces paramètres à l’aide des applets de commande PowerShell suivantes :The article shows how to manage these settings using the following PowerShell cmdlets:

Utiliser l’analyse du stockageUse storage analytics

Azure Storage Analytics comprend les métriques d’analyse de stockage et la journalisation des analyses de stockage.Azure Storage Analytics consists of Storage Analytics Metrics and Storage Analytics Logging.

Les métriques d’analyse de stockage servent à collecter des mesures pour vos comptes de stockage Azure que vous pouvez utiliser pour surveiller l’intégrité d’un compte de stockage.Storage Analytics Metrics is used to collect metrics for your Azure storage accounts that you can use to monitor the health of a storage account. Les métriques peuvent être activées pour les objets Blob, les fichiers, les tables et les files d’attente.Metrics can be enabled for blobs, files, tables, and queues.

La journalisation de l’analyse du stockage se produit côté serveur. Elle vous permet d’enregistrer les détails des demandes ayant réussi et des demandes ayant échoué dans votre compte de stockage.Storage Analytics Logging happens server-side and enables you to record details for both successful and failed requests to your storage account. Ces journaux d’activité permettent d’afficher les détails des opérations de lecture, d’écriture et de suppression sur vos tables, vos files d’attente et vos objets blob, ainsi que la raison de l’échec de certaines demandes.These logs enable you to see details of read, write, and delete operations against your tables, queues, and blobs as well as the reasons for failed requests. La journalisation n’est pas disponible pour les fichiers Azure.Logging is not available for Azure Files.

Vous pouvez configurer la surveillance en utilisant le portail Azure ou PowerShell, ou par programmation en utilisant la bibliothèque cliente de stockage.You can configure monitoring using the Azure portal, PowerShell, or programmatically using the storage client library.

Notes

Vous pouvez activer l’analyse par minute à l’aide de PowerShell.You can enable minute analytics using PowerShell. Cette fonctionnalité n’est pas disponible dans le portail.This capability is not available in the portal.

Gérer les données dans le compte de stockageManage the data in the storage account

Maintenant que vous savez comment gérer votre compte de stockage avec PowerShell, consultez les articles suivants pour découvrir comment accéder aux objets de données dans le compte de stockage.Now that you understand how to manage your storage account with PowerShell, you can use the following articles to learn how to access the data objects in the storage account.

L’API Table Azure Cosmos DB fournit des fonctionnalités premium pour le stockage des tables, telles que la distribution globale clé en main, les opérations de lecture et d’écriture à faible latence, l’indexation secondaire automatique et un débit dédié.Azure Cosmos DB Table API provides premium features for table storage such as turnkey global distribution, low latency reads and writes, automatic secondary indexing, and dedicated throughput.

Déploiements de cloud indépendant d’AzureIndependent cloud deployments of Azure

La plupart des gens utilisent le cloud public Azure pour leur déploiement Azure global.Most people use Azure Public Cloud for their global Azure deployment. Pour des raisons de souveraineté, entre autres, il existe également des déploiements indépendants de Microsoft Azure.There are also some independent deployments of Microsoft Azure for reasons of sovereignty and so on. Ces déploiements indépendants sont appelés « environnements ».These independent deployments are referred to as "environments." Voici les environnements disponibles :These are the available environments:

Pour découvrir comment accéder à ces clouds et à leur stockage avec PowerShell, consultez Gestion du stockage dans les clouds indépendants d’Azure avec PowerShell.For information about how to access these clouds and their storage with PowerShell, please see Managing Storage in the Azure independent clouds using PowerShell.

Supprimer des ressourcesClean up resources

Si vous avez créé un groupe de ressources et un compte de stockage pour cet exercice, vous pouvez supprimer toutes les ressources que vous avez créées en supprimant le groupe de ressources.If you created a new resource group and a storage account for this exercise, yous can remove all of the assets you created by removing the resource group. Cette opération supprime également toutes les ressources contenues dans le groupe.This also deletes all resources contained within the group. Dans le cas présent, le compte de stockage créé et le groupe de ressources sont supprimés.In this case, it removes the storage account created and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Étapes suivantesNext steps

Cet article couvre les opérations courantes utilisant les applets de commande de plan de gestion pour gérer les comptes de stockage.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Vous avez appris à effectuer les actions suivantes :You learned how to:

  • Répertorier les comptes de stockageList storage accounts
  • Obtenir une référence à un compte de stockage existantGet a reference to an existing storage account
  • Créez un compte de stockage.Create a storage account
  • Définir les propriétés du compte de stockageSet storage account properties
  • Récupérer et régénérer les clés d’accèsRetrieve and regenerate the access keys
  • Protéger l’accès à votre compte de stockageProtect access to your storage account
  • Activer l’analyse du stockageEnable Storage Analytics

Cet article fournit également des liens vers plusieurs autres articles, notamment sur la gestion des objets de données, l’activation de Storage Analytics et l’accès aux clouds indépendants Azure tels que le cloud de Chine, le cloud allemand et le cloud Azure Government.This article also provided references to several other articles, such as how to manage the data objects, how to enable the Storage Analytics, and how to access the Azure independent clouds such as China Cloud, German Cloud, and Government Cloud. Voici d’autres articles connexes et ressources de référence :Here are some more related articles and resources for reference: