Usar Azure PowerShell con Azure StorageUsing Azure PowerShell with Azure Storage

Azure PowerShell se usa para crear y administrar recursos de Azure desde la línea de comandos de PowerShell o en scripts.Azure PowerShell is used to create and manage Azure resources from the PowerShell command line or in scripts. Para Azure Storage, estos cmdlets se dividen en dos categorías: el plano de control y el plano de datos.For Azure Storage, these cmdlets fall into two categories -- the control plane and the data plane. Los cmdlets del plano de control se usan para administrar la cuenta de almacenamiento: crear cuentas de almacenamiento, establecer las propiedades, eliminar las cuentas de almacenamiento, rotar las claves de acceso, etc.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. Los cmdlets del plano de datos se usan para administrar los datos almacenados en la cuenta de almacenamiento.The data plane cmdlets are used to manage the data stored in the storage account. Por ejemplo, cargar blobs, crear recursos compartidos de archivo y agregar mensajes a una cola.For example, uploading blobs, creating file shares, and adding messages to a queue.

En este artículo de ayuda se tratan las operaciones comunes con los cmdlets del plano de administración para administrar las cuentas de almacenamiento.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Aprenderá a:You learn how to:

  • Enumerar cuentas de almacenamientoList storage accounts
  • Obtener una referencia a una cuenta de almacenamiento existenteGet a reference to an existing storage account
  • Crear una cuenta de almacenamientoCreate a storage account
  • Definir las propiedades de una cuenta de almacenamientoSet storage account properties
  • Recuperar y regenerar las claves de accesoRetrieve and regenerate the access keys
  • Proteger el acceso a la cuenta de almacenamientoProtect access to your storage account
  • Habilitar Storage AnalyticsEnable Storage Analytics

En este artículo se proporcionan vínculos a otros artículos de PowerShell para Storage como, por ejemplo, cómo habilitar y obtener acceso a Storage Analytics, cómo usar los cmdlets del plano de datos y cómo obtener acceso a las nubes independientes de Azure, como Nube de China, Nube de Alemania y Nube de 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 no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Nota

