Dela via


Kom igång med AzCopy

AzCopy är ett kommandoradsverktyg som du kan använda för att kopiera data till, från eller mellan lagringskonton. Den här artikeln hjälper dig att ladda ned AzCopy, ansluta till ditt lagringskonto och sedan överföra data.

AzCopy V10 är den version av AzCopy som stöds för närvarande. Det stöds endast på versioner av Windows, Linux eller macOS som underhålls officiellt. Om du behöver använda en tidigare version av AzCopy kan du läsa avsnittet Använd den tidigare versionen av AzCopy i den här artikeln.

Användningsfall för AzCopy

Använd AzCopy för att kopiera dina data till, från eller mellan Azure Storage-konton. Vanliga användningsfall är:

  • Kopiera data från en lokal källa till ett Azure Storage-konto
  • Kopiera data från ett Azure Storage-konto till en lokal källa
  • Kopiera data från ett lagringskonto till ett annat lagringskonto

AzCopy stöder varje användningsfall med kommandon och alternativ. AzCopy har till exempel inbyggda kommandon för att kopiera eller synkronisera data. Det här stödet gör AzCopy till ett flexibelt verktyg som du kan använda för engångskopieringsaktiviteter och pågående synkroniseringsscenarier. Du kan rikta in dig på specifika lagringstjänster, till exempel Azure Blob Storage eller Azure Files, och du kan även kopiera mellan dem. Du kan till exempel kopiera data från Azure Blob Storage-containrar till Azure-filresurser eller vice versa.

En fullständig lista över guider för dataöverföring finns i avsnittet Överföra data i den här artikeln.

Hämta AzCopy

Om du använder AzCopy på en Linux-dator kan du använda en pakethanterare. Ladda ned en bärbar binär fil för alla andra operativsystem. Detaljerad information om AzCopy-versioner finns på azcopy-versionssidan.

Använda en pakethanterare (endast Linux)

Att installera AzCopy via Linux-distributionens pakethanterare är det mest praktiska och underhållsbara sättet att hämta det här verktyget. Installationen av Pakethanteraren omfattar automatisk beroendematchning, förenklade uppdateringar och integrering med systemets programvaruhantering. Stegvisa anvisningar finns i Installera AzCopy på Linux med hjälp av en pakethanterare.

Ladda ned en bärbar binär fil

Ett installationspaket är endast tillgängligt för Linux. För alla andra operativsystem kan du ladda ned den körbara filen AzCopy V10 till valfri katalog på datorn.

Dessa filer komprimeras som en zip-fil (Windows och Mac) eller en tjärfil (Linux). Information om hur du laddar ned och dekomprimera tar-filen på Linux finns i dokumentationen för din Linux-distribution.

Anmärkning

Om du vill kopiera data till och från Azure Table Storage-tjänsten installerar du AzCopy version 7.3.

Lägg till AzCopy i systemets sökväg

För enkelhetens skull bör du överväga att lägga till katalogplatsen för den körbara AzCopy-filen i systemsökvägen. På så sätt kan du skriva azcopy från valfri katalog i systemet. Om du inte lägger till AzCopy-katalogen i sökvägen måste du byta katalog till platsen för den körbara AzCopy-filen och skriva in azcopy eller .\azcopy i ett kommandoskal.

Auktorisera AzCopy

Som ägare av ditt Azure Storage-konto tilldelas du inte automatiskt behörighet att komma åt data. Innan du kan göra något meningsfullt med AzCopy måste du bestämma hur du ska ange autentiseringsuppgifter för auktorisering till lagringstjänsten. Du kan ange autentiseringsuppgifter med hjälp av Microsoft Entra-ID eller med hjälp av en SAS-token.

Auktorisera med Microsoft Entra ID

Genom att använda Microsoft Entra-ID kan du ange autentiseringsuppgifter en gång i stället för att behöva lägga till en SAS-token i varje kommando. Börja med att välja vilken typ av säkerhetsobjekt du vill auktorisera. Använd följande tabell som en guide.

Säkerhetsprincip Vägledning
Användaridentitet Auktorisera åtkomst för AzCopy med en användaridentitet
Hanterad identitet Auktorisera åtkomst för AzCopy med en hanterad identitet
Service Principal Auktorisera åtkomst för AzCopy med tjänstens huvudnamn

