Hızlı Başlangıç: Karşıya yükleme, indirme ve Azure PowerShell kullanarak blobları ListeleQuickstart: Upload, download, and list blobs by using Azure PowerShell

Azure kaynaklarını oluşturmak ve yönetmek için Azure PowerShell modülünü kullanın.Use the Azure PowerShell module to create and manage Azure resources. Azure kaynaklarını oluşturma ve yönetme işlemleri PowerShell komut satırından veya betiklerden gerçekleştirilebilir.Creating or managing Azure resources can be done from the PowerShell command line or in scripts. Bu kılavuzda yerel disk ile Azure Blob depolama arasında dosyaları aktarmak için PowerShell kullanma hakkında bilgi sağlanır.This guide describes using PowerShell to transfer files between local disk and Azure Blob storage.

ÖnkoşullarPrerequisites

Azure depolamaya erişmek için bir Azure aboneliği gerekir.To access Azure Storage, you'll need an Azure subscription. Bir aboneliğiniz zaten yoksa, oluşturup bir ücretsiz bir hesap başlamadan önce.If you don't already have a subscription, then create a free account before you begin.

Not

Bu makalede, yeni Azure PowerShell Az modülü kullanmak için güncelleştirildi.This article has been updated to use the new Azure PowerShell Az module. Hata düzeltmeleri en az kadar uygulanmaya devam edilecektir AzureRM modülünü kullanmaya devam edebilirsiniz aralık 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Yeni Az modül ve AzureRM uyumluluğu hakkında daha fazla bilgi için bkz: Karşınızda yeni Azure PowerShell Az modül.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az Modül yükleme yönergeleri için bkz. Azure PowerShell yükleme.For Az module installation instructions, see Install Azure PowerShell.

Bu hızlı başlangıçta, Azure PowerShell modülü Az 0.7 veya sonraki bir sürümü gerektirir.This quickstart requires the Azure PowerShell module Az version 0.7 or later. Sürümü bulmak için Get-InstalledModule -Name Az -AllVersions | select Name,Version komutunu çalıştırın.Run Get-InstalledModule -Name Az -AllVersions | select Name,Version to find the version. Yüklemeniz veya yükseltmeniz gerekirse, bkz. Azure PowerShell Modülü yükleme.If you need to install or upgrade, see Install Azure PowerShell module.

Azure'da oturum açmaSign in to Azure

Connect-AzAccount komutuyla Azure aboneliğinizde oturum açın ve ekrandaki yönergeleri izleyin.Sign in to your Azure subscription with the Connect-AzAccount command and follow the on-screen directions.

Connect-AzAccount

Kullanmak istediğiniz konumdan emin değilseniz, kullanılabilir konumları listeleyebilirsiniz.If you don't know which location you want to use, you can list the available locations. Aşağıdaki kod örneğini kullanarak bölgelerin listesini görüntüleyin ve kullanmak istediğinizi bulun.Display the list of locations by using the following code example and find the one you want to use. Bu örnekte eastus kullanılmıştır.This example uses eastus. Konumu bir değişkende depolayın ve tek bir yerde değiştirebilmek için değişkeni kullanın.Store the location in a variable and use the variable so you can change it in one place.

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

Kaynak grubu oluşturmaCreate a resource group

Bir Azure kaynak grubu oluşturun yeni AzResourceGroup.Create an Azure resource group with New-AzResourceGroup. Kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır.A resource group is a logical container into which Azure resources are deployed and managed.

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

Depolama hesabı oluşturmaCreate a storage account

Kullanarak LRS çoğaltma ile standart, genel amaçlı depolama hesabı oluşturma yeni AzStorageAccount.Create a standard, general-purpose storage account with LRS replication by using New-AzStorageAccount. Ardından kullanmak istediğiniz depolama hesabını tanımlayan depolama hesabı bağlamını alın.Next, get the storage account context that defines the storage account you want to use. Depolama hesabında bir işlem gerçekleştirirken, kimlik bilgilerini tekrar tekrar geçirmek yerine bağlama başvurun.When acting on a storage account, reference the context instead of repeatedly passing in the credentials. Yerel olarak yedekli depolama (LRS) ve blob şifrelemesi (varsayılan olarak etkindir) ile mystorageaccount adlı bir depolama hesabı oluşturmak için aşağıdaki örneği kullanın.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

Bir kapsayıcı oluşturmaCreate a container

Bloblar her zaman bir kapsayıcıya yüklenir.Blobs are always uploaded into a container. Bu, blob gruplarını bilgisayarınızdaki dosyaları klasörler halinde düzenlediğiniz gibi düzenleyebilmenizi sağlar.You can organize groups of blobs like the way you organize your files on your computer in folders.

Kapsayıcı adını ayarlayın, ardından kullanarak kapsayıcıyı oluşturun yeni AzStorageContainer.Set the container name, then create the container by using New-AzStorageContainer. Dosyalara genel erişime izin vermek için izinleri blob olarak ayarlayın.Set the permissions to blob to allow public access of the files. Bu örnekteki kapsayıcı adı quickstartblobs’tur.The container name in this example is quickstartblobs.

$containerName = "quickstartblobs"
new-AzStoragecontainer -Name $containerName -Context $ctx -Permission blob

Blobları kapsayıcıya yüklemeUpload blobs to the container

Blob depolama blok blobları, ekleme bloblarını ve sayfa bloblarını destekler.Blob storage supports block blobs, append blobs, and page blobs. IaaS VM’lerini yedekleyen VHD dosyaları sayfa bloblarıdır.VHD files that back IaaS VMs are page blobs. Ekleme bloblarını, bir dosyaya yazıp daha sonradan daha fazla bilgi eklemek istediğiniz durumlarda günlüğe kaydetmek için kullanın.Use append blobs for logging, such as when you want to write to a file and then keep adding more information. Blob depolamada depolanan çoğu dosya blok blobudur.Most files stored in Blob storage are block blobs.

Bir dosyayı bir blok blobuna yüklemek için, bir kapsayıcı başvurusu alın ve bu kapsayıcıdaki blok blobuna bir başvuru alın.To upload a file to a block blob, get a container reference, then get a reference to the block blob in that container. Blob başvurusunu aldıktan sonra verileri için kullanarak karşıya yükleyebilirsiniz kümesi AzStorageBlobContent.Once you have the blob reference, you can upload data to it by using Set-AzStorageBlobContent. Bu işlemle, daha önce oluşturulmadıysa bir blob oluşturulur, blob varsa blobun üzerine yazılır.This operation creates the blob if it doesn't exist, or overwrites the blob if it exists.

Aşağıdaki örneklerde yerel diskteki D:\_TestImages klasöründen Image001.jpg ve Image002.png dosyaları az önce oluşturduğunuz kapsayıcıya yüklenmektedir.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

Devam etmeden önce istediğiniz sayıda dosyayı karşıya yükleyin.Upload as many files as you like before continuing.

Blob’ları bir kapsayıcıda listelemeList the blobs in a container

Kullanarak kapsayıcıda BLOB listesini alma Get-AzStorageBlob.Get a list of blobs in the container by using Get-AzStorageBlob. Bu örnekte karşıya yüklenen blobların yalnızca adları gösterilmektedir.This example shows just the names of the blobs uploaded.

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

Blob’ları indirmeDownload blobs

Blobları yerel diskinize indirin.Download the blobs to your local disk. İndirmek istediğiniz her bir blob kümesi için ad ve çağrı Get-AzStorageBlobContent blobu indirmek için.For each blob you want to download, set the name and call Get-AzStorageBlobContent to download the blob.

Bu örnekte, bloblar yerel diskteki D:\_TestImages\Downloads klasörüne indirilir.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

AzCopy ile veri aktarımıData transfer with AzCopy

AzCopy yardımcı programı, Azure Depolama’ya yüksek performanslı betik oluşturulabilir veri aktarımı için diğer bir seçenektir.The AzCopy utility is another option for high-performance scriptable data transfer for Azure Storage. Blob, Dosya ve Tablo depolamaları arasında veri aktarmak için AzCopy kullanın.Use AzCopy to transfer data to and from Blob, File, and Table storage.

Hızlı bir örnek olarak, bir PowerShell penceresinden myfile.txt adlı dosyayı mystoragecontainer kapsayıcısına yüklemek için AzCopy komutu aşağıda gösterilmiştir.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"

Kaynakları temizlemeClean up resources

Oluşturduğunuz tüm varlıkları kaldırın.Remove all of the assets you've created. Varlıkları kaldırmanın en kolay yolu kaynak grubunu silmektir.The easiest way to remove the assets is to delete the resource group. Kaynak grubunu kaldırdığınızda o grubun içindeki tüm kaynaklar da silinir.Removing the resource group also deletes all resources included within the group. Aşağıdaki örnekte, kaynak grubu kaldırıldığında depolama hesabı ve kaynak grubunun kendisi de kaldırılır.In the following example, removing the resource group removes the storage account and the resource group itself.

Remove-AzResourceGroup -Name $resourceGroup

Sonraki adımlarNext steps

Bu hızlı başlangıçta, dosyaları yerel bir disk ile Azure Blob depolama arasında aktardınız.In this quickstart, you transferred files between a local disk and Azure Blob storage. PowerShell'i kullanarak Blob depolama ile çalışma hakkında daha fazla bilgi edinmek için Azure PowerShell'i Azure Depolama'yla kullanma öğreticisine geçin.To learn more about working with Blob storage by using PowerShell, continue to How-to use Azure PowerShell with Azure Storage.

Microsoft Azure PowerShell Depolama cmdlet’leri başvurusuMicrosoft Azure PowerShell Storage cmdlets reference

Microsoft Azure Depolama GezginiMicrosoft Azure Storage Explorer

  • Microsoft Azure Depolama Gezgini, Microsoft’un Windows, macOS ve Linux üzerinde Azure Depolama verileriyle görsel olarak çalışmanızı sağlayan ücretsiz ve tek başına uygulamasıdır.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.