Guía de inicio rápido: Carga, descarga y enumeración de blobs mediante Azure PowerShellQuickstart: Upload, download, and list blobs by using Azure PowerShell

Use el módulo de Azure PowerShell para crear y administrar los recursos de Azure.Use the Azure PowerShell module to create and manage Azure resources. La creación o administración de los recursos de Azure puede realizarse desde la línea de comandos de PowerShell o en scripts.Creating or managing Azure resources can be done from the PowerShell command line or in scripts. En esta guía se detalla el uso de PowerShell para transferir archivos entre el disco local y Azure Blob Storage.This guide describes using PowerShell to transfer files between local disk and Azure Blob storage.

Nota

Las características descritas en este artículo están disponibles para las cuentas que tienen un espacio de nombres jerárquico solo si se inscribe en la versión preliminar pública del acceso multiprotocolo en Data Lake Storage.The features described in this article are available to accounts that have a hierarchical namespace only if you enroll in the public preview of multi-protocol access on Data Lake Storage. Para conocer las limitaciones, consulte el artículo Problemas conocidos.To review limitations, see the known issues article.

Requisitos previosPrerequisites

Para acceder a Azure Storage, necesitará una suscripción de Azure.To access Azure Storage, you'll need an Azure subscription. Si todavía no tiene una suscripción, cree una cuenta gratuita antes de empezar.If you don't already have a subscription, then 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.

Para realizar los pasos de este inicio rápido, se requiere la versión 0.7 del módulo Az de Azure PowerShell, o cualquier versión posterior.This quickstart requires the Azure PowerShell module Az version 0.7 or later. Ejecute Get-InstalledModule -Name Az -AllVersions | select Name,Version para encontrar la versión.Run Get-InstalledModule -Name Az -AllVersions | select Name,Version 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.

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

Si no sabe qué ubicación desea usar, puede enumerar las ubicaciones disponibles.If you don't know which location you want to use, you can list the available locations. Muestre la lista de ubicaciones; para ello, use el siguiente ejemplo de código y busque la que desea usar.Display the list of locations by using the following code example and find the one you want to use. En este ejemplo se usa eastus.This example uses eastus. Almacénelo en una variable y úsela para que pueda cambiar este valor en un solo lugar.Store the location in a variable and use the variable so you can change it in one place.

Get-AzLocation | select Location
$location = "eastus"

Crear un grupo de recursosCreate a resource group

Cree un grupo de recursos de Azure con New-AzResourceGroup.Create an Azure resource group with New-AzResourceGroup. 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 Azure resources are deployed and managed.

$resourceGroup = "myResourceGroup"
New-AzResourceGroup -Name $resourceGroup -Location $location

Crear una cuenta de almacenamientoCreate a storage account

Cree una cuenta de almacenamiento estándar de uso general con replicación de almacenamiento con redundancia local mediante New-AzStorageAccount.Create a standard, general-purpose storage account with LRS replication by using New-AzStorageAccount. Después, obtenga el contexto de la cuenta de almacenamiento que define la cuenta de almacenamiento que desea usar.Next, get the storage account context that defines the storage account you want to use. Cuando actúa en una cuenta de almacenamiento, hace referencia al contexto en lugar de proporcionar varias veces las credenciales.When acting on a storage account, reference the context instead of repeatedly passing in the credentials. Use el siguiente ejemplo para crear una cuenta de almacenamiento denominada mystorageaccount con el cifrado de blob y el almacenamiento con redundancia local (LRS) (habilitados de forma predeterminada).Use the following example to create a storage account called mystorageaccount with locally redundant storage (LRS) and blob encryption (enabled by default).

$storageAccount = New-AzStorageAccount -ResourceGroupName $resourceGroup `
  -Name "mystorageaccount" `
  -SkuName Standard_LRS `
  -Location $location `

$ctx = $storageAccount.Context

Crear un contenedorCreate a container

Los blobs siempre se cargan en un contenedor.Blobs are always uploaded into a container. Puede organizar los grupos de blobs de una forma similar a como organiza los archivos en carpetas en el equipo.You can organize groups of blobs like the way you organize your files on your computer in folders.

Establezca el nombre del contenedor y, después, cree el contenedor mediante New-AzStorageContainer.Set the container name, then create the container by using New-AzStorageContainer. Establezca los permisos para blob de modo que se permita el acceso público de los archivos.Set the permissions to blob to allow public access of the files. El nombre del contenedor en este ejemplo es quickstartblobs.The container name in this example is quickstartblobs.

$containerName = "quickstartblobs"
New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob

Carga de blobs al contenedorUpload blobs to the container

Blob Storage admite blobs en bloques, blobs en anexos y blobs en páginas.Blob storage supports block blobs, append blobs, and page blobs. Los archivos VHD utilizados para respaldar VM IaaS son blobs en páginas.VHD files that back IaaS VMs are page blobs. Use los blobs en anexos para el registro, por ejemplo, cuando desea escribir en un archivo y luego sigue agregando más información.Use append blobs for logging, such as when you want to write to a file and then keep adding more information. La mayoría de los archivos almacenados en Blob Storage son blobs en bloques.Most files stored in Blob storage are block blobs.