Este artículo se ha actualizado para usar el nuevo módulo Az de Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Aún puede usar el módulo de AzureRM que continuará recibiendo correcciones de errores hasta diciembre de 2020 como mínimo.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para más información acerca del nuevo módulo Az y la compatibilidad con AzureRM, consulte Introducing the new Azure PowerShell Az module (Presentación del nuevo módulo Az de Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obtener instrucciones sobre la instalación del módulo Az, consulte Instalación de Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Este ejercicio requiere la versión 0.7 del módulo de Azure PowerShell o cualquier versión posterior.This exercise requires the Azure PowerShell module Az version 0.7 or later. Ejecute Get-Module -ListAvailable Az para encontrar la versión.Run Get-Module -ListAvailable Az to find the version. Si necesita instalarla o actualizarla, consulte el artículo sobre cómo instalar el módulo de Azure PowerShell.If you need to install or upgrade, see Install Azure PowerShell module.

Para este ejercicio, puede escribir los comandos en una ventana de PowerShell regular o puede usar Windows PowerShell ISE y escribir los comandos en un editor y, después, probar uno o varios comandos a la vez mientras revisa los ejemplos.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. Puede resaltar las filas que desea ejecutar y hacer clic en Ejecutar seleccionado para ejecutar solo esos comandos.You can highlight the rows you want to execute and click Run Selected to just run those commands.

Para más información sobre las cuentas de almacenamiento, vea Introducción a Microsoft Azure Storage y Acerca de las cuentas de almacenamiento de Azure.For more information about storage accounts, see Introduction to Storage and About Azure storage accounts.

Inicio de sesión en AzureSign in to Azure

Inicie sesión en la suscripción a Azure con el comando Connect-AzAccount y siga las instrucciones de la pantalla.Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

Connect-AzAccount

Enumeración de las cuentas de almacenamiento de la suscripciónList the storage accounts in the subscription

Ejecute el cmdlet Get-AzStorageAccount para recuperar la lista de cuentas de almacenamiento de la suscripción actual.Run the Get-AzStorageAccount cmdlet to retrieve the list of storage accounts in the current subscription.

Get-AzStorageAccount | Select StorageAccountName, Location

Obtener una referencia a una cuenta de almacenamientoGet a reference to a storage account

Después, necesita una referencia a una cuenta de almacenamiento.Next, you need a reference to a storage account. Puede crear una cuenta de almacenamiento u obtener una referencia a una cuenta de almacenamiento ya existente.You can either create a new storage account or get a reference to an existing storage account. En la sección siguiente se muestran ambos métodos.The following section shows both methods.

Uso de una cuenta de almacenamiento existenteUse an existing storage account

Para recuperar una cuenta de almacenamiento existente, necesita el nombre del grupo de recursos y el nombre de la cuenta de almacenamiento.To retrieve an existing storage account, you need the name of the resource group and the name of the storage account. Establezca las variables para esos dos campos y después use el cmdlet 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

Ahora ya tiene $storageAccount, que señala a una cuenta de almacenamiento existente.Now you have $storageAccount, which points to an existing storage account.

Crear una cuenta de almacenamientoCreate a storage account

En el siguiente script se muestra cómo crear una cuenta de almacenamiento de uso general mediante New-AzStorageAccount.The following script shows how to create a general-purpose storage account using New-AzStorageAccount. Después de crear la cuenta, recuperar su contexto, que se puede usar en los siguientes comandos en lugar de especificar la autenticación con cada llamada.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

El script usa los siguientes cmdlets de PowerShell:The script uses the following PowerShell cmdlets:

  • Get-AzLocation: recupera una lista de las ubicaciones válidas.Get-AzLocation -- retrieves a list of the valid locations. En el ejemplo se usa eastus para la ubicación.The example uses eastus for location.

  • New-AzResourceGroup: crea un grupo de recursos.New-AzResourceGroup -- creates a new resource group. Un grupo de recursos es un contenedor lógico en el que se implementan y se administran los recursos de Azure.A resource group is a logical container into which your Azure resources are deployed and managed. Se llama teststoragerg.Ours is called teststoragerg.

  • New-AzStorageAccount: crea la cuenta de almacenamiento.New-AzStorageAccount -- creates the storage account. En el ejemplo se utiliza testpshstorage.The example uses testpshstorage.

El nombre de SKU indica el tipo de replicación para la cuenta de almacenamiento, como LRS (almacenamiento con redundancia local).The SKU name indicates the type of replication for the storage account, such as LRS (Locally Redundant Storage). Para más información sobre la replicación, vea Replicación de almacenamiento de Azure.For more information about replication, see Azure Storage Replication.

Importante

El nombre de la cuenta de almacenamiento debe ser único en Azure y estar en minúscula.The name of your storage account must be unique within Azure and must be lowercase. Para las convenciones de nomenclatura y otras restricciones, vea Naming and Referencing Containers, Blobs, and Metadata (Convenciones de nomenclatura y referencia de contenedores, blobs y metadatos).For naming conventions and restrictions, see Naming and Referencing Containers, Blobs, and Metadata.

Ahora ya tiene una cuenta de almacenamiento nueva y una referencia a ella.Now you have a new storage account and a reference to it.

Administrar la cuenta de almacenamiento.Manage the storage account

Ahora que tiene una referencia a una cuenta de almacenamiento o una cuenta de almacenamiento existente, en la sección siguiente se explican algunos de los comandos que puede usar para administrar la cuenta de almacenamiento.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.

Propiedades de una cuenta de almacenamientoStorage account properties

Para cambiar la configuración de una cuenta de almacenamiento, utilice Set-AzStorageAccount.To change the settings for a storage account, use Set-AzStorageAccount. Aunque no puede cambiar la ubicación de una cuenta de almacenamiento o el grupo de recursos en que reside, sí puede modificar muchas de las propiedades.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. A continuación, se enumeran algunas de las propiedades que se pueden cambiar con PowerShell.The following lists some of the properties you can change using PowerShell.

  • El dominio personalizado asignado a la cuenta de almacenamiento.The custom domain assigned to the storage account.

  • Las etiquetas asignadas a la cuenta de almacenamiento.The tags assigned to the storage account. Las etiquetas se suelen usar para categorizar recursos de facturación.Tags are often used to categorize resources for billing purposes.

  • La SKU es la configuración de replicación de la cuenta de almacenamiento, como LRS (almacenamiento con redundancia local).The SKU is the replication setting for the storage account, such as LRS for Locally Redundant Storage. Por ejemplo, puede cambiar de Standard_LRS a Standard_GRS o Standard_RAGRS.For example, you might change from Standard_LRS to Standard_GRS or Standard_RAGRS. Tenga en cuenta que no se puede cambiar Standard_ZRS, Standard_GZRS, Standard_RAGZRS o Premium_LRS a otra SKU, ni cambiar otras SKU a estos niveles.Note that you can't change Standard_ZRS, Standard_GZRS, Standard_RAGZRS, or Premium_LRS to other SKUs, or change other SKUs to these.

  • El nivel de acceso para las cuentas de Blob Storage.The access tier for Blob storage accounts. El valor del nivel de acceso se establece en frecuente o esporádico y permite minimizar los costes gracias a la selección del nivel de acceso que mejor se adapta a la forma de utilizar la cuenta de almacenamiento.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. Para más información, vea Niveles de almacenamiento de archivo, esporádico y frecuente.For more information, see Hot, cool, and archive storage tiers.

  • Permitir solo el tráfico HTTPS.Only allow HTTPS traffic.

Administrar las claves de accesoManage the access keys

Una cuenta de Azure Storage incluye dos claves de cuenta.An Azure Storage account comes with two account keys. Para recuperar las claves, use Get-AzStorageAccountKey.To retrieve the keys, use Get-AzStorageAccountKey. Este ejemplo recupera la primera clave.This example retrieves the first key. Para recuperar otra, use Value[1] en lugar de Value[0].To retrieve the other one, use Value[1] instead of Value[0].

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

Para recuperar las claves, use New-AzStorageAccountKey.To regenerate the key, use New-AzStorageAccountKey.

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

Para regenerar la otra clave, use key2 como el nombre de clave en lugar de key1.To regenerate the other key, use key2 as the key name instead of key1.

Regenere una de las claves y después vuelva a recuperarla para ver el nuevo valor.Regenerate one of your keys and then retrieve it again to see the new value.

Nota

Debe realizar un planeamiento minucioso antes de regenerar la clave para una cuenta de almacenamiento de producción.You should perform careful planning before regenerating the key for a production storage account. La regeneración de una o ambas claves invalidará el acceso para alguna aplicación que use la clave regenerada.Regenerating one or both keys will invalidate the access for any application using the key that was regenerated. Para más información, consulte Claves de acceso.For more information, see Access keys.

Eliminar una cuenta de almacenamientoDelete a storage account

Para eliminar una cuenta de almacenamiento, utilice Remove-AzStorageAccount.To delete a storage account, use Remove-AzStorageAccount.

Remove-AzStorageAccount -ResourceGroup $resourceGroup -AccountName $storageAccountName

Importante

Cuando se elimina una cuenta de almacenamiento, también se eliminan todos los recursos almacenados en ella.When you delete a storage account, all of the assets stored in the account are deleted as well. Si elimina accidentalmente una cuenta, llame al soporte técnico de inmediato y abra una incidencia para restaurar la cuenta de almacenamiento.If you delete an account accidentally, call Support immediately and open a ticket to restore the storage account. No se garantiza la recuperación de los datos, pero a veces funciona.Recovery of your data is not guaranteed, but it does sometimes work. No cree una cuenta de almacenamiento con el mismo nombre que la anterior hasta que se resuelva el vale de soporte.Do not create a new storage account with the same name as the old one until the support ticket has been resolved.

Proteger la cuenta de almacenamiento mediante redes virtuales y firewallProtect your storage account using VNets and firewalls

De forma predeterminada, se puede acceder a todas las cuentas de almacenamiento a través de cualquier red que tenga acceso a Internet.By default, all storage accounts are accessible by any network that has access to the internet. Sin embargo, puede configurar reglas de red para permitir que solo las aplicaciones de redes virtuales específicas accedan a una cuenta de almacenamiento.However, you can configure network rules to only allow applications from specific virtual networks to access a storage account. Para más información, vea Configuración de Firewalls y redes virtuales de Azure Storage.For more information, see Configure Azure Storage Firewalls and Virtual Networks.

En el artículo se explica cómo administrar esta configuración con los siguientes cmdlets de PowerShell:The article shows how to manage these settings using the following PowerShell cmdlets:

Usar Storage AnalyticsUse storage analytics

Azure Storage Analytics consta de métricas de Storage Analytics y registros de Storage Analytics.Azure Storage Analytics consists of Storage Analytics Metrics and Storage Analytics Logging.

Las métricas de Storage Analytics se usan para recopilar métricas de las cuentas de almacenamiento de Azure que puede usar para supervisar el mantenimiento de una cuenta de almacenamiento.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. Las métricas pueden habilitarse para blobs, archivos, tablas y colas.Metrics can be enabled for blobs, files, tables, and queues.

Los registros de Storage Analytics se dan en el lado servidor y le permiten grabar en la cuenta de almacenamiento detalles de solicitudes correctas e incorrectas.Storage Analytics Logging happens server-side and enables you to record details for both successful and failed requests to your storage account. Estos registros le permiten no solo ver detalles de lectura y escritura, sino que también le permitirán eliminar operaciones de tablas, colas, blobs y las razones por las cuales las solicitudes fallaron.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. Los registros no están disponibles para Azure Files.Logging is not available for Azure Files.

Puede configurar la supervisión a través de Azure Portal, PowerShell o mediante programación a través de la biblioteca del cliente de Storage.You can configure monitoring using the Azure portal, PowerShell, or programmatically using the storage client library.

Nota

Puede habilitar el análisis de minutos con PowerShell.You can enable minute analytics using PowerShell. Esta funcionalidad no está disponible en el portal.This capability is not available in the portal.

Administrar los datos de la cuenta de almacenamientoManage the data in the storage account

Ahora que sabe cómo administrar la cuenta de almacenamiento con PowerShell, puede usar los artículos siguientes para obtener información sobre cómo obtener acceso a los objetos de datos de la cuenta de almacenamiento.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.

La API Table de Azure Cosmos DB proporciona características premium para el almacenamiento de tablas, como la distribución global llave en mano, lecturas y escrituras de latencia baja, la indexación secundaria automática y el rendimiento dedicado.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.

Implementaciones de Azure independientes en la nubeIndependent cloud deployments of Azure

La mayoría de los usuarios utiliza la nube pública de Azure para una implementación global.Most people use Azure Public Cloud for their global Azure deployment. También hay algunas implementaciones independientes de Microsoft Azure por motivos de soberanía, etc.There are also some independent deployments of Microsoft Azure for reasons of sovereignty and so on. Estas implementaciones independientes se conocen como "entornos".These independent deployments are referred to as "environments." Estos son los entornos disponibles:These are the available environments:

Para obtener información sobre cómo obtener acceso a estas nubes y su almacenamiento con PowerShell, consulte Administración del almacenamiento en las nubes independientes mediante 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.

Limpieza de recursosClean up resources

Si ha creado un nuevo grupo de recursos y una cuenta de almacenamiento para este ejercicio, puede quitar todos los recursos creados quitando el grupo de recursos.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. Esto también elimina todos los recursos contenidos en el grupo.This also deletes all resources contained within the group. En este caso, se quita la cuenta de almacenamiento creada y el propio grupo de recursos.In this case, it removes the storage account created and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Pasos siguientesNext steps

En este artículo de ayuda se tratan las operaciones comunes con los cmdlets del plano de administración para administrar las cuentas de almacenamiento.This how-to article covers common operations using the management plane cmdlets to manage storage accounts. Ha aprendido a:You learned how to:

  • Enumerar cuentas de almacenamientoList storage accounts
  • Obtener una referencia a una cuenta de almacenamiento existenteGet a reference to an existing storage account
  • Crear una cuenta de almacenamientoCreate a storage account
  • Definir las propiedades de una cuenta de almacenamientoSet storage account properties
  • Recuperar y regenerar las claves de accesoRetrieve and regenerate the access keys
  • Proteger el acceso a la cuenta de almacenamientoProtect access to your storage account
  • Habilitar Storage AnalyticsEnable Storage Analytics

En este artículo también se proporcionan referencias a otros artículos como, por ejemplo, cómo administrar los objetos de datos, cómo habilitar Storage Analytics y cómo obtener acceso a las nubes independientes de Azure, como Nube de China, Nube de Alemania y Nube de 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. A continuación encontrará más artículos relacionados y recursos de referencia:Here are some more related articles and resources for reference: