AzCopy’yi kullanmaya başlamaGet started with AzCopy

AzCopy, bir depolama hesabına iki yönlü blob veya dosya kopyalama işlemi gerçekleştirmenizi sağlayan bir komut satırı yardımcı programıdır.AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. Bu makale AzCopy programını indirme, depolama hesabınıza bağlama ve dosyaları aktarma aşamalarında size yardımcı olur.This article helps you download AzCopy, connect to your storage account, and then transfer files.

Not

AzCopy ile v10 arasındaki , şu anda desteklenen AzCopy sürümüdür.AzCopy V10 is the currently supported version of AzCopy.

AzCopy 'in önceki bir sürümünü kullanmanız gerekiyorsa, bu makalenin AzCopy 'in önceki sürümünü kullanma bölümüne bakın.If you need to use a previous version of AzCopy, see the Use the previous version of AzCopy section of this article.

AzCopy'yi indirinDownload AzCopy

İlk olarak, AzCopy Ile v10 arasındaki çalıştırılabilir dosyasını bilgisayarınızdaki herhangi bir dizine indirin.First, download the AzCopy V10 executable file to any directory on your computer. AzCopy Ile v10 arasındaki yalnızca yürütülebilir bir dosyadır, bu nedenle yüklenecek bir şey yoktur.AzCopy V10 is just an executable file, so there's nothing to install.

Bu dosyalar bir ZIP dosyası (Windows ve Mac) veya bir tar dosyası (Linux) olarak sıkıştırılır.These files are compressed as a zip file (Windows and Mac) or a tar file (Linux). IK dosyasını Linux üzerinde indirip sıkıştırmasını açmak için Linux dağıtımına yönelik belgelere bakın.To download and decompress the tar file on Linux, see the documentation for your Linux distribution.

Not

Azure Tablo depolama hizmetinize veri kopyalamak Istiyorsanız, azcopy sürüm 7,3' yi de yükleyebilirsiniz.If you want to copy data to and from your Azure Table storage service, then install AzCopy version 7.3.

AzCopy programını çalıştırmaRun AzCopy

Kolaylık sağlamak için AzCopy yürütülebilir dosyanızın bulunduğu dizini sistem yolunuza ekleyebilirsiniz.For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. Bu şekilde, azcopy sisteminizdeki herhangi bir dizinden yazabilirsiniz.That way you can type azcopy from any directory on your system.

Yolunuza AzCopy dizinini eklememayı seçerseniz, dizinleri AzCopy yürütülebilir dosyanızın konumuyla değiştirmeniz ve azcopy .\azcopy Windows PowerShell komut istemleri ' nde yazmanız gerekir.If you choose not to add the AzCopy directory to your path, you'll have to change directories to the location of your AzCopy executable and type azcopy or .\azcopy in Windows PowerShell command prompts.

Komutların listesini görmek için yazın azcopy -h ve ENTER tuşuna basın.To see a list of commands, type azcopy -h and then press the ENTER key.

Belirli bir komut hakkında bilgi edinmek için, yalnızca komutun adını ekleyin (örneğin: azcopy list -h ).To learn about a specific command, just include the name of the command (For example: azcopy list -h).

Satır içi yardımInline help

Her komut ve komut parametresine ilişkin ayrıntılı başvuru belgelerini bulmak için bkz. AzCopyTo find detailed reference documentation for each command and command parameter, see azcopy

Not

Azure depolama hesabınızın sahibi olarak, verilere erişim için otomatik olarak izinler atanmamıştır.As an owner of your Azure Storage account, you aren't automatically assigned permissions to access data. AzCopy ile anlamlı bir işlem yapabilmeniz için, depolama hizmetine yetkilendirme kimlik bilgilerini nasıl sağlayacağınıza karar vermeniz gerekir.Before you can do anything meaningful with AzCopy, you need to decide how you'll provide authorization credentials to the storage service.

AzCopy yetkilendirAuthorize AzCopy

Yetkilendirme kimlik bilgilerini Azure Active Directory (AD) kullanarak veya paylaşılan erişim Imzası (SAS) belirteci kullanarak sağlayabilirsiniz.You can provide authorization credentials by using Azure Active Directory (AD), or by using a Shared Access Signature (SAS) token.

Bu tabloyu kılavuz olarak kullan:Use this table as a guide:

