azcopy copy
Forrásadatok másolása célhelyre.
Feljegyzés
Az AzCopy nem támogatja azokat a forgatókönyveket, ahol a forrás vagy a cél aktívan módosul az átvitel során.
Szinopszis
Forrásadatok másolása célhelyre. A támogatott irányok a következők:
- local <–> Azure Blob (SAS- vagy OAuth-hitelesítés)
- local <–> Azure Files (Share/directory SAS-hitelesítés vagy OAuth-hitelesítés)
- local <–> Azure Data Lake Storage (SAS, OAuth vagy SharedKey-hitelesítés)
- Azure Blob (SAS vagy nyilvános) –> Azure Blob (SAS vagy OAuth-hitelesítés)
- Azure Data Lake Storage (SAS vagy nyilvános) –> Azure Data Lake Storage (SAS vagy OAuth-hitelesítés)
- Azure Blob (SAS- vagy OAuth-hitelesítés) <–> Azure Blob (SAS- vagy OAuth-hitelesítés) – Lásd az irányelveket.
- Azure Data Lake Storage (SAS- vagy OAuth-hitelesítés) <–> Azure Data Lake Storage (SAS- vagy OAuth-hitelesítés)
- Azure Data Lake Storage (SAS- vagy OAuth-hitelesítés) <–> Azure Blob (SAS vagy OAuth-hitelesítés)
- Azure Blob (SAS vagy nyilvános) –> Azure Files (SAS)
- Azure-fájl (SAS- vagy OAuth-hitelesítés) <–> Azure-fájl (SAS- vagy OAuth-hitelesítés)
- Azure Files (SAS) –> Azure Blob (SAS vagy OAuth-hitelesítés)
- AWS S3 (hozzáférési kulcs) –> Azure Block Blob (SAS vagy OAuth-hitelesítés)
- Google Cloud Storage (szolgáltatásfiókkulcs) –> Azure Block Blob (SAS vagy OAuth-hitelesítés)
További információért tekintse meg a példákat.
Felsőfokú
Az AzCopy automatikusan észleli a fájlok tartalomtípusát a helyi lemezről való feltöltéskor a fájlkiterjesztés vagy a tartalom alapján (ha nincs megadva bővítmény).
A beépített keresési tábla kicsi, de a Unix esetében a helyi rendszer mime.types fájl(ok) bővíti, ha egy vagy több ilyen név alatt elérhető:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
Windows rendszeren a RENDSZER kinyeri a MIME-típusokat a beállításjegyzékből. Ez a funkció egy jelölő segítségével kikapcsolható. Tekintse meg a jelző szakaszt.
Ha egy környezeti változót a parancssor használatával állít be, az olvasható a parancssori előzményekben. Fontolja meg a parancssori előzmények hitelesítő adatait tartalmazó változók törlését. Annak érdekében, hogy a változók ne jelenjenek meg az előzményekben, szkripttel kérheti a felhasználótól a hitelesítő adatait, és beállíthatja a környezeti változót.
azcopy copy [source] [destination] [flags]
Kapcsolódó elméleti cikkek
- Bevezetés az AzCopy használatába
- Adatok átvitele az AzCopy és a Blob Storage használatával
- Adatok átvitele az AzCopy használatával és fájltárolás
Példák
Egyetlen fájl feltöltése OAuth-hitelesítéssel. Ha még nem jelentkezett be az AzCopyba, futtassa az azcopy bejelentkezési parancsot a következő parancs futtatása előtt.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
Ugyanaz, mint korábban, de ezúttal a fájltartalom MD5 kivonatát is kiszámítja, és a blob Content-MD5 tulajdonságaként menti:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
Egyetlen fájl feltöltése SAS-jogkivonat használatával:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Egyetlen fájl feltöltése SAS-jogkivonat és piping használatával (csak blokkblobok esetén):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Egyetlen fájl feltöltése OAuth és piping használatával (csak blokkblobok esetén):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Teljes könyvtár feltöltése SAS-jogkivonat használatával:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
vagy
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
Töltsön fel egy fájlkészletet SAS-jogkivonat és helyettesítő (*) karakterek használatával:
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
Fájlok és könyvtárak feltöltése SAS-jogkivonat és helyettesítő karakterek (*) használatával:
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Töltsön fel fájlokat és könyvtárakat az Azure Storage-fiókba, és állítsa be a lekérdezési sztring kódolt címkéjét a blobon.
- A(z) {key = "bla bla", val = "foo"} és {key = "bla bla 2", val = "bar"} címkék beállításához használja a következő szintaxist:
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"
- A kulcsok és értékek URL-kódolással vannak elosztva, a kulcs-érték párokat pedig egy ampersand('>) választja el egymástól.
- Miközben címkéket állít be a blobokon, az SAS-ben több engedély (nem a címkékhez) tartoznak, amelyek nélkül a szolgáltatás engedélyezési hibát ad vissza.
Töltsön le egyetlen fájlt OAuth-hitelesítéssel. Ha még nem jelentkezett be az AzCopyba, futtassa az azcopy bejelentkezési parancsot a következő parancs futtatása előtt.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
Egyetlen fájl letöltése SAS-jogkivonat használatával:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Töltsön le egyetlen fájlt SAS-jogkivonat használatával, majd a kimenetet egy fájlba (csak blokkblobok esetén):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Töltsön le egyetlen fájlt az OAuth használatával, majd adja hozzá a kimenetet egy fájlhoz (csak blokkblobok esetén):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Töltsön le egy teljes könyvtárat SAS-jogkivonat használatával:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
Megjegyzés helyettesítő karakter (*) url-címekben való használatáról:
Az URL-címekben csak kétféleképpen használható helyettesítő karakter.
Az URL-cím utolsó perjele (/) után is használhat egyet. Ez a könyvtárban lévő összes fájlt közvetlenül a célhelyre másolja anélkül, hogy egy alkönyvtárba helyezené őket.
A tároló nevében is használhat egyet, ha az URL-cím csak egy tárolóra vonatkozik, és nem blobra. Ezzel a módszerrel fájlokat szerezhet be a tárolók egy részhalmazából.
Töltse le egy könyvtár tartalmát anélkül, hogy magát a könyvtárat másolta.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Töltsön le egy teljes tárfiókot.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Töltse le a tárolók egy részhalmazát egy tárfiókban egy helyettesítő karakter (*) használatával a tároló nevében.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
Töltse le a blob összes verzióját az Azure Storage-ból egy szövegfájlban (például: versionidsFile
) a helyi könyvtárba. Győződjön meg arról, hogy a forrás egy érvényes blob, a cél egy helyi mappa, és versionidsFile
egy szövegfájl, amelyben minden verzió külön sorba van írva. Az összes megadott verzió letöltődik a megadott célmappába.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
Egyetlen blob másolása egy másik blobba SAS-jogkivonat használatával.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Egyetlen blob másolása egy másik blobba SAS-jogkivonat és OAuth-jogkivonat használatával.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
Másolja az egyik blob virtuális könyvtárát egy másikba SAS-jogkivonat használatával:
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
Másolja az összes blobtárolót, könyvtárat és blobot a tárfiókból egy másikba SAS-jogkivonat használatával:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Egyetlen objektum másolása a Blob Storage-ba az Amazon Web Services (AWS) S3 szolgáltatásból egy hozzáférési kulcs és egy SAS-jogkivonat használatával. Először állítsa be az AWS S3-forráshoz tartozó AWS_ACCESS_KEY_ID és AWS_SECRET_ACCESS_KEY környezeti változót.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Másolja a teljes könyvtárat a Blob Storage-ba az AWS S3-ból egy hozzáférési kulcs és egy SAS-jogkivonat használatával. Először állítsa be az AWS S3-forráshoz tartozó AWS_ACCESS_KEY_ID és AWS_SECRET_ACCESS_KEY környezeti változót.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Tekintse meg a https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html [mappa] helyőrzőjének jobb megértését.
Másolja az összes gyűjtőt a Blob Storage-ba az Amazon Web Servicesből (AWS) egy hozzáférési kulcs és egy SAS-jogkivonat használatával. Először állítsa be az AWS S3-forráshoz tartozó AWS_ACCESS_KEY_ID és AWS_SECRET_ACCESS_KEY környezeti változót.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Másolja az összes gyűjtőt egy Amazon Web Services -régióból a Blob Storage-ba egy hozzáférési kulcs és egy SAS-jogkivonat használatával. Először állítsa be az AWS S3-forráshoz tartozó AWS_ACCESS_KEY_ID és AWS_SECRET_ACCESS_KEY környezeti változót.
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Másolja ki a gyűjtők egy részhalmazát egy helyettesítő karakter (*) használatával a gyűjtő nevében. Az előző példákhoz hasonlóan szüksége van egy hozzáférési kulcsra és egy SAS-jogkivonatra. Ügyeljen arra, hogy az AWS S3-forráshoz AWS_ACCESS_KEY_ID és AWS_SECRET_ACCESS_KEY környezeti változót állítsa be.
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Másolja a blobokat az egyik blobtárolóból a másikba, és őrizze meg a címkéket a forrásból. A címkék megőrzéséhez használja a következő szintaxist:
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
Fájlok és könyvtárak átvitele az Azure Storage-fiókba, és állítsa be a megadott lekérdezési sztring kódolású címkéket a blobon.
A(z) {key = "bla bla", val = "foo"} és {key = "bla bla 2", val = "bar"} címkék beállításához használja a következő szintaxist:
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"
A kulcsok és értékek URL-kódolással vannak elosztva, a kulcs-érték párokat pedig egy ampersand('>) választja el egymástól.
Miközben címkéket állít be a blobokon, az SAS-ben további engedélyek (nem a címkékhez) tartoznak, amelyek nélkül a szolgáltatás engedélyezési hibát ad vissza.
Egyetlen objektum másolása a Blob Storage-ba a Google Cloud Storage -ból (GCS) egy szolgáltatásfiókkulcs és egy SAS-jogkivonat használatával. Először állítsa be a GCS-forráshoz GOOGLE_APPLICATION_CREDENTIALS környezeti változót.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Másolja a teljes könyvtárat a Blob Storage-ba a Google Cloud Storage -ból (GCS) egy szolgáltatásfiókkulcs és egy SAS-jogkivonat használatával. Először állítsa be a GCS-forráshoz GOOGLE_APPLICATION_CREDENTIALS környezeti változót.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Másolja a teljes gyűjtőt a Blob Storage-ba a Google Cloud Storage -ból (GCS) egy szolgáltatásfiókkulcs és egy SAS-jogkivonat használatával. Először állítsa be a GCS-forráshoz GOOGLE_APPLICATION_CREDENTIALS környezeti változót.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Másolja az összes gyűjtőt a Blob Storage-ba a Google Cloud Storage -ból (GCS) egy szolgáltatásfiókkulcs és egy SAS-jogkivonat használatával. Először állítsa be a környezeti változókat GOOGLE_APPLICATION_CREDENTIALS és GOOGLE_CLOUD_PROJECT=<project-id>
a GCS-forráshoz
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Másolja a gyűjtők egy részhalmazát egy helyettesítő karakter (*) használatával a gyűjtő nevében a Google Cloud Storage -ból (GCS) egy szolgáltatásfiókkulcs és egy SAS-jogkivonat használatával a célhelyhez. Először állítsa be a GCS-forrás környezeti változóit GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id>
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Az AzCopy-feladat megkezdése előtt vagy után módosított fájlok másolásához az AzCopy dátumot és időt biztosít a feladatnaplóban ISO8601 formátumban (a feladatnaplóban az "ISO 8601 START TIME" kifejezésre kell keresnie), amely használható az és --include-before
a --include-after
jelzőkkel, lásd az alábbi példákat. Ez a növekményes példányok esetében hasznos.
Másolja a megadott dátumon és időponton (ISO8601 formátumban) módosított fájlok egy részhalmazát egy tárolóba a include-after
jelölő használatával.
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"
Másolja a megadott dátumon és időponton (ISO8601 formátumban) módosított fájlok egy részhalmazát egy tárolóba a include-before
jelölő használatával.
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"
Beállítások
--as-subdir
Alapértelmezés szerint igaz. A mappaforrásokat alkönyvtárakként helyezi el a célhely alatt. (alapértelmezett igaz)
--backup
Aktiválja a Windows SeBackupPrivilege-ját a feltöltésekhez, vagy a SeRestorePrivilege-t letöltésekhez, hogy az AzCopy minden fájlt elolvashasson, függetlenül a fájlrendszer engedélyétől, és visszaállítsa az összes engedélyt. Megköveteli, hogy az AzCopyt futtató fiók már rendelkezik ezekkel az engedélyekkel (például rendszergazdai jogosultságokkal rendelkezik, vagy tagja a Biztonsági mentési operátorok csoportnak). Ez a jelző aktiválja azokat a jogosultságokat, amelyekkel a fiók már rendelkezik
--blob-tags
(sztring) Címkék beállítása blobokon a tárfiók adatainak kategorizálásához
--blob-type
(sztring) Meghatározza a blob típusát a célhelyen. Ez a blobok feltöltésére és a fiókok közötti másolásra szolgál (alapértelmezett észlelés). Az érvényes értékek közé tartozik az "Detect", a "BlockBlob", a "PageBlob" és a "AppendBlob". A fiókok közötti másoláskor az "Detect" érték azt eredményezi, hogy az AzCopy a forrásblob típusát használja a célblob típusának meghatározásához. Fájl feltöltésekor az "Detect" határozza meg, hogy a fájl VHD- vagy VHDX-fájl-e a fájlkiterjesztés alapján. Ha a fájl VHD- vagy VHDX-fájl, az AzCopy lapblobként kezeli a fájlt. (alapértelmezett "Detect")
--block-blob-tier
(sztring) blokkblob feltöltése az Azure Storage-ba ezzel a blobszinttel. (alapértelmezett "Nincs")
--block-size-mb
(lebegőpontos) Használja ezt a blokkméretet (a MiB-ben megadva) az Azure Storage-ba való feltöltéskor és az Azure Storage-ból való letöltéskor. A rendszer automatikusan kiszámítja az alapértelmezett értéket a fájlméret alapján. Tizedes törtek megengedettek (például: 0,25). Feltöltéskor vagy letöltéskor a maximálisan engedélyezett blokkméret 0,75 * AZCOPY_BUFFER_GB. További információ: Memóriahasználat optimalizálása.
--cache-control
(sztring) Állítsa be a gyorsítótár-vezérlő fejlécét. Letöltés után visszaadva.
--check-length
Ellenőrizze egy fájl hosszát a célhelyen az átvitel után. Ha eltérés van a forrás és a cél között, a rendszer sikertelenként jelöli meg az átvitelt. (alapértelmezett igaz)
--check-md5
(sztring) Meghatározza, hogy a letöltéskor milyen szigorúan érvényesíteni kell az MD5-kivonatokat. Csak letöltéskor érhető el. Elérhető lehetőségek: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (alapértelmezett "FailIfDifferent") (alapértelmezett "FailIfDifferent")
--content-disposition
(sztring) Állítsa be a tartalomeloszlás fejlécét. Letöltés után visszaadva.
--content-encoding
(sztring) Állítsa be a tartalomkódoló fejlécet. Letöltés után visszaadva.
--content-language
(sztring) Állítsa be a tartalomnyelv fejlécét. Letöltés után visszaadva.
--content-type
(sztring) Megadja a fájl tartalomtípusát. Nem találgatásos-mime típusú. Letöltés után visszaadva.
--cpk-by-name
(sztring) Az ügyfél által megadott név alapján megadott kulcs lehetővé teszi, hogy az Azure Blob Storage-ra irányuló kéréseket intéző ügyfelek kérésenként adjanak meg egy titkosítási kulcsot. A megadott kulcsnév lekéri az Azure Key Vaultból, és az adatok titkosítására szolgál
--cpk-by-value
Alapértelmezés szerint hamis. Az ügyfél által megadott név alapján megadott kulcs lehetővé teszi, hogy az Azure Blob Storage-ra irányuló kéréseket intéző ügyfelek kérésenként adjanak meg egy titkosítási kulcsot. A megadott kulcs és kivonata lekéri a környezeti változókból
--decompress
Fájlok automatikus tömörítése letöltéskor, ha a tartalomkódolásuk azt jelzi, hogy tömörítve vannak. A támogatott tartalomkódolási értékek a "gzip" és a "deflate". A ".gz"/".gzip" vagy ".zz" fájlkiterjesztések nem szükségesek, de ha vannak, el lesznek távolítva.
--disable-auto-decoding
Alapértelmezés szerint hamis, ha engedélyezi az illegális karakterek automatikus dekódolását Windows rendszeren. Az automatikus dekódolás letiltásához igaz értékre állítható be.
--dry-run
Alapértelmezés szerint hamis. Kinyomtatja azokat a fájlelérési útvonalakat, amelyeket a parancs másolna. Ez a jelző nem másolja a tényleges fájlokat. A --overwrite jelzőnek nincs hatása. Ha a --overwrite jelzőt hamis értékre állítja, a forráskönyvtárban lévő fájlok akkor is megjelennek, ha ezek a fájlok a célkönyvtárban találhatók.
--exclude-attributes
(sztring) (csak Windows rendszeren) Zárja ki azokat a fájlokat, amelyek attribútumai megegyeznek az attribútumlistával. Például: A; S; R
--exclude-blob-type
(sztring) Opcionálisan megadja a kizárandó blob típusát (BlockBlob/ PageBlob/ AppendBlob), amikor blobokat másol a tárolóból vagy a fiókból. A jelző használata nem alkalmazható az adatok nem Azure-szolgáltatásból szolgáltatásba történő másolására. Egynél több blobot kell elválasztani a következővel: ";".
--exclude-container
(sztring) Zárja ki ezeket a tárolókat, ha csak a fiókból a fiókba szeretne átvinni. Több tároló is elválasztható a ";" fájllal.
--exclude-path
(sztring) Másoláskor zárja ki ezeket az elérési utakat. Ez a beállítás nem támogatja a helyettesítő karaktereket (*). Relatív elérési út előtagjának ellenőrzése (például: myFolder; myFolder/subDirName/file.pdf). Ha a fiókbejárással együtt használják, az elérési utak nem tartalmazzák a tároló nevét.
--exclude-pattern
(sztring) Másoláskor zárja ki ezeket a fájlokat. Ez a beállítás támogatja a helyettesítő karaktereket (*)
--exclude-regex
(sztring) Zárja ki a normál kifejezésekhez igazodó fájlok összes relatív elérési útját. A reguláris kifejezések elkülönítése az ";" kifejezéssel.
--follow-symlinks
A helyi fájlrendszerből való feltöltéskor kövesse a szimbolikus hivatkozásokat.
--force-if-read-only
Meglévő fájl felülírásakor windowsos vagy Azure Files rendszeren akkor is kényszerítse a felülírást, ha a meglévő fájl írásvédett attribútumkészlettel rendelkezik
--from-to
(sztring) Opcionálisan megadja a forrás célkombinációt. Például: LocalBlob, BlobLocal, LocalBlobFS. Piping: BlobPipe, PipeBlob
-h
, --help
segítség a másoláshoz
--include-after
(sztring) Csak a megadott dátumon/időponton vagy után módosított fájlokat vegye fel. Az értéknek ISO8601 formátumban kell lennie. Ha nincs megadva időzónia, a rendszer feltételezi, hogy az érték az AzCopyt futtató gép helyi időzónájában van. Például 2020-08-19T15:04:00Z
UTC-időpontra vagy 2020-08-19
éjfélre (00:00) a helyi időzónában. Az AzCopy 10.5-höz hasonlóan ez a jelző csak a fájlokra vonatkozik, a mappákra nem, így a mappatulajdonságok nem lesznek másolva, ha ezzel a jelölővel vagy --preserve-smb-permissions
a --preserve-smb-info
.
--include-attributes
(sztring) (csak Windows rendszeren) Olyan fájlok belefoglalása, amelyek attribútumai megegyeznek az attribútumlistával. Például: A; S; R
--include-before
(sztring) Csak azokat a fájlokat foglalja bele, amelyeket a megadott dátum/idő előtt vagy időpontban módosítottak. Az értéknek ISO8601 formátumban kell lennie. Ha nincs megadva időzónia, a rendszer feltételezi, hogy az érték az AzCopyt futtató gép helyi időzónájában van. például 2020-08-19T15:04:00Z
UTC-időpontra vagy 2020-08-19
éjfélre (00:00) a helyi időzónában. Az AzCopy 10.7-ben ez a jelölő csak a fájlokra vonatkozik, a mappákra nem, így a mappatulajdonságok nem lesznek másolva, amikor a jelölőt használja a következővel vagy --preserve-smb-permissions
.--preserve-smb-info
--include-directory-stub
Alapértelmezés szerint hamis a címtár-csonkok figyelmen kívül hagyásához. A címtár-csonkok metaadatokat hdi_isfolder:true
tartalmazó blobok. Ha igaz értékre állítja az értéket, az megőrzi a könyvtárcsonkokat az átvitel során. Ennek a jelölőnek az alapértelmezett értéke nem igaz (például ugyanaz, azcopy copy --include-directory-stub
mint azcopy copy --include-directory-stub=true
).
--include-path
(sztring) Másoláskor csak ezeket az elérési utakat vegye fel. Ez a beállítás nem támogatja a helyettesítő karaktereket (*). A relatív elérési út előtagjának ellenőrzése (például: myFolder; myFolder/subDirName/file.pdf).
--include-pattern
(sztring) Másoláskor csak ezeket a fájlokat vegye fel. Ez a beállítás támogatja a helyettesítő karaktereket (*). Fájlok elkülönítése a következővel: ";".
--include-regex
(sztring) Csak a normál kifejezésekhez igazodó fájlok relatív elérési útját adja meg. A reguláris kifejezések elkülönítése az ";" kifejezéssel.
--list-of-versions
(sztring) Olyan fájlt ad meg, amelyben minden verzióazonosító külön sorban szerepel. Győződjön meg arról, hogy a forrásnak egyetlen blobra kell mutatnia, és a jelölőt használó fájlban megadott összes verzióazonosítónak csak a forrásblobhoz kell tartoznia. Az AzCopy letölti a megadott verziókat a megadott célmappába.
--metadata
(sztring) Töltse fel az Azure Storage-ba ezekkel a kulcs-érték párokkal metaadatként.
--no-guess-mime-type
Megakadályozza, hogy az AzCopy a fájl kiterjesztése vagy tartalma alapján észlelje a tartalomtípust.
--overwrite
(sztring) Írja felül az ütköző fájlokat és blobokat a célhelyen, ha ez a jelző igaz értékre van állítva. (alapértelmezett "igaz" ) A lehetséges értékek közé tartozik az "igaz", a "false", a "prompt" és az "ifSourceNewer". A mappákat támogató célhelyek esetében az ütköző mappaszintű tulajdonságok felülíródnak, ha ez a jelző "igaz", vagy ha a rendszer pozitív választ ad a kérésnek. (alapértelmezett "true")
--page-blob-tier
(sztring) Töltse fel a lapblobot az Azure Storage-ba ezzel a blobszinttel. (alapértelmezett "Nincs"). (alapértelmezett "Nincs")
--preserve-last-modified-time
Csak akkor érhető el, ha a cél a fájlrendszer.
--preserve-owner
Csak a letöltésekben van hatása, és csak akkor, ha --preserve-smb-permissions
használatban van. Ha igaz (az alapértelmezett), a fájl tulajdonosa és a csoport megmarad a letöltésekben. Ha hamis értékre van állítva,
--preserve-smb-permissions
továbbra is megőrzi az ACL-eket, de a tulajdonos és a csoport az AzCopyt futtató felhasználón alapul (alapértelmezett igaz)
--preserve-permissions
Alapértelmezés szerint hamis. Megőrzi az ACL-eket a tudatos erőforrások (Windows és Azure Files, illetve Azure Data Lake Storage és Azure Data Lake Storage) között. Hierarchikus névtérrel rendelkező fiókok esetében a biztonsági tagnak a céltároló tulajdonosának kell lennie, vagy hozzá kell rendelnie a Storage Blob-adattulajdonos szerepkört, amely a céltárolóra, tárfiókra, szülőerőforrás-csoportra vagy előfizetésre terjed ki. Letöltések esetén a jelölőre is szüksége lesz az --backup
engedélyek visszaállításához, ha az új tulajdonos nem az AzCopyt futtató felhasználó lesz. Ez a jelző fájlokra és mappákra egyaránt vonatkozik, kivéve, ha csak fájlszűrő van megadva (például belefoglalási minta).
--preserve-posix-properties
Alapértelmezés szerint hamis. Megőrzi az objektum metaadataiból stat
vagy statx
az objektum metaadataiba beszűkült tulajdonságadatokat.
--preserve-smb-info
Az SMB-t ismerő helyeknél a jelölő alapértelmezés szerint igaz értékre van állítva. Megőrzi az SMB-tulajdonság adatait (utolsó írási idő, létrehozási idő, attribútumbitek) az SMB-képes erőforrások (Windows és Azure Files) között. Csak az Azure Files által támogatott attribútumbitek lesznek átadva; a rendszer figyelmen kívül hagyja a többit. Ez a jelző fájlokra és mappákra egyaránt vonatkozik, kivéve, ha csak fájlszűrő van megadva (például belefoglalási minta). A mappákra átvitt adatok megegyeznek a fájlok adataival, kivéve Last Write Time
, ha a mappák soha nem maradnak meg. (alapértelmezett igaz)
--preserve-symlinks
Ha engedélyezve van, a symlink-célhelyeket blobtartalomként őrzi meg a rendszer ahelyett, hogy feltöltené a fájlt vagy mappát a szimlink másik végén.
--put-blob-size-mb
Használja ezt a méretet (a MiB-ben megadva) küszöbértékként annak meghatározásához, hogy egy blobot egyetlen PUT-kérésként kell-e feltölteni az Azure Storage-ba való feltöltéskor. A rendszer automatikusan kiszámítja az alapértelmezett értéket a fájlméret alapján. Tizedes törtek megengedettek (például: 0,25).
--put-md5
Hozzon létre egy MD5 kivonatot az egyes fájlokról, és mentse a kivonatot a célblob vagy fájl Content-MD5 tulajdonságaként. (Alapértelmezés szerint a kivonat NEM jön létre.) Csak feltöltéskor érhető el.
--recursive
A helyi fájlrendszerből való feltöltéskor rekurzívan vizsgálja meg az alkönyvtárakat.
--s2s-detect-source-changed
Észleli, hogy a forrásfájl/blob megváltozik-e olvasás közben. (Ez a paraméter csak a szolgáltatásközi másolatokra vonatkozik, mert a megfelelő ellenőrzés véglegesen engedélyezve van a feltöltésekhez és letöltésekhez.)
--s2s-handle-invalid-metadata
(sztring) Az érvénytelen metaadat-kulcsok kezelésének módját adja meg. Elérhető lehetőségek: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (alapértelmezett 'ExcludeIfInvalid'). (alapértelmezett "ExcludeIfInvalid")
--s2s-preserve-access-tier
A szolgáltatási szint megőrzése a szolgáltatás másolása során. Tekintse meg az Azure Blob Storage-t: gyakori elérésű, ritka elérésű és archív hozzáférési szintek , amelyek biztosítják, hogy a céltárfiók támogatja a hozzáférési szint beállítását. Ha a hozzáférési szint beállítása nem támogatott, mindenképpen használja az s2sPreserveAccessTier=false értéket a másolási hozzáférési szint megkerüléséhez. (alapértelmezett igaz). (alapértelmezett igaz)
--s2s-preserve-blob-tags
Alapértelmezés szerint hamis. Indexcímkék megőrzése szolgáltatásról szolgáltatásra történő átvitel során az egyik blobtárolóból a másikba
--s2s-preserve-properties
A szolgáltatásról szolgáltatásra történő másolás során őrizze meg a teljes tulajdonságokat. Az AWS S3 és az Azure File nem önálló fájlforrás esetén a listaművelet nem adja vissza az objektumok és fájlok teljes tulajdonságait. A teljes tulajdonságok megőrzése érdekében az AzCopynak objektumonként vagy fájlonként még egy kérést kell küldenie. (alapértelmezett igaz)
--trailing-dot
Alapértelmezés szerint engedélyezve van a fájlmegosztással kapcsolatos műveletek biztonságos kezelése. Elérhető lehetőségek: Enable
, Disable
. Válassza ki Disable
, hogy visszatér-e a záró pontfájlok régi (potenciálisan nem biztonságos) kezelésére, ahol a fájlszolgáltatás levágja az elérési utakon lévő záró pontokat. Ez adatsérülést okozhat, ha az átvitel két olyan elérési utat tartalmaz, amelyek csak egy záró ponttal különböznek (például mypath
és mypath.
). Ha ez a jelző be van állítva Disable
, és az AzCopy záró pontfájllal találkozik, figyelmezteti az ügyfeleket a vizsgálati naplóban, de nem kísérli meg megszakítani a műveletet. Ha a célhely nem támogatja a záró pontfájlokat (Windows vagy Blob Storage), az AzCopy sikertelen lesz, ha a záró pontfájl az átvitel gyökere, és kihagyja az enumerálás során észlelt záró pontútvonalakat.
A szülőparancsoktól örökölt beállítások
--cap-mbps
(lebegőpontos) Az átviteli sebesség leértékelődése megabit/másodpercben. A pillanatonkénti átviteli sebesség kissé eltérhet a korláttól. Ha ez a beállítás nullára van állítva, vagy nincs megadva, az átviteli sebesség nincs leképezve.
--log-level
(sztring) Adja meg a naplófájl részletességét, az elérhető szinteket: INFO (minden kérés/válasz), WARNING(lassú válaszok), ERROR (csak sikertelen kérések) és NONE (nincs kimeneti napló). (alapértelmezett "INFO"). (alapértelmezett "INFO")
--output-type
(sztring) A parancs kimenetének formátuma. A lehetőségek közé tartozik: szöveg, json. Az alapértelmezett érték a "szöveg". (alapértelmezett "szöveg")
--trusted-microsoft-suffixes
(sztring) További tartományi utótagokat ad meg, ahol a Microsoft Entra bejelentkezési jogkivonatok elküldhetők. Az alapértelmezett érték a ".core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net". Az itt felsoroltak az alapértelmezett értékhez lesznek hozzáadva. A biztonság érdekében csak Microsoft Azure-tartományokat helyezzen ide. Több bejegyzés elkülönítése pontosvesszővel.