Auktorisera med en SAS-token

Du kan lägga till en SAS-token till varje käll- eller mål-URL som du använder i dina AzCopy-kommandon. Det här exempelkommandot kopierar rekursivt data från en lokal katalog till en blobcontainer. En fiktiv SAS-token läggs till i slutet av containerns 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).

Överför data

När du har auktorisera din identitet eller skaffat en SAS-token kan du börja överföra data.

Exempelkommandon finns i någon av dessa artiklar.

Tjänster Artikel
Azure Blob Storage-lagringstjänst Ladda upp filer till Azure Blob Storage
Azure Blob Storage-lagringstjänst Ladda ned blobar från Azure Blob Storage
Azure Blob Storage-lagringstjänst Kopiera blobar mellan Azure-lagringskonton
Azure Blob Storage-lagringstjänst Synkronisera med Azure Blob Storage
Azure Files Överföring av data med AzCopy och lagring av filer
Amazon S3 Kopiera data från Amazon S3 till Azure Storage
Google Cloud Storage Kopiera data från Google Cloud Storage till Azure Storage (förhandsversion)
Azure Stack-lagring Överföra data med AzCopy och Azure Stack Storage

Du kan köra AzCopy-kommandon interaktivt. Du kan också införliva AzCopy i automatiserade skript för batchåtgärder, schemalagda dataöverföringar eller pipelines för kontinuerlig integrering. Mer information finns i Använda AzCopy i skript och schemalagda överföringar.

Anmärkning

AzCopy stöder inte scenarier där källan eller målet ändras aktivt under överföringen.

Hämta kommandohjälp

Om du vill se en lista över kommandon skriver azcopy -h du och trycker sedan på RETUR-tangenten.

Om du vill veta mer om ett specifikt kommando tar du med namnet på kommandot (till exempel: azcopy list -h).

Inbäddad hjälp

Lista över kommandon

I följande tabell visas alla AzCopy v10-kommandon. Varje kommando länkar till en referensartikel.

Kommando beskrivning
azcopy bänk Kör ett prestandamått genom att ladda upp eller ladda ned testdata till eller från en angiven plats.
azcopy copy Kopierar källdata till en målplats
azcopy doc Genererar dokumentation för verktyget i Markdown-format.
azcopy env Visar de miljövariabler som kan konfigurera AzCopys beteende.
azcopy-jobb Underkommandon relaterade till att hantera jobb.
azcopy-jobb rensas Tar bort alla logg- och planfiler för alla jobb.
azcopy-jobblista Visar information om alla jobb.
azcopy-jobb ta bort Tar bort alla filer som är associerade med det angivna jobb-ID:t.
azcopy-jobb återupptas Återupptar det befintliga jobbet med det angivna jobb-ID:t.
azcopy-jobb visar Visar detaljerad information för det angivna jobb-ID:t.
azcopy-lista Visar entiteterna i en viss resurs.
azcopy-inloggning Loggar in på Microsoft Entra-ID för att få åtkomst till Azure Storage-resurser.
azcopy-inloggningsstatus Visar entiteterna i en viss resurs.
azcopy-utloggning Loggar ut användaren och avslutar åtkomsten till Azure Storage-resurser.
azcopy make Skapar en container eller fildelning.
azcopy remove Tar bort blobar eller filer från ett Azure Storage-konto.
azcopy-synkronisering Replikerar källplatsen till destinationsplatsen.
azcopy set-properties Ändrar åtkomstnivån för en eller flera blobar och ersätter (skriver över) metadata och indextaggar för en eller flera blobar.

Anmärkning

AzCopy har inget kommando för att byta namn på filer.

Konfigurera, optimera och åtgärda

Se någon av följande resurser:

Använd en tidigare version (inaktuell)

Om du behöver använda en tidigare version av AzCopy kan du läsa någon av följande länkar:

Anmärkning

Dessa versioner av AzCopy är inaktuella. Microsoft rekommenderar att du använder AzCopy v10.

Nästa steg

Om du har frågor, problem eller allmän feedback skickar du dem på GitHub.