Início Rápido: Carregar, baixar e listar blobs usando o Azure PowerShellQuickstart: Upload, download, and list blobs by using Azure PowerShell

Use o módulo do Azure PowerShell para criar e gerenciar recursos do Azure.Use the Azure PowerShell module to create and manage Azure resources. Criar ou gerenciar recursos do Azure pode ser feito da linha de comando do PowerShell ou em scripts.Creating or managing Azure resources can be done from the PowerShell command line or in scripts. Este guia descreve o uso do PowerShell para transferir arquivos entre o disco local e o Armazenamento de Blobs do Azure.This guide describes using PowerShell to transfer files between local disk and Azure Blob storage.

Observação

Os recursos descritos neste artigo agora estão disponíveis para contas que têm um namespace hierárquico.The features described in this article are now available to accounts that have a hierarchical namespace. Para examinar as limitações, confira o artigo Problemas conhecidos com o Azure Data Lake Storage Gen2.To review limitations, see the Known issues with Azure Data Lake Storage Gen2 article.

Pré-requisitosPrerequisites

Para acessar o Armazenamento do Azure, você precisará de uma assinatura do Azure.To access Azure Storage, you'll need an Azure subscription. Se você ainda não tiver uma assinatura, crie uma conta gratuita antes de começar.If you don't already have a subscription, then create a free account before you begin.

Observação

Este artigo foi atualizado para usar o novo módulo Az do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Você ainda pode usar o módulo AzureRM, que continuará a receber as correções de bugs até pelo menos dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para saber mais sobre o novo módulo Az e a compatibilidade com o AzureRM, confira Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, confira Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Este início rápido exige o módulo Az do Azure PowerShell versão 0.7 ou posterior.This quickstart requires the Azure PowerShell module Az version 0.7 or later. Execute Get-InstalledModule -Name Az -AllVersions | select Name,Version para encontrar a versão.Run Get-InstalledModule -Name Az -AllVersions | select Name,Version to find the version. Se você precisar instalá-lo ou atualizá-lo, confira Instalar o módulo do Azure PowerShell.If you need to install or upgrade, see Install Azure PowerShell module.

Entrar no AzureSign in to Azure

Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

Connect-AzAccount

Se você não sabe qual localização deseja usar, você pode listar as localizações disponíveis.If you don't know which location you want to use, you can list the available locations. Exiba a lista de locais usando o seguinte exemplo de código e encontrar aquele que você deseja usar.Display the list of locations by using the following code example and find the one you want to use. Esse exemplo usa eastus.This example uses eastus. Armazene o local em uma variável e use a variável para que você possa alterá-la em um único local.Store the location in a variable and use the variable so you can change it in one place.

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

Criar um grupo de recursosCreate a resource group

Crie um grupo de recursos do Azure com New-AzResourceGroup.Create an Azure resource group with New-AzResourceGroup. Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.A resource group is a logical container into which Azure resources are deployed and managed.

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

Criar uma conta de armazenamentoCreate a storage account

Crie uma conta de armazenamento para uso geral padrão com replicação LRS usando New-AzStorageAccount.Create a standard, general-purpose storage account with LRS replication by using New-AzStorageAccount. A seguir, obtenha o contexto da conta de armazenamento que define a conta de armazenamento que você deseja usar.Next, get the storage account context that defines the storage account you want to use. Ao agir em uma conta de armazenamento, você pode referenciar o contexto em vez de passar repetidamente as credenciais.When acting on a storage account, reference the context instead of repeatedly passing in the credentials. Use o exemplo a seguir para criar uma conta de armazenamento chamada mystorageaccount com armazenamento com redundância local (LRS) e criptografia de blob (habilitada por padrão).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

Criar um contêinerCreate a container

Os blobs são sempre carregados em um contêiner.Blobs are always uploaded into a container. É possível organizar grupos de blobs de forma similar àquela em que você organiza os arquivos em pastas no seu computador.You can organize groups of blobs like the way you organize your files on your computer in folders.

Defina o nome do contêiner e, em seguida, crie o contêiner usando New-AzStorageContainer.Set the container name, then create the container by using New-AzStorageContainer. Defina as permissões como blob para permitir acesso público dos arquivos.Set the permissions to blob to allow public access of the files. O nome do contêiner neste exemplo é quickstartblobs.The container name in this example is quickstartblobs.

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