Depolama türüStorage type Şu anda desteklenen yetkilendirme yöntemiCurrently supported method of authorization
Blob depolamaBlob storage Azure AD ve SASAzure AD & SAS
BLOB depolama (hiyerarşik ad alanı)Blob storage (hierarchical namespace) Azure AD ve SASAzure AD & SAS
Dosya depolamaFile storage Yalnızca SASSAS only

Seçenek 1: Azure Active Directory kullanınOption 1: Use Azure Active Directory

Bu seçenek yalnızca BLOB depolama için kullanılabilir.This option is available for blob Storage only. Azure Active Directory kullanarak, her komuta bir SAS belirteci eklemek yerine kimlik bilgilerini bir kez sağlayabilirsiniz.By using Azure Active Directory, you can provide credentials once instead of having to append a SAS token to each command.

Not

Geçerli sürümde, blob 'ları depolama hesapları arasında kopyalamayı planlıyorsanız, her kaynak URL 'ye bir SAS belirteci eklemeniz gerekir.In the current release, if you plan to copy blobs between storage accounts, you'll have to append a SAS token to each source URL. SAS belirtecini yalnızca hedef URL 'den atlayabilirsiniz.You can omit the SAS token only from the destination URL. Örnekler için bkz. depolama hesapları arasında blobları kopyalama.For examples, see Copy blobs between storage accounts.

Azure AD 'yi kullanarak erişim yetkisi vermek için bkz. AzCopy ve Azure Active Directory (Azure AD) ile bloblara erişim yetkisi verme.To authorize access by using Azure AD, see Authorize access to blobs with AzCopy and Azure Active Directory (Azure AD).

2. seçenek: SAS belirteci kullanmaOption 2: Use a SAS token

AzCopy komutlarınız içinde kullanılan her kaynak veya hedef URL 'ye bir SAS belirteci ekleyebilirsiniz.You can append a SAS token to each source or destination URL that use in your AzCopy commands.

Bu örnek komut, verileri bir yerel dizinden bir blob kapsayıcısına özyinelemeli olarak kopyalar.This example command recursively copies data from a local directory to a blob container. Kapsayıcı URL 'sinin sonuna kurgusal bir SAS belirteci eklenir.A fictitious SAS token is appended to the end of the container URL.

azcopy copy "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

SAS belirteçleri ve nasıl elde edileceği hakkında daha fazla bilgi edinmek için bkz. paylaşılan erişim Imzalarını kullanma (SAS).To learn more about SAS tokens and how to obtain one, see Using shared access signatures (SAS).

Veri aktarmaTransfer data

Kimliğinizi yetkilendirdikten veya bir SAS belirteci elde ettikten sonra, veri aktarmaya başlayabilirsiniz.After you've authorized your identity or obtained a SAS token, you can begin transferring data.

Örnek komutları bulmak için Bu makalelerden birine bakın.To find example commands, see any of these articles.

HizmetService MakaleArticle
Azure Blob DepolamaAzure Blob Storage Azure Blob depolama alanına dosya yüklemeUpload files to Azure Blob Storage

Blob 'ları Azure Blob depolamadan indirinDownload blobs from Azure Blob Storage

Blob 'ları Azure depolama hesapları arasında kopyalamaCopy blobs between Azure storage accounts

Azure Blob depolama ile eşitlemeyiSynchronize with Azure Blob Storage
Azure DosyalarıAzure Files AzCopy ve dosya depolama ile verileri aktarmaTransfer data with AzCopy and file storage
Amazon S3Amazon S3 AzCopy ve Amazon S3 demetleri ile veri aktarmaTransfer data with AzCopy and Amazon S3 buckets
Azure Stack depolamaAzure Stack storage AzCopy ve Azure Stack Storage ile veri aktarımıTransfer data with AzCopy and Azure Stack storage

Betikte kullanmaUse in a script

Zaman içinde, AzCopy indirme bağlantısı , AzCopy 'in yeni sürümlerini işaret edecektir.Over time, the AzCopy download link will point to new versions of AzCopy. Betiğinizin AzCopy 'i İndirmeleri durumunda AzCopy 'in daha yeni bir sürümü betiğinizin bağımlı olduğu özellikleri değiştirirse betik çalışmayı durdurabilir.If your script downloads AzCopy, the script might stop working if a newer version of AzCopy modifies features that your script depends upon.

Bu sorunlardan kaçınmak için, AzCopy 'in geçerli sürümüne bir statik (değişmeyen) bağlantı alın.To avoid these issues, obtain a static (unchanging) link to the current version of AzCopy. Bu şekilde, komut dosyası her çalıştığında AzCopy 'in aynı tam sürümünü indirir.That way, your script downloads the same exact version of AzCopy each time that it runs.

Bağlantıyı almak için şu komutu çalıştırın:To obtain the link, run this command:

İşletim sistemiOperating system KomutCommand
LinuxLinux curl -s -D- https://aka.ms/downloadazcopy-v10-linux | grep ^Location
WindowsWindows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).headers.location

Not

Linux için --strip-components=1 tar komutta, sürüm adını içeren en üst düzey klasörü kaldırır ve bunun yerine ikili dosya doğrudan geçerli klasöre ayıklar.For Linux, --strip-components=1 on the tar command removes the top-level folder that contains the version name, and instead extracts the binary directly into the current folder. Bu, betiğin azcopy yalnızca URL 'yi güncelleştirerek yeni bir sürümüyle güncelleştirilmesini sağlar wget .This allows the script to be updated with a new version of azcopy by only updating the wget URL.

URL Bu komutun çıktısında görüntülenir.The URL appears in the output of this command. Komut dosyası daha sonra bu URL 'YI kullanarak AzCopy 'i indirebilir.Your script can then download AzCopy by using that URL.

İşletim sistemiOperating system KomutCommand
LinuxLinux wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1
WindowsWindows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

SAS belirteçlerinde kaçış özel karakterleriEscape special characters in SAS tokens

Uzantısı olan toplu iş dosyalarında .cmd % SAS belirteçlerinde görünen karakterleri atlamanız gerekir.In batch files that have the .cmd extension, you'll have to escape the % characters that appear in SAS tokens. Bunu, % SAS belirteç dizesindeki mevcut karakterlerin yanına ek bir karakter ekleyerek yapabilirsiniz % .You can do that by adding an additional % character next to existing % characters in the SAS token string.

Jenkins kullanarak betikleri çalıştırmaRun scripts by using Jenkins

Komut dosyalarını çalıştırmak için Jenkins kullanmayı planlıyorsanız, aşağıdaki komutu betiğin başına yerleştirdiğinizden emin olun.If you plan to use Jenkins to run scripts, make sure to place the following command at the beginning of the script.

/usr/bin/keyctl new_session

Azure Depolama Gezgini ' de kullanınUse in Azure Storage Explorer

Depolama Gezgini , tüm veri aktarımı işlemlerini gerçekleştirmek Için AzCopy kullanır.Storage Explorer uses AzCopy to perform all of its data transfer operations. AzCopy 'in performans avantajlarından yararlanmak istiyorsanız Depolama Gezgini kullanabilirsiniz, ancak dosyalarınızda etkileşim kurmak için komut satırı yerine bir grafik kullanıcı arabirimi kullanmayı tercih edersiniz.You can use Storage Explorer if you want to leverage the performance advantages of AzCopy, but you prefer to use a graphical user interface rather than the command line to interact with your files.

Depolama Gezgini, işlemleri gerçekleştirmek için hesap anahtarınızı kullanır, bu nedenle Depolama Gezgini oturum açtıktan sonra, ek yetkilendirme kimlik bilgileri sağlamanız gerekmez.Storage Explorer uses your account key to perform operations, so after you sign into Storage Explorer, you won't need to provide additional authorization credentials.

Yapılandırma, iyileştirme ve çözmeConfigure, optimize, and fix

Bkz. AzCopy 'ı yapılandırma, iyileştirme ve sorun gidermeSee Configure, optimize, and troubleshoot AzCopy

Önceki bir sürümü kullanUse a previous version

AzCopy 'in önceki sürümünü kullanmanız gerekirse, aşağıdaki bağlantılardan birine bakın:If you need to use the previous version of AzCopy, see either of the following links:

Sonraki adımlarNext steps

Sorularınız, sorunlarınız veya genel geri bildiriminiz varsa bunları GitHub sayfasına gönderin.If you have questions, issues, or general feedback, submit them on GitHub page.