azcopy copy

Kopieert brongegevens naar een doellocatie.

Samenvatting

Kopieert brongegevens naar een doellocatie. De ondersteunde aanwijzingen zijn:

  • lokaal <-> Azure Blob (SAS- of OAuth-verificatie)
  • lokaal <-> Azure Files (SAS-verificatie voor Share/directory)
  • lokaal <-> Azure Data Lake Storage Gen2 (SAS-, OAuth- of SharedKey-verificatie)
  • Azure Blob (SAS of openbaar) -> Azure Blob (SAS of OAuth-verificatie)
  • Azure Data Lake Storage Gen2 (SAS of openbaar) -> Azure Data Lake Storage Gen2 (SAS- of OAuth-verificatie)
  • Azure Blob (SAS- of OAuth-verificatie) <-> Azure Blob (SAS- of OAuth-verificatie) - Zie richtlijnen.
  • Azure Data Lake Storage Gen2 (SAS- of OAuth-verificatie) <-> Azure Data Lake Storage Gen2 (SAS- of OAuth-verificatie)
  • Azure Data Lake Storage Gen2 (SAS- of OAuth-verificatie) <-> Azure Blob (SAS- of OAuth-verificatie)
  • Azure Blob (SAS of openbaar) -> Azure Files (SAS)
  • Azure Files (SAS) -> Azure Files (SAS)
  • Azure Files (SAS) -> Azure Blob (SAS- of OAuth-verificatie)
  • AWS S3 (toegangssleutel) -> Azure Block Blob (SAS- of OAuth-verificatie)
  • Google Cloud Storage (serviceaccountsleutel) -> Azure Block Blob (SAS- of OAuth-verificatie)

Raadpleeg de voorbeelden voor meer informatie.

Geavanceerd

AzCopy detecteert automatisch het inhoudstype van de bestanden bij het uploaden vanaf de lokale schijf, op basis van de bestandsextensie of inhoud (als er geen extensie is opgegeven).

De ingebouwde opzoektabel is klein, maar op Unix wordt deze uitgebreid door de mime.types-bestanden van het lokale systeem, indien beschikbaar onder een of meer van deze namen:

  • /etc/mime.types
  • /etc/apache2/mime.types
  • /etc/apache/mime.types

In Windows worden MIME-typen uit het register geëxtraheerd. Deze functie kan worden uitgeschakeld met behulp van een vlag. Raadpleeg de vlagsectie.

Als u een omgevingsvariabele instelt met behulp van de opdrachtregel, kan die variabele worden gelezen in de opdrachtregelgeschiedenis. U kunt variabelen wissen die referenties uit de opdrachtregelgeschiedenis bevatten. Als u wilt voorkomen dat variabelen worden weergegeven in uw geschiedenis, kunt u een script gebruiken om de gebruiker om hun referenties te vragen en de omgevingsvariabele in te stellen.

azcopy copy [source] [destination] [flags]

Voorbeelden

Upload één bestand met behulp van OAuth-verificatie. Als u zich nog niet hebt aangemeld bij AzCopy, voert u de opdracht azcopy-aanmelding uit voordat u de volgende opdracht uitvoert.

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

Hetzelfde als hierboven, maar deze keer berekent u ook MD5-hash van de bestandsinhoud en slaat u deze op als de eigenschap Content-MD5 van de blob:

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5

Eén bestand uploaden met behulp van een SAS-token:

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Upload één bestand met behulp van een SAS-token en pijpen (alleen blok-blobs):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob

Eén bestand uploaden met behulp van OAuth en piping (alleen blok-blobs):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob

Een volledige map uploaden met behulp van een SAS-token:

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

or

azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5

Upload een set bestanden met behulp van een SAS-token en jokerteken (*) tekens:

azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"

Bestanden en mappen uploaden met behulp van een SAS-token en jokerteken (*) tekens:

azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Upload bestanden en mappen naar het Azure Storage-account en stel de gecodeerde tags voor de queryreeks in op de blob.

  • Als u tags {key = "bla bla", val = "foo"} en {key = "bla bla 2", val = "bar"} wilt instellen, gebruikt u de volgende syntaxis:
  • azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
  • Sleutels en waarden zijn URL-gecodeerd en de sleutel-waardeparen worden gescheiden door een ampersand('&')
  • Tijdens het instellen van tags op de blobs zijn er meer machtigingen (geen' voor tags) in SAS zonder dat de service autorisatiefout teruggeeft.

Download één bestand met behulp van OAuth-verificatie. Als u zich nog niet hebt aangemeld bij AzCopy, voert u de opdracht azcopy-aanmelding uit voordat u de volgende opdracht uitvoert.

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"

Eén bestand downloaden met behulp van een SAS-token:

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"

Download één bestand met behulp van een SAS-token en sluis de uitvoer vervolgens door naar een bestand (alleen blok-blobs):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"

Download één bestand met behulp van OAuth en piping vervolgens de uitvoer naar een bestand (alleen blok-blobs):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"

Een volledige map downloaden met behulp van een SAS-token:

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true

Een opmerking over het gebruik van een jokerteken (*) in URL's:

Er zijn slechts twee ondersteunde manieren om een jokerteken in een URL te gebruiken.

  • U kunt er een gebruiken net na de laatste slash (/) van een URL. Hiermee worden alle bestanden in een map rechtstreeks naar het doel gekopieerd zonder ze in een submap te plaatsen.

  • U kunt er ook een gebruiken in de naam van een container, zolang de URL alleen verwijst naar een container en niet naar een blob. U kunt deze methode gebruiken om bestanden op te halen uit een subset van containers.

Download de inhoud van een map zonder de map zelf te kopiëren.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"

Download een volledig opslagaccount.

azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive

Download een subset van containers in een opslagaccount met behulp van een jokerteken (*) in de containernaam.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive

Download alle versies van een blob van Azure Storage naar de lokale map. Zorg ervoor dat de bron een geldige blob is, het doel een lokale map is en versionidsFile dat een pad naar het bestand accepteert waarin elke versie op een afzonderlijke regel wordt geschreven. Alle opgegeven versies worden gedownload in de opgegeven doelmap.

azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"

Kopieer één blob naar een andere blob met behulp van een SAS-token.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Kopieer één blob naar een andere blob met behulp van een SAS-token en een OAuth-token.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"

Kopieer de ene virtuele blobmap naar een andere met behulp van een SAS-token:

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Kopieer alle blobcontainers, mappen en blobs van het opslagaccount naar een ander met behulp van een SAS-token:

azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Kopieer één object naar Blob Storage vanuit Amazon Web Services (AWS) S3 met behulp van een toegangssleutel en een SAS-token. Stel eerst de omgevingsvariabele in AWS_ACCESS_KEY_ID en AWS_SECRET_ACCESS_KEY voor de AWS S3-bron.

azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Kopieer een volledige map naar Blob Storage vanuit AWS S3 met behulp van een toegangssleutel en een SAS-token. Stel eerst de omgevingsvariabele in AWS_ACCESS_KEY_ID en AWS_SECRET_ACCESS_KEY voor de AWS S3-bron.

azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Raadpleeg de https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html tijdelijke aanduiding [folder] voor meer informatie.

Kopieer alle buckets naar Blob Storage vanuit Amazon Web Services (AWS) met behulp van een toegangssleutel en een SAS-token. Stel eerst de omgevingsvariabele in AWS_ACCESS_KEY_ID en AWS_SECRET_ACCESS_KEY voor de AWS S3-bron.

azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Kopieer alle buckets naar Blob Storage vanuit een AWS-regio (Amazon Web Services) met behulp van een toegangssleutel en een SAS-token. Stel eerst de omgevingsvariabele in AWS_ACCESS_KEY_ID en AWS_SECRET_ACCESS_KEY voor de AWS S3-bron.

azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Kopieer een subset van buckets met behulp van een jokerteken (*) in de naam van de bucket. Net als in de vorige voorbeelden hebt u een toegangssleutel en een SAS-token nodig. Zorg ervoor dat u de omgevingsvariabele instelt AWS_ACCESS_KEY_ID en AWS_SECRET_ACCESS_KEY voor de AWS S3-bron.

azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Kopieer blobs van de ene blobopslag naar de andere en bewaar de tags uit de bron. Gebruik de volgende syntaxis om tags te behouden:

azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true

Draag bestanden en mappen over naar het Azure Storage-account en stel de opgegeven gecodeerde tags voor queryreeksen in op de blob.

  • Als u tags {key = "bla bla", val = "foo"} en {key = "bla bla 2", val = "bar"} wilt instellen, gebruikt u de volgende syntaxis:

    azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"

  • Sleutels en waarden zijn URL-gecodeerd en de sleutel-waardeparen worden gescheiden door een ampersand('&')

  • Tijdens het instellen van tags op de blobs zijn er extra machtigingen (geen' voor tags) in SAS zonder dat de service autorisatiefout teruggeeft.

Kopieer één object naar Blob Storage vanuit Google Cloud Storage (GCS) met behulp van een serviceaccountsleutel en een SAS-token. Stel eerst de omgevingsvariabele in GOOGLE_APPLICATION_CREDENTIALS voor GCS-bron.

azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Kopieer een volledige map naar Blob Storage vanuit Google Cloud Storage (GCS) met behulp van een serviceaccountsleutel en een SAS-token. Stel eerst de omgevingsvariabele in GOOGLE_APPLICATION_CREDENTIALS voor GCS-bron.

azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Kopieer een hele bucket naar Blob Storage vanuit Google Cloud Storage (GCS) met behulp van een serviceaccountsleutel en een SAS-token. Stel eerst de omgevingsvariabele in GOOGLE_APPLICATION_CREDENTIALS voor GCS-bron.

azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Kopieer alle buckets naar Blob Storage vanuit Google Cloud Storage (GCS) met behulp van een serviceaccountsleutel en een SAS-token. Stel eerst de omgevingsvariabelen in GOOGLE_APPLICATION_CREDENTIALS en GOOGLE_CLOUD_PROJECT=<project-id> voor GCS-bron

azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Kopieer een subset buckets met behulp van een jokerteken (*) in de bucketnaam van Google Cloud Storage (GCS) met behulp van een serviceaccountsleutel en een SAS-token voor bestemming. Stel eerst de omgevingsvariabelen GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> in voor de GCS-bron

azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Opties

--as-subdir Is standaard waar. Plaatst mapbronnen als submappen onder het doel. (standaard true)

--backup Activeert De SeBackupPrivilege van Windows voor uploads of SeRestorePrivilege voor downloads, zodat AzCopy alle bestanden kan zien, ongeacht hun bestandssysteemmachtigingen en om alle machtigingen te herstellen. Vereist dat het account met AzCopy deze machtigingen al heeft (bijvoorbeeld Beheer istratorrechten heeft of lid is van de groep Back-upoperators). Met deze vlag worden bevoegdheden geactiveerd die het account al heeft

--blob-tags (tekenreeks) Tags instellen op blobs om gegevens in uw opslagaccount te categoriseren

--blob-type (tekenreeks) Hiermee definieert u het type blob op de bestemming. Dit wordt gebruikt voor het uploaden van blobs en bij het kopiëren tussen accounts (standaard 'Detecteren'). Geldige waarden zijn 'Detect', 'BlockBlob', 'PageBlob' en 'AppendBlob'. Bij het kopiëren tussen accounts zorgt een waarde van Detect ervoor dat AzCopy het type bron-blob gebruikt om het type doel-blob te bepalen. Bij het uploaden van een bestand bepaalt 'Detect' of het bestand een VHD of een VHDX-bestand is op basis van de bestandsextensie. Als het bestand een VHD- of VHDX-bestand is, behandelt AzCopy het bestand als een pagina-blob. (standaard 'Detecteren')

--block-blob-tier (tekenreeks) upload blok-blob naar Azure Storage met behulp van deze bloblaag. (standaard 'Geen')

--block-size-mb (float) Gebruik deze blokgrootte (opgegeven in MiB) bij het uploaden naar Azure Storage en downloaden van Azure Storage. De standaardwaarde wordt automatisch berekend op basis van de bestandsgrootte. Decimale breuken zijn toegestaan (bijvoorbeeld: 0,25). Bij het uploaden of downloaden is de maximaal toegestane blokgrootte 0,75 * AZCOPY_BUFFER_GB. Zie Geheugengebruik optimaliseren voor meer informatie.

--cache-control (tekenreeks) Stel de header voor cachebeheer in. Geretourneerd bij downloaden.

--check-length Controleer de lengte van een bestand op de bestemming na de overdracht. Als er sprake is van een niet-overeenkomende bron en bestemming, wordt de overdracht gemarkeerd als mislukt. (standaard true)

--check-md5 (tekenreeks) Hiermee geeft u op hoe strikt MD5-hashes moeten worden gevalideerd bij het downloaden. Alleen beschikbaar bij het downloaden. Beschikbare opties: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (standaard 'FailIfDifferent') (standaard "FailIfDifferent")

--content-disposition (tekenreeks) Stel de koptekst voor inhoudsopstelling in. Geretourneerd bij downloaden.

--content-encoding (tekenreeks) Stel de header voor inhoudscodering in. Geretourneerd bij downloaden.

--content-language (tekenreeks) Stel de koptekst van de inhoudstaal in. Geretourneerd bij downloaden.

--content-type (tekenreeks) Hiermee geeft u het inhoudstype van het bestand. Impliceert no-guess-mime-type. Geretourneerd bij downloaden.

--cpk-by-name (tekenreeks) Client opgegeven sleutel op naam waarmee clients aanvragen indienen voor Azure Blob Storage een optie om per aanvraag een versleutelingssleutel op te geven. De opgegeven sleutelnaam wordt opgehaald uit Azure Key Vault en wordt gebruikt om de gegevens te versleutelen

--cpk-by-value De door de client verstrekte sleutel op naam waarmee clients aanvragen kunnen indienen voor Azure Blob Storage, een optie voor het opgeven van een versleutelingssleutel per aanvraag. De opgegeven sleutel en de hash worden opgehaald uit omgevingsvariabelen

--decompress Bestanden automatisch decomprimeren bij het downloaden, als hun inhoudscodering aangeeft dat ze zijn gecomprimeerd. De ondersteunde waarden voor inhoudscodering zijn 'gzip' en 'deflate'. Bestandsextensies van '.gz'/'.gzip' of '.zz' zijn niet nodig, maar worden verwijderd indien aanwezig.

--disable-auto-decoding Standaard onwaar als u automatische decodering van illegale tekens in Windows wilt inschakelen. Kan worden ingesteld op true om automatische decodering uit te schakelen.

--dry-run Hiermee worden de bestandspaden afgedrukt die met deze opdracht worden gekopieerd. Met deze vlag worden de werkelijke bestanden niet gekopieerd. De vlag --overschrijven heeft geen effect. Als u de vlag --overschrijven instelt op false, worden bestanden in de bronmap vermeld, zelfs als deze bestanden in de doelmap aanwezig zijn.

--exclude-attributes (tekenreeks) (alleen Windows) Sluit bestanden uit waarvan de kenmerken overeenkomen met de kenmerkenlijst. Bijvoorbeeld: A; S; R

--exclude-blob-type (tekenreeks) U kunt desgewenst het type blob (BlockBlob/ PageBlob/AppendBlob) opgeven dat moet worden uitgesloten bij het kopiëren van blobs uit de container of het account. Het gebruik van deze vlag is niet van toepassing op het kopiëren van gegevens van niet-azure-service naar service. Meer dan één blob moet worden gescheiden door ';'.

--exclude-path (tekenreeks) Sluit deze paden uit bij het kopiëren. Deze optie biedt geen ondersteuning voor jokertekens (*). Controleert het relatieve padvoorvoegsel (bijvoorbeeld: myFolder; myFolder/subDirName/file.pdf). Bij gebruik in combinatie met accountkruising bevatten paden de containernaam niet.

--exclude-pattern (tekenreeks) Sluit deze bestanden uit bij het kopiëren. Deze optie ondersteunt jokertekens (*)

--exclude-regex (tekenreeks) Sluit alle relatieve paden uit van de bestanden die zijn afgestemd op reguliere expressies. Scheid reguliere expressies met ';'.

--follow-symlinks Volg symbolische koppelingen bij het uploaden vanuit het lokale bestandssysteem.

--force-if-read-only Bij het overschrijven van een bestaand bestand in Windows of Azure Files, dwingt u af dat het overschrijven werkt, zelfs als het bestaande bestand het kenmerk Alleen-lezen heeft ingesteld

--from-to (tekenreeks) Hiermee geeft u desgewenst de combinatie van de bronbestemming op. Bijvoorbeeld: LocalBlob, BlobLocal, LocalBlobFS. Pijpen: BlobPipe, PipeBlob

-h, --help help voor kopiëren

--include-after (tekenreeks) Alleen de bestanden opnemen die zijn gewijzigd op of na de opgegeven datum/tijd. De waarde moet ISO8601 indeling hebben. Als er geen tijdzone is opgegeven, wordt ervan uitgegaan dat de waarde zich in de lokale tijdzone van de machine met AzCopy bevindt. Bijvoorbeeld voor een UTC-tijd 2020-08-19T15:04:00Z of 2020-08-19 voor middernacht (00:00) in de lokale tijdzone. Vanaf AzCopy 10.5 is deze vlag alleen van toepassing op bestanden, niet op mappen, dus mapeigenschappen worden niet gekopieerd wanneer u deze vlag gebruikt met --preserve-smb-info of --preserve-smb-permissions.

--include-attributes (tekenreeks) (alleen Windows) Bestanden opnemen waarvan de kenmerken overeenkomen met de kenmerkenlijst. Bijvoorbeeld: A; S; R

--include-before (tekenreeks) Alleen de bestanden opnemen die vóór of op de opgegeven datum/tijd zijn gewijzigd. De waarde moet ISO8601 indeling hebben. Als er geen tijdzone is opgegeven, wordt ervan uitgegaan dat de waarde zich in de lokale tijdzone van de machine met AzCopy bevindt. Bijvoorbeeld 2020-08-19T15:04:00Z voor een UTC-tijd of 2020-08-19 voor middernacht (00:00) in de lokale tijdzone. Vanaf AzCopy 10.7 is deze vlag alleen van toepassing op bestanden, niet op mappen, dus mapeigenschappen worden niet gekopieerd wanneer u deze vlag gebruikt met --preserve-smb-info of --preserve-smb-permissions.

--include-directory-stub Standaard onwaar om map-stubs te negeren. Map-stubs zijn blobs met metagegevens hdi_isfolder:true. Als u waarde instelt op true, blijven adreslijst-stubs behouden tijdens overdrachten. Als u deze vlag zonder waarde opgeeft, wordt deze standaard ingesteld op azcopy copy --include-directory-stub=truewaar (bijvoorbeeldazcopy copy --include-directory-stub hetzelfde als ).

--include-path (tekenreeks) Neem alleen deze paden op bij het kopiëren. Deze optie biedt geen ondersteuning voor jokertekens (*). Controleert het relatieve padvoorvoegsel (bijvoorbeeld: myFolder; myFolder/subDirName/file.pdf).

--include-pattern (tekenreeks) Neem alleen deze bestanden op bij het kopiëren. Deze optie ondersteunt jokertekens (*). Bestanden scheiden met behulp van een ';'.

--include-regex (tekenreeks) Neem alleen het relatieve pad op van de bestanden die zijn afgestemd op reguliere expressies. Scheid reguliere expressies met ';'.

--list-of-versions (tekenreeks) Hiermee geeft u een bestand waarin elke versie-id wordt vermeld op een afzonderlijke regel. Zorg ervoor dat de bron moet verwijzen naar één blob en alle versie-id's die zijn opgegeven in het bestand met behulp van deze vlag, moeten alleen tot de bron-blob behoren. AzCopy downloadt de opgegeven versies in de opgegeven doelmap.

--log-level (tekenreeks) Definieer de uitgebreidheid van het logboekbestand, beschikbare niveaus: INFO(alle aanvragen/antwoorden), WAARSCHUWING(trage antwoorden), ERROR(alleen mislukte aanvragen) en NONE (geen uitvoerlogboeken). (standaard 'INFO'). (standaard "INFO")

--metadata (tekenreeks) Upload naar Azure Storage met deze sleutel-waardeparen als metagegevens.

--no-guess-mime-type Hiermee voorkomt u dat AzCopy het inhoudstype detecteert op basis van de extensie of inhoud van het bestand.

--overwrite (tekenreeks) Overschrijf de conflicterende bestanden en blobs op de bestemming als deze vlag is ingesteld op waar. (standaard 'true') Mogelijke waarden zijn 'true', 'false', 'prompt' en 'ifSourceNewer'. Voor bestemmingen die mappen ondersteunen, worden conflicterende eigenschappen op mapniveau overschreven als deze vlag 'true' is of als er een positief antwoord wordt gegeven aan de prompt. (standaard 'true')

--page-blob-tier (tekenreeks) Upload pagina-blob naar Azure Storage met behulp van deze bloblaag. (standaard 'Geen'). (standaard 'Geen')

--preserve-last-modified-time Alleen beschikbaar wanneer de bestemming een bestandssysteem is.

--preserve-owner Alleen heeft een effect in downloads en alleen wanneer --preserve-smb-permissions deze wordt gebruikt. Indien waar (de standaardinstelling), blijven de bestandseigenaar en groep behouden in downloads. Als deze optie is ingesteld op onwaar,

--preserve-smb-permissions blijven ACL's behouden, maar eigenaar en groep zijn gebaseerd op de gebruiker met AzCopy (standaard true)

--preserve-permissions Standaard onwaar. Behoudt ACL's tussen bewuste resources (Windows en Azure Files of Azure Data Lake Storage Gen2 naar Azure Data Lake Storage Gen2). Voor accounts met een hiërarchische naamruimte moet uw beveiligingsprincipaal de gebruiker zijn die eigenaar is van de doelcontainer of moet de rol Eigenaar van opslagblobgegevens worden toegewezen, die is afgestemd op de doelcontainer, het opslagaccount, de bovenliggende resourcegroep of het abonnement. Voor downloads hebt u ook de --backup vlag nodig om machtigingen te herstellen waarbij de nieuwe eigenaar niet de gebruiker is die AzCopy uitvoert. Deze vlag is van toepassing op zowel bestanden als mappen, tenzij er een alleen-bestandfilter is opgegeven (bijvoorbeeld include-pattern).

--preserve-smb-info Voor SMB-compatibele locaties is vlag standaard ingesteld op true. Behoudt informatie over SMB-eigenschappen (laatste schrijftijd, aanmaaktijd, kenmerk-bits) tussen SMB-compatibele resources (Windows en Azure Files). Alleen de kenmerk-bits die worden ondersteund door Azure Files worden overgedragen; alle andere worden genegeerd. Deze vlag is van toepassing op zowel bestanden als mappen, tenzij er een alleen-bestandfilter is opgegeven (bijvoorbeeld include-pattern). De informatie die wordt overgebracht voor mappen is hetzelfde als die voor bestanden, met uitzondering Last Write Time van de gegevens die nooit voor mappen worden bewaard. (standaard true)

--preserve-symlinks Indien ingeschakeld, blijven symlinkbestemmingen behouden als de blobinhoud in plaats van het bestand of de map aan het andere uiteinde van de symlink te uploaden.

--put-blob-size-mb Gebruik deze grootte (opgegeven in MiB) als drempelwaarde om te bepalen of een blob moet worden geüpload als één PUT-aanvraag bij het uploaden naar Azure Storage. De standaardwaarde wordt automatisch berekend op basis van de bestandsgrootte. Decimale breuken zijn toegestaan (bijvoorbeeld: 0,25).

--put-md5 Maak een MD5-hash van elk bestand en sla de hash op als de eigenschap Content-MD5 van de doel-blob of het doelbestand. (Standaard wordt de hash NIET gemaakt.) Alleen beschikbaar bij het uploaden.

--recursive Bekijk recursief submappen bij het uploaden vanuit het lokale bestandssysteem.

--s2s-detect-source-changed Detecteren of het bronbestand/de blob wordt gewijzigd terwijl het wordt gelezen. (Deze parameter is alleen van toepassing op service-naar-service-kopieën, omdat de bijbehorende controle permanent is ingeschakeld voor uploads en downloads.)

--s2s-handle-invalid-metadata (tekenreeks) Hiermee geeft u op hoe ongeldige metagegevenssleutels worden verwerkt. Beschikbare opties: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (standaard 'ExcludeIfInvalid'). (standaard "ExcludeIfInvalid")

--s2s-preserve-access-tier Behoud de toegangslaag tijdens service-naar-servicekopie. Raadpleeg Azure Blob Storage: dynamische, statische en archieftoegangslagen om ervoor te zorgen dat het doelopslagaccount ondersteuning biedt voor het instellen van de toegangslaag. In de gevallen waarin het instellen van de toegangslaag niet wordt ondersteund, moet u s2sPreserveAccessTier=false gebruiken om het kopiëren van de toegangslaag te omzeilen. (standaard true). (standaard true)

--s2s-preserve-blob-tags Indextags behouden tijdens serviceoverdracht van de ene blobopslag naar een andere

--s2s-preserve-properties Behoud volledige eigenschappen tijdens service-naar-servicekopie. Voor AWS S3 en Azure File niet-enkelvoudige bestandsbron retourneert de lijstbewerking geen volledige eigenschappen van objecten en bestanden. Als u volledige eigenschappen wilt behouden, moet AzCopy nog één aanvraag per object of bestand verzenden. (standaard true)

Opties overgenomen van bovenliggende opdrachten

--cap-mbps (float) Caps the transfer rate, in megabits per seconde. De doorvoer per moment kan enigszins afwijken van de limiet. Als deze optie is ingesteld op nul of wordt weggelaten, wordt de doorvoer niet beperkt.

--output-type (tekenreeks) Indeling van de uitvoer van de opdracht. De opties zijn onder andere: tekst, json. De standaardwaarde is 'tekst'. (standaardtekst)

--trusted-microsoft-suffixes (tekenreeks) Hiermee geeft u extra domeinachtervoegsels op waar Microsoft Entra-aanmeldingstokens kunnen worden verzonden. De standaardwaarde is .core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Alle hier vermelde vermeldingen worden toegevoegd aan de standaardwaarde. Voor beveiliging moet u alleen Microsoft Azure-domeinen hier plaatsen. Scheid meerdere vermeldingen met puntkomma's.

Zie ook