Carregar blobs para o contêinerUpload blobs to the container

O Armazenamento de Blobs dá suporte a blobs de blocos, blobs de acréscimo e blobs de páginas.Blob storage supports block blobs, append blobs, and page blobs. Arquivos VHD que auxiliam VMs IaaS são blobs de páginas.VHD files that back IaaS VMs are page blobs. Use os blobs de acréscimo para registro em log, como quando você quer gravar em um arquivo e depois adicionar mais informações.Use append blobs for logging, such as when you want to write to a file and then keep adding more information. A maioria dos arquivos armazenados no Armazenamento de Blobs são blobs de blocos.Most files stored in Blob storage are block blobs.

Para carregar um arquivo em um blob de blocos, obtenha uma referência de contêiner e uma referência para o blob de blocos nesse contêiner.To upload a file to a block blob, get a container reference, then get a reference to the block blob in that container. Depois de obter a referência de blob, carregue dados nele usando Set-AzStorageBlobContent.Once you have the blob reference, you can upload data to it by using Set-AzStorageBlobContent. Essa operação cria o blob, se ele não existir, ou o substitui, se ele já existir.This operation creates the blob if it doesn't exist, or overwrites the blob if it exists.

Os exemplos a seguir carregam a Image001.jpg e Image002.png da pasta D:\_TestImages no disco local para o contêiner que você criou.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

Carregue quantos arquivos desejar antes de continuar.Upload as many files as you like before continuing.

Listar os blobs em um contêinerList the blobs in a container

Obtenha uma lista de blobs no contêiner usando Get-AzStorageBlob.Get a list of blobs in the container by using Get-AzStorageBlob. Este exemplo mostra apenas os nomes dos blobs carregados.This example shows just the names of the blobs uploaded.

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

Baixar blobsDownload blobs

Baixe os blobs em seu disco local.Download the blobs to your local disk. Para cada blob que deseja baixar, defina o nome e chame Get-AzStorageBlobContent para baixar o blob.For each blob you want to download, set the name and call Get-AzStorageBlobContent to download the blob.

Este exemplo baixa os blobs para D:\_TestImages\Downloads no 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

Transferência de dados com AzCopyData transfer with AzCopy

O utilitário AzCopy é outra opção para a transferência de dados programável por script de alto desempenho para o Armazenamento do Azure.The AzCopy utility is another option for high-performance scriptable data transfer for Azure Storage. Use AzCopy para transferir dados para e do armazenamento de Blobs, Arquivo e Tabela.Use AzCopy to transfer data to and from Blob, File, and Table storage.

Como um exemplo rápido, aqui está o comando do AzCopy para carregar um arquivo chamado myfile.txt para o contêiner mystoragecontainer de dentro de uma janela do 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"

Limpar recursosClean up resources

Remova todos os ativos que você criou.Remove all of the assets you've created. A maneira mais fácil de remover os ativos é excluir o grupo de recursos.The easiest way to remove the assets is to delete the resource group. Remover o grupo de recursos também exclui todos os recursos contidos no grupo.Removing the resource group also deletes all resources included within the group. No exemplo a seguir, remover o grupo de recursos remove a conta de armazenamento e o próprio grupo de recursos.In the following example, removing the resource group removes the storage account and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Próximas etapasNext steps

Nesse guia de início rápido, você transferiu arquivos entre o disco local e o Armazenamento de Blobs do Azure.In this quickstart, you transferred files between a local disk and Azure Blob storage. Para saber mais sobre como trabalhar com o armazenamento de Blobs usando o PowerShell, continue a usar o Guia de instruções do Azure PowerShell com o Armazenamento do Azure.To learn more about working with Blob storage by using PowerShell, continue to How-to use Azure PowerShell with Azure Storage.

Referência de cmdlets de Armazenamento do Microsoft Azure PowerShellMicrosoft Azure PowerShell Storage cmdlets reference

Gerenciador do Armazenamento do Microsoft AzureMicrosoft Azure Storage Explorer