Kom igång med AzCopyGet started with AzCopy

AzCopy är ett kommandoradsverktyg som du kan använda för att kopiera blobar eller filer till eller från ett lagringskonto.AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. Den här artikeln hjälper dig att ladda ned AzCopy, ansluta till ditt lagringskonto och sedan överföra filer.This article helps you download AzCopy, connect to your storage account, and then transfer files.

Anteckning

AzCopy v10 är den version av AzCopy som stöds för tillfället.AzCopy V10 is the currently supported version of AzCopy.

Om du behöver använda en tidigare version av AzCopy kan du läsa avsnittet använda den tidigare versionen av AzCopy i den här artikeln.If you need to use a previous version of AzCopy, see the Use the previous version of AzCopy section of this article.

Ladda ned AzCopyDownload AzCopy

Börja med att ladda ned den körbara filen AzCopy v10 till valfri katalog på datorn.First, download the AzCopy V10 executable file to any directory on your computer. AzCopy v10 är bara en körbar fil, så det finns inget att installera.AzCopy V10 is just an executable file, so there's nothing to install.

Filerna komprimeras som en zip-fil (Windows och Mac) eller en tar-fil (Linux).These files are compressed as a zip file (Windows and Mac) or a tar file (Linux). Information om hur du laddar ned och dekomprimerar filen tar i Linux finns i dokumentationen för din Linux-distribution.To download and decompress the tar file on Linux, see the documentation for your Linux distribution.

Anteckning

Om du vill kopiera data till och från Azure Table Storage -tjänsten installerar du AzCopy version 7,3.If you want to copy data to and from your Azure Table storage service, then install AzCopy version 7.3.

Köra AzCopyRun AzCopy

Det blir enklare om du lägger till katalogplatsen för den körbara AzCopy-filen i din systemsökväg.For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. På så sätt kan du skriva azcopy från valfri katalog i systemet.That way you can type azcopy from any directory on your system.

Om du väljer att inte lägga till katalogen AzCopy i sökvägen måste du ändra katalogerna till platsen för din AzCopy-körbara fil och skriva azcopy eller .\azcopy i Windows PowerShell-Kommandotolken.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.

Om du vill se en lista över kommandon skriver du azcopy -h och trycker sedan på RETUR-tangenten.To see a list of commands, type azcopy -h and then press the ENTER key.

Om du vill veta mer om ett speciellt kommando inkluderar du bara namnet på kommandot (till exempel: azcopy list -h ).To learn about a specific command, just include the name of the command (For example: azcopy list -h).

Infogad hjälpInline help

För att hitta detaljerad referens dokumentation för varje kommando och kommando parameter, se AzCopyTo find detailed reference documentation for each command and command parameter, see azcopy

Anteckning

Som ägare till ditt Azure Storage-konto tilldelas du inte automatiskt behörigheter för åtkomst till data.As an owner of your Azure Storage account, you aren't automatically assigned permissions to access data. Innan du kan göra allt meningsfullt med AzCopy måste du bestämma hur du ska ange autentiseringsuppgifter för lagrings tjänsten.Before you can do anything meaningful with AzCopy, you need to decide how you'll provide authorization credentials to the storage service.

Auktorisera AzCopyAuthorize AzCopy

Du kan ange autentiseringsuppgifter för auktorisering genom att använda Azure Active Directory (AD) eller genom att använda en SAS-token (signatur för delad åtkomst).You can provide authorization credentials by using Azure Active Directory (AD), or by using a Shared Access Signature (SAS) token.

Använd den här tabellen som en guide:Use this table as a guide:

LagringstypStorage type För närvarande stöds metoden för auktoriseringCurrently supported method of authorization
Blob StorageBlob storage Azure AD och SASAzure AD & SAS
Blob Storage (hierarkiskt namn område)Blob storage (hierarchical namespace) Azure AD och SASAzure AD & SAS
File StorageFile storage Endast SASSAS only

Alternativ 1: Använd Azure Active DirectoryOption 1: Use Azure Active Directory

Det här alternativet är endast tillgängligt för Blob Storage.This option is available for blob Storage only. Med hjälp av Azure Active Directory kan du ange autentiseringsuppgifter en gång i stället för att behöva lägga till en SAS-token i varje kommando.By using Azure Active Directory, you can provide credentials once instead of having to append a SAS token to each command.

Anteckning

Om du planerar att kopiera blobbar mellan lagrings konton i den aktuella versionen måste du lägga till en SAS-token till varje käll-URL.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. Du kan bara utelämna SAS-token från mål-URL: en.You can omit the SAS token only from the destination URL. Exempel finns i Kopiera blobbar mellan lagrings konton.For examples, see Copy blobs between storage accounts.

Information om hur du auktoriserar åtkomst med hjälp av Azure AD finns i bevilja åtkomst till blobbar med AzCopy och Azure Active Directory (Azure AD).To authorize access by using Azure AD, see Authorize access to blobs with AzCopy and Azure Active Directory (Azure AD).

Alternativ 2: Använd en SAS-tokenOption 2: Use a SAS token

Du kan lägga till en SAS-token för varje käll-eller mål-URL som används i dina AzCopy-kommandon.You can append a SAS token to each source or destination URL that use in your AzCopy commands.

Det här exempel kommandot kopierar data rekursivt från en lokal katalog till en BLOB-behållare.This example command recursively copies data from a local directory to a blob container. En fiktiv SAS-token läggs till i slutet av behållar-URL: en.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

Mer information om SAS-token och hur du hämtar en finns i använda signaturer för delad åtkomst (SAS).To learn more about SAS tokens and how to obtain one, see Using shared access signatures (SAS).

Överföra dataTransfer data

När du har auktoriserat din identitet eller fått en SAS-token kan du börja överföra data.After you've authorized your identity or obtained a SAS token, you can begin transferring data.

Du hittar exempel kommandon i någon av de här artiklarna.To find example commands, see any of these articles.

TjänstService ArtikelArticle
Azure Blob StorageAzure Blob Storage Ladda upp filer till Azure Blob StorageUpload files to Azure Blob Storage

Ladda ned blobbar från Azure Blob StorageDownload blobs from Azure Blob Storage

Kopiera blobbar mellan Azure Storage-kontonCopy blobs between Azure storage accounts

Synkronisera med Azure Blob StorageSynchronize with Azure Blob Storage
Azure FilesAzure Files Överföra data med AzCopy och fillagringTransfer data with AzCopy and file storage
Amazon S3Amazon S3 Överföra data med AzCopy och Amazon S3-bucketsTransfer data with AzCopy and Amazon S3 buckets
Azure Stack lagringAzure Stack storage Överföra data med AzCopy och Azure Stack StorageTransfer data with AzCopy and Azure Stack storage

Använd i ett skriptUse in a script

Med tiden kommer nedladdnings länken för AzCopy att peka på nya versioner av AzCopy.Over time, the AzCopy download link will point to new versions of AzCopy. Om skriptet laddar ned AzCopy kan skriptet sluta fungera om en nyare version av AzCopy ändrar de funktioner som skriptet är beroende av.If your script downloads AzCopy, the script might stop working if a newer version of AzCopy modifies features that your script depends upon.

Undvik dessa problem genom att hämta en statisk (oförändrad) länk till den aktuella versionen av AzCopy.To avoid these issues, obtain a static (unchanging) link to the current version of AzCopy. På så sätt laddar skriptet ned samma exakta version av AzCopy varje gång den körs.That way, your script downloads the same exact version of AzCopy each time that it runs.

Hämta länken genom att köra det här kommandot:To obtain the link, run this command:

OperativsystemOperating system KommandoCommand
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

Anteckning

För Linux --strip-components=1 tar tar kommandot bort den översta mappen som innehåller versions namnet för Linux och extraherar i stället binärfilen direkt till den aktuella mappen.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. Detta gör att skriptet kan uppdateras med en ny version av azcopy genom att bara uppdatera wget URL: en.This allows the script to be updated with a new version of azcopy by only updating the wget URL.

URL: en visas i kommandots utdata.The URL appears in the output of this command. Skriptet kan sedan hämta AzCopy med hjälp av den URL: en.Your script can then download AzCopy by using that URL.

OperativsystemOperating system KommandoCommand
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>>

Escape-specialtecken i SAS-tokenEscape special characters in SAS tokens

I kommandofiler med .cmd tillägget måste du undanta de % tecken som visas i SAS-token.In batch files that have the .cmd extension, you'll have to escape the % characters that appear in SAS tokens. Du kan göra det genom att lägga till ytterligare ett % tecken bredvid befintliga % tecken i SAS token-strängen.You can do that by adding an additional % character next to existing % characters in the SAS token string.

Köra skript med JenkinsRun scripts by using Jenkins

Om du planerar att använda Jenkins för att köra skript, se till att placera följande kommando i början av skriptet.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

Använd i Azure Storage ExplorerUse in Azure Storage Explorer

Storage Explorer använder AzCopy för att utföra alla dess data överförings åtgärder.Storage Explorer uses AzCopy to perform all of its data transfer operations. Du kan använda Storage Explorer om du vill dra nytta av prestanda fördelarna med AZCopy, men du föredrar att använda ett grafiskt användar gränssnitt i stället för kommando raden för att interagera med dina filer.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.

Storage Explorer använder din konto nyckel för att utföra åtgärder, så när du har loggat in på Storage Explorer behöver du inte ange ytterligare autentiseringsuppgifter för auktorisering.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.

Konfigurera, optimera och åtgärdaConfigure, optimize, and fix

Se Konfigurera, optimera och felsöka AzCopySee Configure, optimize, and troubleshoot AzCopy

Använd en tidigare versionUse a previous version

Om du behöver använda den tidigare versionen av AzCopy, se någon av följande länkar:If you need to use the previous version of AzCopy, see either of the following links:

Nästa stegNext steps

Om du har frågor, problem eller allmän feedback kan du skicka dem till GitHub -sidan.If you have questions, issues, or general feedback, submit them on GitHub page.