Para cargar un archivo en un blob en bloques, obtenga una referencia de contenedor y luego obtenga una referencia al blob en bloques en ese contenedor.To upload a file to a block blob, get a container reference, then get a reference to the block blob in that container. Cuando tenga la referencia del blob, puede cargar datos en él mediante Set-AzStorageBlobContent.Once you have the blob reference, you can upload data to it by using Set-AzStorageBlobContent. De este modo, se creará el blob si no existe, o se sobrescribirá si ya existe.This operation creates the blob if it doesn't exist, or overwrites the blob if it exists.

Los ejemplos siguientes cargan Image001.jpg e Image002.png desde la carpeta D:\_TestImages del disco local al contenedor que creó.The following examples upload Image001.jpg and Image002.png from the D:\_TestImages folder on the local disk to the container you created.

# upload a file
Set-AzStorageBlobContent -File "D:\_TestImages\Image001.jpg" `
  -Container $containerName `
  -Blob "Image001.jpg" `
  -Context $ctx 

# upload another file
Set-AzStorageBlobContent -File "D:\_TestImages\Image002.png" `
  -Container $containerName `
  -Blob "Image002.png" `
  -Context $ctx

Cargue tantos archivos como desee antes de continuar.Upload as many files as you like before continuing.

Enumerar los blobs de un contenedorList the blobs in a container

Obtenga una lista de blobs del contenedor mediante Get-AzStorageBlob.Get a list of blobs in the container by using Get-AzStorageBlob. Este ejemplo muestra solo los nombres de los blobs cargados.This example shows just the names of the blobs uploaded.

Get-AzStorageBlob -Container $ContainerName -Context $ctx | select Name

Descargar blobsDownload blobs

Descargue los blobs en el disco local.Download the blobs to your local disk. Para cada blob que quiera descargar, establezca el nombre y llame a Get-AzStorageBlobContent para descargar el blob.For each blob you want to download, set the name and call Get-AzStorageBlobContent to download the blob.

Este ejemplo descarga los blobs a D:\_TestImages\Downloads en el disco local.This example downloads the blobs to D:\_TestImages\Downloads on the local disk.

# download first blob
Get-AzStorageBlobContent -Blob "Image001.jpg" `
  -Container $containerName `
  -Destination "D:\_TestImages\Downloads\" `
  -Context $ctx 

# download another blob
Get-AzStorageBlobContent -Blob "Image002.png" `
  -Container $containerName `
  -Destination "D:\_TestImages\Downloads\" `
  -Context $ctx

Transferencia de datos con AzCopyData transfer with AzCopy

La utilidad AzCopy es otra opción para la transferencia de datos que permite ejecutar scripts de alto rendimiento para Azure Storage.The AzCopy utility is another option for high-performance scriptable data transfer for Azure Storage. Use AzCopy para transferir datos a y desde Blob Storage, File Storage y Table Storage.Use AzCopy to transfer data to and from Blob, File, and Table storage.

A modo de un ejemplo rápido, aquí está el comando de AzCopy para cargar un archivo denominado myfile.txt al contenedor mystoragecontainer desde dentro de una ventana de PowerShell.As a quick example, here's the AzCopy command for uploading a file called myfile.txt to the mystoragecontainer container from within a PowerShell window.

./AzCopy `
    /Source:C:\myfolder `
    /Dest:https://mystorageaccount.blob.core.windows.net/mystoragecontainer `
    /DestKey:<storage-account-access-key> `
    /Pattern:"myfile.txt"

Limpieza de recursosClean up resources

Quite todos los recursos que ha creado.Remove all of the assets you've created. La manera más fácil de quitar los recursos consiste en eliminar el grupo de recursos.The easiest way to remove the assets is to delete the resource group. Al quitar el grupo de recursos también se eliminan todos los recursos contenidos en él.Removing the resource group also deletes all resources included within the group. En el ejemplo siguiente, al quitar el grupo de recursos, se quita la cuenta de almacenamiento y el propio grupo de recursos.In the following example, removing the resource group removes the storage account and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Pasos siguientesNext steps

En esta guía de inicio rápido, transfirió archivos entre un disco local y Azure Blob Storage.In this quickstart, you transferred files between a local disk and Azure Blob storage. Para más información sobre cómo trabajar con Blob Storage mediante PowerShell, continúe con el tutorial sobre el uso de Azure PowerShell con Azure Storage.To learn more about working with Blob storage by using PowerShell, continue to How-to use Azure PowerShell with Azure Storage.

Referencia de cmdlets de almacenamiento de Microsoft Azure PowerShellMicrosoft Azure PowerShell Storage cmdlets reference

Explorador de almacenamiento de Microsoft AzureMicrosoft Azure Storage Explorer

  • El Explorador de Microsoft Azure Storage es una aplicación independiente y gratuita de Microsoft que permite trabajar visualmente con los datos de Azure Storage en Windows, macOS y Linux.Microsoft Azure Storage Explorer is a free, standalone app from Microsoft that enables you to work visually with Azure Storage data on Windows, macOS, and Linux.