Aan de slag met AzCopy

AzCopy is een opdrachtregelprogramma dat u kunt gebruiken om gegevens te kopiëren naar, van of tussen opslagaccounts. In dit artikel leest u hoe u AzCopy downloadt, verbinding maakt met uw opslagaccount en vervolgens gegevens overdraagt.

AzCopy V10 is de momenteel ondersteunde versie van AzCopy. Het wordt alleen ondersteund in versies van Windows, Linux of macOS die officieel worden onderhouden. Als u een eerdere versie van AzCopy wilt gebruiken, raadpleegt u de sectie De vorige versie van AzCopy van dit artikel gebruiken.

AzCopy-gebruiksscenario's

Gebruik AzCopy om uw gegevens te kopiëren naar, van of tussen Azure-opslagaccounts. Veelvoorkomende gebruiksvoorbeelden zijn:

• Gegevens kopiëren van een on-premises bron naar een Azure-opslagaccount
• Gegevens kopiëren van een Azure-opslagaccount naar een on-premises bron
• Gegevens kopiëren van het ene opslagaccount naar een ander opslagaccount

AzCopy ondersteunt elke use-case met opdrachten en opties. AzCopy heeft bijvoorbeeld systeemeigen opdrachten voor het kopiëren of synchroniseren van gegevens. Deze ondersteuning maakt AzCopy een flexibel hulpprogramma dat u kunt gebruiken voor eenmalige kopieeractiviteiten en lopende synchronisatiescenario's. U kunt zich richten op specifieke opslagservices, zoals Azure Blob Storage of Azure Files, en u kunt er ook tussen kopiëren. U kunt bijvoorbeeld gegevens uit Azure Blob Storage-containers kopiëren naar Azure-bestandsshares of omgekeerd.

Zie de sectie Gegevens overdragen van dit artikel voor een volledige lijst met handleidingen voor gegevensoverdracht .

AzCopy ophalen

Als u AzCopy op een Linux-computer gebruikt, kunt u pakketbeheer gebruiken. Download voor alle andere besturingssystemen een draagbaar binair bestand. Zie de releasepagina van AzCopy voor gedetailleerde informatie over AzCopy-releases.

Een pakketbeheer gebruiken (alleen Linux)

Het installeren van AzCopy via pakketbeheer van uw Linux-distributie is de handigste en onderhoudbare manier om dit hulpprogramma te verkrijgen. De installatie van Package Manager omvat automatische afhankelijkheidsoplossing, vereenvoudigde updates en integratie met softwarebeheer van uw systeem. Zie AzCopy installeren in Linux met behulp van pakketbeheer voor stapsgewijze instructies.

Een draagbaar binair bestand downloaden

Er is alleen een installatiepakket beschikbaar voor Linux. Voor alle andere besturingssystemen kunt u het uitvoerbare bestand AzCopy V10 downloaden naar elke map op uw computer.

• Windows 64-bits (zip)
• Windows 32-bits (zip)
• Windows ARM64 (zip)
• Linux x86-64 (tar)
• Linux ARM64 (teer)
• macOS (zip)
• macOS ARM64 (zip)

Deze bestanden worden gecomprimeerd als een zip-bestand (Windows en Mac) of een tar-bestand (Linux). Als u het tar-bestand op Linux wilt downloaden en decomprimeren, raadpleegt u de documentatie voor uw Linux-distributie.

AzCopy toevoegen aan uw systeempad

Voor het gemak kunt u de maplocatie van het uitvoerbare AzCopy-bestand toevoegen aan uw systeempad. Op die manier kunt u vanuit elke map op uw systeem azcopy typen. Als u de AzCopy-map niet aan uw pad toevoegt, moet u naar de locatie van uw AzCopy-uitvoerbare bestand navigeren en azcopy of .\azcopy in een opdrachtprompt typen.

AzCopy autoriseren

Als eigenaar van uw Azure Storage-account worden niet automatisch machtigingen toegewezen voor toegang tot gegevens. Voordat u iets zinvols met AzCopy kunt doen, moet u beslissen hoe u autorisatiereferenties voor de opslagservice opgeeft. U kunt referenties opgeven met behulp van Microsoft Entra-id of met behulp van een SAS-token.

Autoriseer met Microsoft Entra ID

Met behulp van Microsoft Entra ID kunt u referenties één keer opgeven in plaats van een SAS-token toe te voegen aan elke opdracht. Kies eerst welk type beveiligingsprincipaal u wilt autoriseren. Gebruik de volgende tabel als richtlijn.

Autoriseren met een SAS-token

U kunt een SAS-token toevoegen aan elke bron- of doel-URL die u in uw AzCopy-opdrachten gebruikt. Met deze voorbeeldopdracht worden recursief gegevens gekopieerd uit een lokale map naar een blobcontainer. Aan het einde van de container-URL wordt een fictief SAS-token toegevoegd.

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

Zie Shared Access Signatures (SAS) gebruiken voor meer informatie over SAS-tokens en hoe u er een kunt verkrijgen.

Gegevens overdragen

Nadat u uw identiteit hebt geautoriseerd of een SAS-token hebt verkregen, kunt u beginnen met het overdragen van gegevens.

Zie voor voorbeeldcommando's een van deze artikelen.

U kunt AzCopy-opdrachten interactief uitvoeren. U kunt AzCopy ook opnemen in geautomatiseerde scripts voor batchbewerkingen, geplande gegevensoverdrachten of pijplijnen voor continue integratie. Zie AzCopy gebruiken in scripts en geplande overdrachten voor meer informatie.

Help voor opdrachten ophalen

Als u een lijst met opdrachten wilt zien, typt u azcopy -h en drukt u op de Enter-toets.

Als u meer wilt weten over een specifieke opdracht, neemt u de naam van de opdracht op (bijvoorbeeld: azcopy list -h).

Lijst met opdrachten

De volgende tabel bevat alle AzCopy v10-opdrachten. Elke opdracht wordt gekoppeld aan een naslagartikel.

Configureren, optimaliseren en oplossen

Bekijk een van de volgende bronnen:

• AzCopy-configuratie-instellingen

• De prestaties van AzCopy optimaliseren

• Fouten zoeken en taken hervatten met behulp van logboek- en planbestanden in AzCopy

• Problemen met AzCopy v10 oplossen

Een vorige versie gebruiken (afgeschaft)

Als u een eerdere versie van AzCopy wilt gebruiken, raadpleegt u een van de volgende koppelingen:

• AzCopy in Windows (v8)

• AzCopy in Linux (v7)

Volgende stappen

Als u vragen, problemen of algemene feedback hebt, dient u deze in op GitHub.