azcopy copy
Kopieert brongegevens naar een doellocatie.
Notitie
AzCopy biedt geen ondersteuning voor scenario's waarbij de bron of bestemming actief wordt gewijzigd tijdens de overdracht.
Samenvatting
Kopieert brongegevens naar een doellocatie. De ondersteunde aanwijzingen zijn:
- lokaal <-> Azure Blob (SAS- of OAuth-verificatie)
- lokaal <-> Azure Files (SAS-verificatie in Share/directory of OAuth-verificatie)
- lokaal <-> Azure Data Lake Storage (SAS-, OAuth- of SharedKey-verificatie)
- Azure Blob (SAS of openbaar) -> Azure Blob (SAS of OAuth-verificatie)
- Azure Data Lake Storage (SAS of openbaar) -> Azure Data Lake Storage (SAS- of OAuth-verificatie)
- Azure Blob (SAS- of OAuth-verificatie) <-> Azure Blob (SAS- of OAuth-verificatie) - Zie richtlijnen.
- Azure Data Lake Storage (SAS- of OAuth-verificatie) <-> Azure Data Lake Storage (SAS- of OAuth-verificatie)
- Azure Data Lake Storage (SAS- of OAuth-verificatie) <-> Azure Blob (SAS- of OAuth-verificatie)
- Azure Blob (SAS of openbaar) -> Azure Files (SAS)
- Azure File (SAS- of OAuth-verificatie) <-> Azure File (SAS- of OAuth-verificatie)
- 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]
Verwante conceptuele artikelen
- Aan de slag met AzCopy
- Gegevens overdragen met AzCopy en Blob Storage
- Gegevens overdragen met AzCopy en bestandsopslag
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 uit Azure Storage die worden vermeld in een tekstbestand (bijvoorbeeld: versionidsFile
) naar de lokale map. Zorg ervoor dat de bron een geldige blob is, het doel een lokale map is en versionidsFile
een tekstbestand is 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
Als u bestanden wilt kopiëren die zijn gewijzigd voor of nadat de AzCopy-taak is gestart, geeft AzCopy datum en tijd op in het taaklogboek in ISO8601 indeling (zoek naar 'ISO 8601 START TIME' in het taaklogboek) die kunnen worden gebruikt met de --include-after
en --include-before
vlaggen, zie de onderstaande voorbeelden. Dit is handig voor incrementele kopieën.
Kopieer een subset van bestanden die zijn gewijzigd op of na de opgegeven datum en tijd (in ISO8601 indeling) in een container met behulp van de include-after
vlag.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"
Kopieer een subset van bestanden die zijn gewijzigd op of vóór de opgegeven datum en tijd (in ISO8601 indeling) in een container met behulp van de include-before
vlag.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"
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 beheerdersrechten 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
Standaard onwaar. 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
Standaard onwaar. 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-container
(tekenreeks) Sluit deze containers uit wanneer u alleen van account naar account overdraagt. Meerdere containers kunnen 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=true
waar (bijvoorbeeld azcopy 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.
--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 naar Azure Data Lake Storage). 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-posix-properties
Standaard onwaar. Behoudt eigenschapsgegevens die zijn verzameld van stat
of statx
naar objectmetagegevens.
--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
Standaard onwaar. 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)
--trailing-dot
Standaard is ingeschakeld om bestandssharebewerkingen op een veilige manier te behandelen. Beschikbare opties: Enable
, Disable
. Kies ervoor Disable
om terug te gaan naar verouderde (mogelijk onveilige) behandeling van afsluitende dot-bestanden waar de bestandsservice eventuele volgpunten in paden zal knippen. Dit kan leiden tot mogelijke beschadiging van gegevens als de overdracht twee paden bevat die alleen verschillen met een volgpunt (bijvoorbeeld mypath
en mypath.
). Als deze vlag is ingesteld op Disable
en AzCopy een volgpuntbestand tegenkomt, worden klanten in het scanlogboek gewaarschuwd, maar wordt de bewerking niet afgebroken. Als de bestemming geen ondersteuning biedt voor volgpuntbestanden (Windows of Blob Storage), mislukt AzCopy als het afsluitende puntbestand de hoofdmap van de overdracht is en eventuele volgpuntpaden die tijdens de inventarisatie zijn aangetroffen, overslaan.
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.
--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")
--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.