Gegevens overdragen met AzCopy en bestandsopslag

  • Artikel

AzCopy is een opdrachtregelprogramma dat u kunt gebruiken om bestanden te kopiëren naar of vanuit een opslagaccount. Dit artikel bevat voorbeeldopdrachten die werken met Azure Files.

Aan de slag

Zie het artikel Aan de slag met AzCopy om AzCopy te downloaden en meer te weten te komen over de manieren waarop u autorisatiereferenties kunt opgeven voor de opslagservice.

Notitie

In de voorbeelden in dit artikel ziet u het gebruik van een SAS-token om toegang te autoriseren. Voor opdrachten die zijn gericht op bestanden en mappen, kunt u nu autorisatiereferenties opgeven met behulp van Microsoft Entra ID en het SAS-token weglaten van deze opdrachten. U moet nog steeds een SAS-token gebruiken in een opdracht die alleen gericht is op de bestandsshare of het account (bijvoorbeeld: 'azcopy make https://mystorageaccount.file.core.windows.net/myfileshare' of 'azcopy copy 'https://mystorageaccount.file.core.windows.net'.

Zie AzCopy autoriseren voor meer informatie.

Bestandsshares maken

U kunt de opdracht azcopy make gebruiken om een bestandsshare te maken. In het voorbeeld in deze sectie wordt een bestandsshare gemaakt met de naam myfileshare.

Tip

In dit voorbeeld worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Syntaxis

azcopy make 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>'

Voorbeeld

azcopy make 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D'

Zie azcopy make voor gedetailleerde referentiedocumenten.

Bestanden uploaden

U kunt de opdracht azcopy copy gebruiken om bestanden en mappen vanaf uw lokale computer te uploaden.

Tip

In de voorbeelden in deze sectie worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Deze sectie bevat de volgende voorbeelden:

  • Een bestand uploaden
  • Een map uploaden
  • De inhoud van een map uploaden
  • Een specifiek bestand uploaden

Tip

U kunt uw uploadbewerking aanpassen met behulp van optionele vlaggen. Hier volgen enkele voorbeelden.

Scenario Vlag
Kopieer toegangsbeheerlijsten (ACL's) samen met de bestanden. --preserve-smb-permissions=[true|false]
Kopieer informatie over de SMB-eigenschap samen met de bestanden. --preserve-smb-info=[true|false]

Zie de opties voor een volledige lijst.

Notitie

AzCopy berekent en slaat de md5-hashcode van het bestand niet automatisch op voor een bestand dat groter is dan 256 MB. Als u wilt dat AzCopy dit doet, voegt u de --put-md5 vlag toe aan elke kopieeropdracht. Op die manier berekent AzCopy wanneer het bestand wordt gedownload een MD5-hash voor gedownloade gegevens en controleert of de MD5-hash die is opgeslagen in de eigenschap van Content-md5 het bestand overeenkomt met de berekende hash.

Een bestand uploaden

Syntaxis

azcopy copy '<local-file-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-name>'

Voorbeeld

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --preserve-smb-permissions=true --preserve-smb-info=true

U kunt een bestand ook uploaden met behulp van een jokerteken (*) ergens in het bestandspad of de bestandsnaam. Bijvoorbeeld: 'C:\myDirectory\*.txt', of C:\my*\*.txt.

Een map uploaden

In dit voorbeeld wordt een map (met alle bestanden in de map) gekopieerd naar een bestandsshare. Het resultaat is een map in de bestandsshare met dezelfde naam.

Syntaxis

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Voorbeeld

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Als u naar een map in de bestandsshare wilt kopiëren, geeft u de naam van die map op in de opdrachtreeks.

Voorbeeld

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Als u de naam opgeeft van een map die niet in de bestandsshare bestaat, maakt AzCopy een nieuwe map op basis van die naam.

De inhoud van een map uploaden

U kunt de inhoud van een map uploaden zonder de map zelf te kopiëren met behulp van het jokerteken (*).

Syntaxis

azcopy copy '<local-directory-path>/*' 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>'

Voorbeeld

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Notitie

Voeg de --recursive vlag toe om bestanden in alle submappen te uploaden.

Specifieke bestanden uploaden

U kunt specifieke bestanden uploaden met volledige bestandsnamen, gedeeltelijke namen met jokertekens (*) of door datums en tijden te gebruiken.

Meerdere volledige bestandsnamen opgeven

Gebruik de opdracht azcopy copy met de --include-path optie. Afzonderlijke bestandsnamen scheiden met behulp van een puntkomma (;).

Syntaxis

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-path <semicolon-separated-file-list>

Voorbeeld

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-path 'photos;documents\myFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

In dit voorbeeld draagt AzCopy de C:\myDirectory\photos map en het C:\myDirectory\documents\myFile.txt bestand over. U moet de --recursive optie opnemen om alle bestanden in de C:\myDirectory\photos map over te dragen.

U kunt bestanden ook uitsluiten met behulp van de --exclude-path optie. Zie azcopy copy reference docs voor meer informatie.

Jokertekens gebruiken

Gebruik de opdracht azcopy copy met de --include-pattern optie. Geef gedeeltelijke namen op die de jokertekens bevatten. Scheid namen met behulp van een puntkomma (;).

Syntaxis

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

Voorbeeld

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-pattern 'myFile*.txt;*.pdf*' --preserve-smb-permissions=true --preserve-smb-info=true

U kunt bestanden ook uitsluiten met behulp van de --exclude-pattern optie. Zie azcopy copy reference docs voor meer informatie.

De --include-pattern opties zijn --exclude-pattern alleen van toepassing op bestandsnamen en niet op het pad. Als u alle tekstbestanden in een mapstructuur wilt kopiëren, gebruikt u de --recursive optie om de hele mapstructuur op te halen en gebruikt u vervolgens de --include-pattern en geef *.txt deze op om alle tekstbestanden op te halen.

Bestanden uploaden die zijn gewijzigd na een datum en tijd

Gebruik de opdracht azcopy copy met de --include-after optie. Geef een datum en tijd op in ISO 8601-indeling (bijvoorbeeld: 2020-08-19T15:04:00Z).

Syntaxis

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' --include-after <Date-Time-in-ISO-8601-format>

Voorbeeld

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --include-after '2020-08-19T15:04:00Z' --preserve-smb-permissions=true --preserve-smb-info=true

Zie de referentiedocumenten voor azcopy-kopieën voor gedetailleerde naslaginformatie.

Bestanden downloaden

U kunt de opdracht azcopy copy gebruiken om bestanden, mappen en bestandsshares te downloaden naar uw lokale computer.

Tip

In de voorbeelden in deze sectie worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Deze sectie bevat de volgende voorbeelden:

  • Een bestand downloaden
  • Een map downloaden
  • De inhoud van een map downloaden
  • Specifieke bestanden downloaden

Tip

U kunt uw downloadbewerking aanpassen met behulp van optionele vlaggen. Enkele voorbeelden:

Scenario Vlag
Kopieer toegangsbeheerlijsten (ACL's) samen met de bestanden. --preserve-smb-permissions=[true|false]
Kopieer informatie over de SMB-eigenschap samen met de bestanden. --preserve-smb-info=[true|false]
Bestanden automatisch decomprimeren. --Decomprimeren

Zie de opties voor een volledige lijst.

Notitie

Als de Content-md5 eigenschapswaarde van een bestand een hash bevat, berekent AzCopy een MD5-hash voor gedownloade gegevens en controleert of de MD5-hash die is opgeslagen in de eigenschap van Content-md5 het bestand overeenkomt met de berekende hash. Als deze waarden niet overeenkomen, mislukt het downloaden, tenzij u dit gedrag overschrijft door de kopieeropdracht toe te voegen --check-md5=NoCheck of --check-md5=LogOnly te kopiëren.

Een bestand downloaden

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>' '<local-file-path>'

Voorbeeld

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory\myTextFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

Een map downloaden

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>' '<local-directory-path>' --recursive

Voorbeeld

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory'  --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Dit voorbeeld resulteert in een map met de naam C:\myDirectory\myFileShareDirectory die alle gedownloade bestanden bevat.

De inhoud van een map downloaden

U kunt de inhoud van een map downloaden zonder de map waar de inhoud in zit te kopiëren, door het jokerteken (*) te gebruiken.

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/*<SAS-token>' '<local-directory-path>/'

Voorbeeld

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory/*?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D' 'C:\myDirectory' --preserve-smb-permissions=true --preserve-smb-info=true

Notitie

Voeg de --recursive vlag toe om bestanden in alle submappen te downloaden.

Specifieke bestanden downloaden

U kunt specifieke bestanden downloaden met volledige bestandsnamen, gedeeltelijke namen met jokertekens (*) of met datums en tijden.

Meerdere volledige bestandsnamen opgeven

Gebruik de opdracht azcopy copy met de --include-path optie. Afzonderlijke bestandsnamen scheiden met behulp van een puntkomma (;).

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' '<local-directory-path>' --include-path <semicolon-separated-file-list>

Voorbeeld

azcopy copy 'https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

In dit voorbeeld draagt AzCopy de https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos map en het https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/documents/myFile.txt bestand over. Neem de --recursive optie op om alle bestanden in de https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos map over te dragen.

U kunt bestanden ook uitsluiten met behulp van de --exclude-path optie. Zie azcopy copy reference docs voor meer informatie.

Jokertekens gebruiken

Gebruik de opdracht azcopy copy met de --include-pattern optie. Geef gedeeltelijke namen op die de jokertekens bevatten. Scheid namen met behulp van een puntkomma (;).

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name><SAS-token>' '<local-directory-path>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

Voorbeeld

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*' --preserve-smb-permissions=true --preserve-smb-info=true

U kunt bestanden ook uitsluiten met behulp van de --exclude-pattern optie. Zie azcopy copy reference docs voor meer informatie.

De --include-pattern opties zijn --exclude-pattern alleen van toepassing op bestandsnamen en niet op het pad. Als u alle tekstbestanden in een mapstructuur wilt kopiëren, gebruikt u de --recursive optie om de hele mapstructuur op te halen en gebruikt u vervolgens de --include-pattern en geef *.txt deze op om alle tekstbestanden op te halen.

Bestanden downloaden die zijn gewijzigd na een datum en tijd

Gebruik de opdracht azcopy copy met de --include-after optie. Geef een datum en tijd op in ISO-8601-indeling (bijvoorbeeld: 2020-08-19T15:04:00Z).

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-or-directory-name>/*<SAS-token>' '<local-directory-path>' --include-after <Date-Time-in-ISO-8601-format>

Voorbeeld

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/*?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory' --include-after '2020-08-19T15:04:00Z' --preserve-smb-permissions=true --preserve-smb-info=true

Zie de referentiedocumenten voor azcopy-kopieën voor gedetailleerde naslaginformatie.

Downloaden van een momentopname van een share

U kunt een specifieke versie van een bestand of map downloaden door te verwijzen naar de datum/tijd-waarde van een momentopname van een share. Zie Overzicht van momentopnamen van shares voor Azure Files voor meer informatie over momentopnamen van shares.

Syntaxis

azcopy copy 'https://<storage-account-name>.file.core.windows.net/<file-share-name>/<file-path-or-directory-name><SAS-token>&sharesnapshot=<DateTime-of-snapshot>' '<local-file-or-directory-path>'

Voorbeeld (Een bestand downloaden)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt' --preserve-smb-permissions=true --preserve-smb-info=true

Voorbeeld (Een map downloaden)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?sv=2018-03-28&ss=bjqt&srs=sco&sp=rjklhjup&se=2019-05-10T04:37:48Z&st=2019-05-09T20:37:48Z&spr=https&sig=/SOVEFfsKDqRry4bk3qz1vAQFwY5DDzp2%2B/3Eykf/JLs%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory'  --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Bestanden kopiëren tussen opslagaccounts

U kunt AzCopy gebruiken om bestanden naar andere opslagaccounts te kopiëren. De kopieerbewerking is synchroon, zodat alle bestanden worden gekopieerd wanneer de opdracht wordt geretourneerd.

AzCopy maakt gebruik van server-naar-server-API's, zodat gegevens rechtstreeks tussen opslagservers worden gekopieerd. U kunt de doorvoer van deze bewerkingen verhogen door de waarde van de AZCOPY_CONCURRENCY_VALUE omgevingsvariabele in te stellen. Zie Gelijktijdigheid verhogen voor meer informatie.

U kunt ook specifieke versies van een bestand kopiëren door te verwijzen naar de datum/tijd-waarde van een momentopname van een share. Zie Overzicht van momentopnamen van shares voor Azure Files voor meer informatie over momentopnamen van shares.

Tip

In de voorbeelden in deze sectie worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Deze sectie bevat de volgende voorbeelden:

  • Een bestand kopiëren naar een ander opslagaccount
  • Een map kopiëren naar een ander opslagaccount
  • Een bestandsshare kopiëren naar een ander opslagaccount
  • Alle bestandsshares, mappen en bestanden kopiëren naar een ander opslagaccount

Tip

U kunt de kopieerbewerking aanpassen met behulp van optionele vlaggen. Hier volgen enkele voorbeelden.

Scenario Vlag
Kopieer toegangsbeheerlijsten (ACL's) samen met de bestanden. --preserve-smb-permissions=[true|false]
Kopieer informatie over de SMB-eigenschap samen met de bestanden. --preserve-smb-info=[true|false]

Zie de opties voor een volledige lijst.

Een bestand kopiëren naar een ander opslagaccount

Syntaxis

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name>/<file-path><SAS-token>'

Voorbeeld

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Voorbeeld (momentopname delen)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --preserve-smb-permissions=true --preserve-smb-info=true

Een map kopiëren naar een ander opslagaccount

Syntaxis

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-path><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Voorbeeld

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Voorbeeld (momentopname delen)

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Een bestandsshare kopiëren naar een ander opslagaccount

Syntaxis

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Voorbeeld

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D --preserve-smb-permissions=true --preserve-smb-info=true

Voorbeeld (momentopname delen)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Alle bestandsshares, mappen en bestanden kopiëren naar een ander opslagaccount

Syntaxis

azcopy copy 'https://<source-storage-account-name>.file.core.windows.net/<SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<SAS-token>' --recursive'

Voorbeeld

azcopy copy 'https://mysourceaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Voorbeeld (momentopname delen)

azcopy copy 'https://mysourceaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Bestanden synchroniseren

U kunt de inhoud van een lokaal bestandssysteem synchroniseren met een bestandsshare of de inhoud van een bestandsshare synchroniseren met een andere bestandsshare. U kunt ook de inhoud van een map in een bestandsshare synchroniseren met de inhoud van een map die zich in een andere bestandsshare bevindt. Synchronisatie is één manier. Met andere woorden, u kiest welke van deze twee eindpunten de bron is en welke de bestemming is. Synchronisatie maakt ook gebruik van server-naar-server-API's.

Notitie

Dit scenario wordt momenteel ondersteund voor accounts die hiërarchische naamruimte hebben ingeschakeld via het blob-eindpunt.

Waarschuwing

AzCopy-synchronisatie wordt ondersteund, maar wordt niet volledig aanbevolen voor Azure Files. AzCopy-synchronisatie biedt geen ondersteuning voor differentiële kopieën op schaal en sommige beeldkwaliteit kan verloren gaan. Zie Migreren naar Azure-bestandsshares voor meer informatie.

Richtlijnen

De synchronisatieopdracht vergelijkt standaard bestandsnamen en laatst gewijzigde tijdstempels. U kunt dit gedrag overschrijven om MD5-hashes te gebruiken in plaats van de tijdstempels van de laatste wijziging door de --compare-hash vlag te gebruiken. Stel de --delete-destination optionele vlag in op een waarde van true of prompt om bestanden in de doelmap te verwijderen als deze bestanden niet meer in de bronmap voorkomen.

  • Als u de --delete-destination vlag trueinstelt op , verwijdert AzCopy bestanden zonder een prompt op te geven. Als u een prompt wilt weergeven voordat AzCopy een bestand verwijdert, stelt u de --delete-destination vlag in op prompt.

  • Als u van plan bent de --delete-destination vlag prompt in te stellen op of false, kunt u overwegen de kopieeropdracht te gebruiken in plaats van de synchronisatieopdracht en de --overwrite parameter in te stellen op ifSourceNewer. De kopieeropdracht verbruikt minder geheugen en kost minder factureringskosten omdat een kopieerbewerking de bron of het doel niet hoeft te indexeren voordat u bestanden verplaatst.

  • Als u niet van plan bent om de --compare-hash vlag te gebruiken, moet de computer waarop u de synchronisatieopdracht uitvoert een nauwkeurige systeemklok hebben omdat de laatst gewijzigde tijden essentieel zijn om te bepalen of een bestand moet worden overgedragen. Als uw systeem aanzienlijke scheeftrekken van de klok heeft, vermijdt u het wijzigen van bestanden op de bestemming te dicht bij het tijdstip waarop u een synchronisatieopdracht wilt uitvoeren.

  • AzCopy maakt gebruik van server-naar-server-API's om gegevens tussen opslagaccounts te synchroniseren. Dat betekent dat gegevens rechtstreeks tussen opslagservers worden gekopieerd. AzCopy stelt echter elke overdracht in en controleert deze, en voor grotere opslagaccounts (bijvoorbeeld accounts die miljoenen blobs bevatten), kan AzCopy een aanzienlijke hoeveelheid rekenresources vereisen om deze taken uit te voeren. Als u AzCopy uitvoert vanaf een virtuele machine (VM), moet u ervoor zorgen dat de VIRTUELE machine voldoende kernen/geheugen heeft om de belasting te verwerken.

Tip

U kunt de synchronisatiebewerking aanpassen met behulp van optionele vlaggen. Hier volgen enkele voorbeelden.

Scenario Vlag
Kopieer toegangsbeheerlijsten (ACL's) samen met de bestanden. --preserve-smb-permissions=[true|false]
Kopieer informatie over de SMB-eigenschap samen met de bestanden. --preserve-smb-info=[true|false]
Sluit bestanden uit op basis van een patroon. --exclude-path
Geef op hoe gedetailleerd uw synchronisatiegerelateerde logboekvermeldingen moeten zijn. --log-level=[WAARSCHUWING|FOUT|INFO|GEEN]

Zie de opties voor een volledige lijst.

In de voorbeelden in deze sectie worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Een bestandsshare bijwerken met wijzigingen in een lokaal bestandssysteem

In dit geval is de bestandsshare de bestemming en is het lokale bestandssysteem de bron.

Tip

In dit voorbeeld worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Syntaxis

azcopy sync '<local-directory-path>' 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Voorbeeld

azcopy sync 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive

Een lokaal bestandssysteem bijwerken met wijzigingen in een bestandsshare

In dit geval is het lokale bestandssysteem de bestemming en is de bestandsshare de bron.

Tip

In dit voorbeeld worden padargumenten tussen enkele aanhalingstekens (''' ) geplaatst. Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Syntaxis

azcopy sync 'https://<storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'C:\myDirectory' --recursive

Voorbeeld

azcopy sync 'https://mystorageaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'C:\myDirectory' --recursive

Een bestandsshare bijwerken met wijzigingen in een andere bestandsshare

De eerste bestandsshare die in deze opdracht wordt weergegeven, is de bron. De tweede is de bestemming.

Syntaxis

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Voorbeeld

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Een map bijwerken met wijzigingen in een map in een andere bestandsshare

De eerste map die in deze opdracht wordt weergegeven, is de bron. De tweede is de bestemming.

Syntaxis

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-name><SAS-token>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name>/<directory-name><SAS-token>' --recursive

Voorbeeld

azcopy sync 'https://mysourceaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' 'https://mydestinationaccount.file.core.windows.net/myFileShare/myDirectory?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Een bestandsshare bijwerken zodat deze overeenkomt met de inhoud van een momentopname van een share

De eerste bestandsshare die in deze opdracht wordt weergegeven, is de bron. Voeg aan het einde van de URI de tekenreeks &sharesnapshot= toe, gevolgd door de datum/tijd-waarde van de momentopname.

Syntaxis

azcopy sync 'https://<source-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>&sharesnapsot<snapshot-ID>' 'https://<destination-storage-account-name>.file.core.windows.net/<file-share-name><SAS-token>' --recursive

Voorbeeld

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D&sharesnapshot=2020-03-03T20%3A24%3A13.0000000Z' 'https://mydestinationaccount.file.core.windows.net/myfileshare?sv=2018-03-28&ss=bfqt&srt=sco&sp=rwdlacup&se=2019-07-04T05:30:08Z&st=2019-07-03T21:30:08Z&spr=https&sig=CAfhgnc9gdGktvB=ska7bAiqIddM845yiyFwdMH481QA8%3D' --recursive --preserve-smb-permissions=true --preserve-smb-info=true

Zie Overzicht van momentopnamen van shares voor Azure Files voor meer informatie over momentopnamen van shares.

Volgende stappen

Bekijk meer voorbeelden in een van deze artikelen:

Zie deze artikelen voor het configureren van instellingen, het optimaliseren van de prestaties en het oplossen van problemen: