Dela via

Överför data med AzCopy och fillagring

AzCopy är ett kommandoradsverktyg som du kan använda för att kopiera filer till eller från ett lagringskonto. Den här artikeln innehåller exempelkommandon som fungerar med Azure Files.

Kom igång

I artikeln Kom igång med AzCopy kan du ladda ned AzCopy och lära dig mer om hur du kan ange autentiseringsuppgifter för auktorisering till lagringstjänsten.

Kommentar

Exemplen i den här artikeln visar användningen av en SAS-token för att auktorisera åtkomst. Men för kommandon som riktar in sig på filer och kataloger kan du nu ange autentiseringsuppgifter för auktorisering med hjälp av Microsoft Entra-ID och utelämna SAS-token från dessa kommandon. Du måste fortfarande använda en SAS-token i alla kommandon som endast riktar sig till filresursen eller kontot (till exempel: 'azcopy make https://mystorageaccount.file.core.windows.net/myfileshare' eller 'azcopy copy 'https://mystorageaccount.file.core.windows.net'.

Mer information finns i Auktorisera AzCopy

Dricks

När du använder Azure Files NFS måste du ange --from-to CLI-växeln med något av följande alternativ som stöds: FileNFSLocal, LocalFileNFSeller FileNFSFileNFS i dina kommandon.

Scenarier för uppladdning och nedladdning som använder LocalFileNFS och FileNFSLocal stöds endast i lokala Linux-miljöer. Dessa åtgärder stöds inte i Windows eller macOS. Däremot stöds FileNFSFileNFS-scenariot, som använder api:et för server-till-server-kopiering, i Windows, Linux och macOS. Du kan köra de associerade kommandona från någon av dessa plattformar.

Skapa filresurser

Du kan använda kommandot azcopy make för att skapa en filresurs. I exemplet i det här avsnittet skapas en filresurs med namnet myfileshare.

Kommentar

AzCopy version 10.30.0 introducerar en icke-bakåtkompatibel ändring där den inte längre automatiskt skapar filresurser för överföringar som involverar Azure Files med hjälp av NFS- eller SMB-protokoll.

Dricks

Det här exemplet omger sökvägsargument med enkla citattecken ('''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Syntax

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

Exempel

azcopy make 'https://mystorageaccount.file.core.windows.net/myfileshare?[SAS]'

Detaljerade referensdokument finns i azcopy make.

Ladda upp filer

Använd kommandot azcopy copy för att ladda upp filer och kataloger från den lokala datorn.

Dricks

Exemplen i det här avsnittet omger sökvägsargument med enkla citattecken (''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Det här avsnittet innehåller följande exempel:

  • Ladda upp en fil
  • Ladda upp en katalog
  • Ladda upp innehållet i en katalog
  • Ladda upp en specifik fil

Dricks

Använd valfria flaggor för att anpassa uppladdningsåtgärden. Några exempel:

Scenario Flagga
Kopiera åtkomstkontrollistor (ACL) tillsammans med filerna. --preserve-permissions=[true|false]
Kopiera SMB-egenskapsinformation tillsammans med filerna. --preserve-info=[true|false]

En fullständig lista finns i alternativ.

Kommentar

AzCopy beräknar och lagrar inte automatiskt filens MD5-hashkod för en fil som är större än 256 MB. Om du vill att AzCopy ska göra det lägger du till flaggan i --put-md5 varje kopieringskommando. På så sätt, när filen laddas ned, beräknar AzCopy en MD5-hash för nedladdade data och verifierar att MD5-hashen som lagras i filens Content-md5 egenskap matchar den beräknade hashen.

Ladda upp en fil

Syntax

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

azcopy copy 'C:\myDirectory\myTextFile.txt' 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?[SAS]' --preserve-permissions=true --preserve-info=true

Du kan också ladda upp en fil med hjälp av en jokerteckensymbol (*) var som helst i filsökvägen eller filnamnet. Till exempel: 'C:\myDirectory\*.txt', eller C:\my*\*.txt.

Ladda upp en katalog

I det här exemplet kopieras en katalog och alla filer i katalogen till en fildelningsresurs. Resultatet är en katalog i filresursen med samma namn.

Syntax

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

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Om du vill kopiera till en katalog i filresursen anger du bara namnet på katalogen i kommandosträngen.

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Om du anger namnet på en katalog som inte finns i filresursen skapar AzCopy en ny katalog med det namnet.

Ladda upp innehållet i en katalog

Du kan ladda upp innehållet i en katalog utan att kopiera själva innehållskatalogen med jokertecknet (*).

Syntax

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

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?[SAS]' --preserve-permissions=true --preserve-info=true

Kommentar

Om du vill ladda upp filer i alla underkataloger lägger du till --recursive flaggan.

Ladda upp specifika filer

Du kan ladda upp specifika filer med hjälp av fullständiga filnamn, partiella namn med jokertecken (*) eller genom att använda datum och tider.

Ange flera fullständiga filnamn

Använd kommandot azcopy copy med alternativet --include-path . Avgränsa enskilda filnamn med semikolon (;).

Syntax

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>

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?[SAS]' --include-path 'photos;documents\myFile.txt' --preserve-permissions=true --preserve-info=true

I det här exemplet överför C:\myDirectory\photos AzCopy katalogen och C:\myDirectory\documents\myFile.txt filen. Du måste inkludera --recursive alternativet för att överföra alla filer i C:\myDirectory\photos katalogen.

Du kan också exkludera filer med hjälp av alternativet --exclude-path . Mer information finns i azcopy copy reference docs (azcopy copy reference docs).

Använda jokertecken

Använd kommandot azcopy copy med alternativet --include-pattern . Ange partiella namn som innehåller jokertecken. Avgränsa namn med hjälp av ett semikolon (;).

Syntax

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>

azcopy copy 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileshare?[SAS]' --include-pattern 'myFile*.txt;*.pdf*' --preserve-permissions=true --preserve-info=true

Du kan också exkludera filer med hjälp av alternativet --exclude-pattern . Mer information finns i azcopy copy reference docs (azcopy copy reference docs).

Alternativen --include-pattern och --exclude-pattern gäller endast för filnamn och inte för sökvägen. Om du vill kopiera alla textfiler som finns i ett katalogträd använder --recursive du alternativet för att hämta hela katalogträdet och använder --include-pattern sedan och anger *.txt för att hämta alla textfiler.

Ladda upp filer som har ändrats efter ett datum och en tid

Använd kommandot azcopy copy med alternativet --include-after . Ange ett datum och en tid i ISO 8601-format (till exempel: 2020-08-19T15:04:00Z).

Syntax

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>

azcopy copy 'C:\myDirectory\*' 'https://mystorageaccount.file.core.windows.net/myfileshare?[SAS]' --include-after '2020-08-19T15:04:00Z' --preserve-permissions=true --preserve-info=true

Ange käll- och måltyper när blobar laddas upp

AzCopy använder parametern --from-to för att explicit definiera käll- och målresurstyperna när automatisk identifiering kan misslyckas, till exempel i piping-scenarier eller emulatorer. Den här parametern hjälper AzCopy att förstå kontexten för överföringen och optimera därefter.

FromTo-värde Description
LocalFileSMB Ladda upp från det lokala filsystemet till SMB-resursen i Azure File Storage
LocalFileNFS Ladda upp från det lokala filsystemet (endast Linux) till NFS-resursen i Azure File Storage
PipeFile Strömma data från ett rör till Azure File Storage

Ladda ned filer

Använd kommandot azcopy copy för att ladda ned filer, kataloger och filresurser till din lokala dator.

Dricks

Exemplen i det här avsnittet omger sökvägsargument med enkla citattecken (''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Det här avsnittet innehåller följande exempel:

  • Ladda ned en fil
  • Ladda ned en katalog
  • Ladda ned innehållet i en katalog
  • Ladda ned specifika filer

Dricks

Använd valfria flaggor för att anpassa nedladdningsåtgärden. Några exempel:

Scenario Flagga
Kopiera åtkomstkontrollistor (ACL) tillsammans med filerna. --preserve-permissions=[true|false]
Kopiera SMB-egenskapsinformation tillsammans med filerna. --preserve-info=[true|false]
Dekomprimera filer automatiskt. --Dekomprimera

En fullständig lista finns i alternativ.

Kommentar

Content-md5 Om egenskapsvärdet för en fil innehåller en hash beräknar AzCopy en MD5-hash för nedladdade data och verifierar att MD5-hashen som lagras i filens Content-md5 egenskap matchar den beräknade hashen. Om dessa värden inte matchar misslyckas nedladdningen om du inte åsidosätter det här beteendet genom att lägga till --check-md5=NoCheck eller --check-md5=LogOnly till kopieringskommandot.

Ladda ned en fil

Syntax

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

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?[SAS]' 'C:\myDirectory\myTextFile.txt' --preserve-permissions=true --preserve-info=true

Ladda ned en katalog

Syntax

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

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?[SAS]' 'C:\myDirectory'  --recursive --preserve-permissions=true --preserve-info=true

I det här exemplet skapas en katalog med namnet C:\myDirectory\myFileShareDirectory som innehåller alla nedladdade filer.

Ladda ned innehållet i en katalog

Du kan ladda ned innehållet i en katalog utan att kopiera själva katalogen med hjälp av jokertecknet (*).

Syntax

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

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory/*?[SAS]' 'C:\myDirectory' --preserve-permissions=true --preserve-info=true

Kommentar

Om du vill ladda ned filer i alla underkataloger lägger du till --recursive flaggan.

Ladda ned specifika filer

Du kan ladda ned specifika filer med hjälp av fullständiga filnamn, partiella namn med jokertecken (*) eller genom att använda datum och tider.

Ange flera fullständiga filnamn

Använd kommandot azcopy copy med alternativet --include-path . Avgränsa enskilda filnamn med semikolon (;).

Syntax

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>

azcopy copy 'https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory?[SAS]' 'C:\myDirectory' --include-path 'photos;documents\myFile.txt' --recursive --preserve-permissions=true --preserve-info=true

I det här exemplet överför https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos AzCopy katalogen och https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/documents/myFile.txt filen. Inkludera alternativet --recursive att överföra alla filer i https://mystorageaccount.file.core.windows.net/myFileShare/myDirectory/photos katalogen.

Du kan också exkludera filer med hjälp av alternativet --exclude-path . Mer information finns i azcopy copy reference docs (azcopy copy reference docs).

Använda jokertecken

Använd kommandot azcopy copy med alternativet --include-pattern . Ange partiella namn som innehåller jokertecken. Avgränsa namn med hjälp av ett semikolon (;).

Syntax

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>

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myDirectory?[SAS]' 'C:\myDirectory' --include-pattern 'myFile*.txt;*.pdf*' --preserve-permissions=true --preserve-info=true

Du kan också exkludera filer med hjälp av alternativet --exclude-pattern . Mer information finns i azcopy copy reference docs (azcopy copy reference docs).

Alternativen --include-pattern och --exclude-pattern gäller endast för filnamn och inte för sökvägen. Om du vill kopiera alla textfiler som finns i ett katalogträd använder --recursive du alternativet för att hämta hela katalogträdet och använder --include-pattern sedan och anger *.txt för att hämta alla textfiler.

Ladda ned filer som har ändrats efter ett datum och en tid

Använd kommandot azcopy copy med alternativet --include-after . Ange ett datum och en tid i ISO-8601-format (till exempel: 2020-08-19T15:04:00Z).

Syntax

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>

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/*?[SAS]' 'C:\myDirectory' --include-after '2020-08-19T15:04:00Z' --preserve-permissions=true --preserve-info=true

Detaljerad referens finns i referensdokumenten för azcopy-kopiering .

Ladda ned från en resursögonblicksbild

Du kan ladda ned en viss version av en fil eller katalog genom att referera till DateTime-värdet för en resursögonblicksbild. Mer information om resursögonblicksbilder finns i Översikt över resursögonblicksbilder för Azure Files.

Syntax

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>'

Exempel (Ladda ned en fil)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myTextFile.txt?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt' --preserve-permissions=true --preserve-info=true

Exempel (Ladda ned en katalog)

azcopy copy 'https://mystorageaccount.file.core.windows.net/myfileshare/myFileShareDirectory?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory' --recursive --preserve-permissions=true --preserve-info=true

Ange käll- och måltyper när filer laddas ned

AzCopy använder parametern --from-to för att explicit definiera käll- och målresurstyperna när automatisk identifiering kan misslyckas, till exempel i piping-scenarier eller emulatorer. Den här parametern hjälper AzCopy att förstå kontexten för överföringen och optimera därefter.

FromTo-värde Description
FileSMBLocal Ladda ned från SMB-resurs i Azure File Storage till det lokala filsystemet
FileNFSLocal Ladda ned från NFS-resurs i Azure File Storage till det lokala filsystemet (endast Linux)
FileSMBLocal Ladda ned från SMB-resurs till lokalt filsystem
FilePipe Strömma data från Azure File Storage till ett rör

Kopiera filer mellan lagringskonton

Du kan använda AzCopy för att kopiera filer till andra lagringskonton. Kopieringsåtgärden är synkron så alla filer kopieras när kommandot returneras.

AzCopy använder API:er från server till server, så data kopieras direkt mellan lagringsservrar. Du kan öka dataflödet för dessa åtgärder genom att ange värdet för AZCOPY_CONCURRENCY_VALUE miljövariabeln. Mer information finns i Öka samtidighet.

Du kan också kopiera specifika versioner av en fil genom att referera till DateTime-värdet för en resursögonblicksbild. Mer information om resursögonblicksbilder finns i Översikt över resursögonblicksbilder för Azure Files.

Dricks

Exemplen i det här avsnittet omger sökvägsargument med enkla citattecken (''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Det här avsnittet innehåller följande exempel:

  • Kopiera en fil till ett annat lagringskonto
  • Kopiera en katalog till ett annat lagringskonto
  • Kopiera en filresurs till ett annat lagringskonto
  • Kopiera alla filresurser, kataloger och filer till ett annat lagringskonto

Dricks

Du kan justera kopieringsåtgärden med hjälp av valfria flaggor. Här är några exempel.

Scenario Flagga
Kopiera åtkomstkontrollistor (ACL) tillsammans med filerna. --preserve-permissions=[true|false]
Kopiera SMB-egenskapsinformation tillsammans med filerna. --preserve-info=[true|false]

En fullständig lista finns i alternativ.

Kopiera en fil till ett annat lagringskonto

Syntax

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>'

Exempel

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?[SAS]' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?[SAS]' --preserve-permissions=true --preserve-info=true

Exempel (resursögonblicksbild)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer/myTextFile.txt?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer/myTextFile.txt?[SAS]' --preserve-permissions=true --preserve-info=true

Kopiera en katalog till ett annat lagringskonto

Syntax

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

Exempel

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?[SAS]' 'https://mydestinationaccount.file.core.windows.net/mycontainer?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Exempel (resursögonblicksbild)

azcopy copy 'https://mysourceaccount.file.core.windows.net/myFileShare/myFileDirectory?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Kopiera en filresurs till ett annat lagringskonto

Syntax

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

Exempel

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?[SAS]' 'https://mydestinationaccount.file.core.windows.net/mycontainer?[SAS]' --preserve-permissions=true --preserve-info=true

Exempel (resursögonblicksbild)

azcopy copy 'https://mysourceaccount.file.core.windows.net/mycontainer?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/mycontainer?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Kopiera alla filresurser, kataloger och filer till ett annat lagringskonto

Syntax

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'

Exempel

azcopy copy 'https://mysourceaccount.file.core.windows.net?[SAS]' 'https://mydestinationaccount.file.core.windows.net?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Exempel (resursögonblicksbild)

azcopy copy 'https://mysourceaccount.file.core.windows.net?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Ange käll- och måltyper när filer kopieras

AzCopy använder parametern --from-to för att explicit definiera käll- och målresurstyperna när automatisk identifiering kan misslyckas, till exempel i piping-scenarier eller emulatorer. Den här parametern hjälper AzCopy att förstå kontexten för överföringen och optimera därefter.

FromTo-värde Description
FileBlob Kopiera från Azure File Storage till Azure Blob Storage
FileBlobFS Kopiera från Azure File Storage till Azure Data Lake Gen2 (BlobFS)
FileSMBFileSMB Kopiera mellan två SMB-resurser i Azure File Storage
FileNFSFileNFS Kopiera mellan två NFS-resurser i Azure File Storage
FileNFSFileSMB Kopiera från Azure File Storage NFS till Azure Files Storage SMB
FileSMBFileNFS Kopiera från Azure File Storage SMB till Azure Files Storage NFS

Synkronisera filer

Du kan synkronisera innehållet i ett lokalt filsystem med en filresurs eller synkronisera innehållet i en filresurs med en annan filresurs. Du kan också synkronisera innehållet i en katalog i en filresurs med innehållet i en katalog som finns i en annan filresurs. Synkronisering är ett sätt. Med andra ord väljer du vilken av dessa två slutpunkter som är källan och vilken som är målet. Synkronisering använder även server-till-server-API:er.

Varning

AzCopy-synkronisering stöds men rekommenderas inte fullt ut för Azure Files. AzCopy-synkronisering stöder upp till 10 miljoner filer per AzCopy-jobb och viss filåtergivning kan gå förlorad eftersom AzCopy använder Azure Files REST-API:er för att kopiera innehåll till din Azure Files-resurs. Mer information finns i Migrera till Azure-filresurser.

Riktlinjer

Som standard jämför synkroniseringskommandot filnamn och senast ändrade tidsstämplar. Du kan åsidosätta det beteendet för att använda MD5-hashar i stället för senast ändrade tidsstämplar med hjälp --compare-hash av flaggan. Ange den --delete-destination valfria flaggan till ett värde för true eller prompt för att ta bort filer i målkatalogen om filerna inte längre finns i källkatalogen.

  • Om du ställer in flaggan på --delete-destinationtruetar AzCopy bort filer utan att fråga. Om du vill att en fråga ska visas innan AzCopy tar bort en fil anger du --delete-destination flaggan till prompt.

  • Om du planerar att ange --delete-destination flaggan till eller promptkan du överväga att false använda kopieringskommandot i stället för synkroniseringskommandot och ange parametern --overwrite till ifSourceNewer. Kopieringskommandot förbrukar mindre minne och medför mindre faktureringskostnader eftersom en kopieringsåtgärd inte behöver indexering av källan eller målet innan filerna flyttas.

  • Om du inte planerar att använda --compare-hash flaggan bör datorn där du kör synkroniseringskommandot ha en korrekt systemklocka eftersom de senaste ändrade tiderna är viktiga för att avgöra om en fil ska överföras. Om systemet har betydande klocksnedvridning bör du undvika att ändra filer på målet för nära den tid som du planerar att köra ett synkroniseringskommando.

  • AzCopy använder API:er från server till server för att synkronisera data mellan lagringskonton. Det innebär att data kopieras direkt mellan lagringsservrar. AzCopy konfigurerar och övervakar dock varje överföring, och för större lagringskonton (till exempel konton som innehåller miljontals blobar) kan AzCopy kräva en betydande mängd beräkningsresurser för att utföra dessa uppgifter. Om du kör AzCopy från en virtuell dator kontrollerar du därför att den virtuella datorn har tillräckligt med kärnor/minne för att hantera belastningen.

Dricks

Du kan justera synkroniseringsåtgärden med hjälp av valfria flaggor. Här är några exempel.

Scenario Flagga
Kopiera åtkomstkontrollistor (ACL) tillsammans med filerna. --preserve-permissions=[true|false]
Kopiera SMB-egenskapsinformation tillsammans med filerna. --preserve-info=[true|false]
Exkludera filer baserat på ett mönster. --exclude-path
Ange hur detaljerade du vill att dina synkroniseringsrelaterade loggposter ska vara. --log-level=[WARNING|FEL|INFO|INGEN]

En fullständig lista finns i alternativ.

Exemplen i det här avsnittet omger sökvägsargument med enkla citattecken (''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Uppdatera en filresurs med ändringar i ett lokalt filsystem

I det här fallet är filresursen målet och det lokala filsystemet är källan.

Dricks

Det här exemplet omger sökvägsargument med enkla citattecken ('''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Syntax

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

Exempel

azcopy sync 'C:\myDirectory' 'https://mystorageaccount.file.core.windows.net/myfileShare?[SAS]' --recursive

Uppdatera ett lokalt filsystem med ändringar i en filresurs

I det här fallet är det lokala filsystemet målet och filresursen är källan.

Dricks

Det här exemplet omger sökvägsargument med enkla citattecken ('''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

Syntax

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

Exempel

azcopy sync 'https://mystorageaccount.file.core.windows.net/myfileShare?[SAS]' 'C:\myDirectory' --recursive

Uppdatera en filresurs med ändringar från en annan filresurs

Den första fildelningen i det här kommandot är källan. Kommandot kopierar ändringar från den här källfildelningen. Den andra fildelningen är målet.

Syntax

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

Exempel

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?[SAS]' 'https://mydestinationaccount.file.core.windows.net/myfileshare?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Uppdatera en katalog med ändringar i en katalog i en annan filresurs

Den första katalogen som visas i det här kommandot är källan. Den andra är målet.

Syntax

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

Exempel

azcopy sync 'https://mysourceaccount.file.core.windows.net/myFileShare/myDirectory?[SAS]' 'https://mydestinationaccount.file.core.windows.net/myFileShare/myDirectory?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Uppdatera en filresurs så att den matchar innehållet i en resursögonblicksbild

Den första filresursen som visas i det här kommandot är källan. I slutet av URI:n lägger du till strängen &sharesnapshot= följt av DateTime-värdet för ögonblicksbilden.

Syntax

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

Exempel

azcopy sync 'https://mysourceaccount.file.core.windows.net/myfileShare?[SAS]&sharesnapshot=2020-09-23T08:21:07.0000000Z' 'https://mydestinationaccount.file.core.windows.net/myfileshare?[SAS]' --recursive --preserve-permissions=true --preserve-info=true

Mer information om resursögonblicksbilder finns i Översikt över resursögonblicksbilder för Azure Files.

Egenskaper och behörigheter som ska bevaras

Dricks

När du laddar ned filer till ett lokalt Linux-system behöver du utökade privilegier om den angivna ägaren eller gruppen skiljer sig från den aktuella användarens. Om du vill ändra ägarskapet eller gruppen för nedladdade filer kör du azcopy med sudo eller som rotanvändare.

Type Egenskaper (--preserve-info) Behörigheter (--preserve-permissions)
Azure Files SMB NTFSFileAttributes (Skrivskyddad, Hidden, System, Directory, Archive, None, Temporary, Offline, NotContentIndexed, NoScrubData) (x-ms-file-attributes)
Skapandetid (CreationTime) (x-ms-file-creation-time)
LastWriteTime (x-ms-file-last-write-time)		 ACL:er (x-ms-file-permission)
Azure Files NFS Skapandetid (CreationTime) (x-ms-file-creation-time)
LastWriteTime (x-ms-file-last-write-time)		 Ägare (x-ms-owner)
Grupp (x-ms-group)
FileMode (x-ms-mode)

Nästa steg

Hitta fler exempel i någon av dessa artiklar:

Se de här artiklarna om du vill konfigurera inställningar, optimera prestanda och felsöka problem: