azcopy copy
Kopiuje dane źródłowe do lokalizacji docelowej.
Uwaga
Narzędzie AzCopy nie obsługuje scenariuszy, w których źródło lub miejsce docelowe jest aktywnie zmieniane podczas transferu.
Streszczenie
Kopiuje dane źródłowe do lokalizacji docelowej. Obsługiwane wskazówki to:
- local <—> Azure Blob (uwierzytelnianie SAS lub OAuth)
- local <—> Azure Files (uwierzytelnianie współużytkowe/katalog sas lub uwierzytelnianie OAuth)
- local <—> Azure Data Lake Storage (uwierzytelnianie SAS, OAuth lub SharedKey)
- Azure Blob (SAS lub publiczny) —> Azure Blob (uwierzytelnianie SAS lub OAuth)
- Azure Data Lake Storage (SAS lub publiczny) —> Azure Data Lake Storage (uwierzytelnianie SAS lub OAuth)
- Azure Blob (uwierzytelnianie SAS lub OAuth) <—> Azure Blob (uwierzytelnianie SAS lub OAuth) — zobacz Wskazówki.
- Azure Data Lake Storage (uwierzytelnianie SAS lub OAuth) <—> Azure Data Lake Storage (uwierzytelnianie SAS lub OAuth)
- Azure Data Lake Storage (uwierzytelnianie SAS lub OAuth) <—> Azure Blob (uwierzytelnianie SAS lub OAuth)
- Azure Blob (SAS lub publiczny) —> Azure Files (SAS)
- Azure File (uwierzytelnianie SAS lub OAuth) <—> usługa Azure File (uwierzytelnianie SAS lub OAuth)
- Azure Files (SAS) —> Azure Blob (uwierzytelnianie SAS lub OAuth)
- AWS S3 (klucz dostępu) —> blokowy obiekt blob platformy Azure (uwierzytelnianie SAS lub OAuth)
- Google Cloud Storage (klucz konta usługi) —> blokowy obiekt blob platformy Azure (uwierzytelnianie SAS lub OAuth)
Aby uzyskać więcej informacji, zapoznaj się z przykładami.
Zaawansowani
Narzędzie AzCopy automatycznie wykrywa typ zawartości plików podczas przekazywania z dysku lokalnego na podstawie rozszerzenia pliku lub zawartości (jeśli nie określono rozszerzenia).
Wbudowana tabela odnośników jest mała, ale w systemie Unix jest rozszerzana przez pliki mime.types systemu lokalnego, jeśli są dostępne pod co najmniej jedną z następujących nazw:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
W systemie Windows typy MIME są wyodrębniane z rejestru. Tę funkcję można wyłączyć za pomocą flagi. Zapoznaj się z sekcją flagi.
Jeśli ustawisz zmienną środowiskową przy użyciu wiersza polecenia, ta zmienna będzie czytelna w historii wiersza polecenia. Rozważ wyczyszczenie zmiennych zawierających poświadczenia z historii wiersza polecenia. Aby zachować wyświetlanie zmiennych w historii, możesz użyć skryptu, aby wyświetlić monit o podanie poświadczeń użytkownika i ustawić zmienną środowiskową.
azcopy copy [source] [destination] [flags]
Powiązane artykuły koncepcyjne
- Wprowadzenie do narzędzia AzCopy
- Transferowanie danych za pomocą narzędzia AzCopy i usługi Blob Storage
- Transferowanie danych za pomocą narzędzia AzCopy i magazynu plików
Przykłady
Przekaż pojedynczy plik przy użyciu uwierzytelniania OAuth. Jeśli jeszcze nie zalogowano się do narzędzia AzCopy, uruchom polecenie azcopy login przed uruchomieniem następującego polecenia.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
Tak samo jak powyżej, ale tym razem również obliczysz skrót MD5 zawartości pliku i zapisz go jako właściwość Content-MD5 obiektu blob:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
Przekaż pojedynczy plik przy użyciu tokenu SAS:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Przekaż pojedynczy plik przy użyciu tokenu SAS i potokowania (tylko blokowe obiekty blob):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Przekaż pojedynczy plik przy użyciu protokołu OAuth i potoku (tylko blokowe obiekty blob):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Przekaż cały katalog przy użyciu tokenu SAS:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
lub
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
Przekaż zestaw plików przy użyciu tokenu SAS i symboli wieloznacznych (*) znaków:
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
Przekaż pliki i katalogi przy użyciu tokenu SAS i symboli wieloznacznych (*) znaków:
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Przekaż pliki i katalogi do konta usługi Azure Storage i ustaw tagi zakodowane w ciągu zapytania w obiekcie blob.
- Aby ustawić tagi {key = "bla bla", val = "foo"} i {key = "bla 2", val = "bar"}, użyj następującej składni:
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"- Klucze i wartości są kodowane za pomocą adresu URL, a pary klucz-wartość są oddzielone znakiem ampersand('&')
- Podczas ustawiania tagów w obiektach blob istnieje więcej uprawnień (nie dla tagów) w sygnaturze dostępu współdzielonego, bez których usługa zwraca błąd autoryzacji.
Pobierz pojedynczy plik przy użyciu uwierzytelniania OAuth. Jeśli jeszcze nie zalogowano się do narzędzia AzCopy, uruchom polecenie azcopy login przed uruchomieniem następującego polecenia.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
Pobierz pojedynczy plik przy użyciu tokenu SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Pobierz pojedynczy plik przy użyciu tokenu SAS, a następnie potokowanie danych wyjściowych do pliku (tylko blokowe obiekty blob):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Pobierz pojedynczy plik przy użyciu protokołu OAuth, a następnie potokowanie danych wyjściowych do pliku (tylko blokowe obiekty blob):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Pobierz cały katalog przy użyciu tokenu SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
Uwaga dotycząca używania symbolu wieloznakowego (*) w adresach URL:
Istnieją tylko dwa obsługiwane sposoby używania symbolu wieloznakowego w adresie URL.
Możesz użyć jednego tuż po ostatnim ukośniku (/) adresu URL. Spowoduje to skopiowanie wszystkich plików w katalogu bezpośrednio do miejsca docelowego bez umieszczania ich w podkatalogu.
Można również użyć jednego w nazwie kontenera, o ile adres URL odnosi się tylko do kontenera, a nie do obiektu blob. Za pomocą tego podejścia można uzyskać pliki z podzestawu kontenerów.
Pobierz zawartość katalogu bez kopiowania samego katalogu zawierającego.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Pobierz całe konto magazynu.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Pobierz podzbiór kontenerów na koncie magazynu przy użyciu symbolu wieloznacznego (*) w nazwie kontenera.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
Pobierz wszystkie wersje obiektu blob z usługi Azure Storage wymienione w pliku tekstowym (na przykład: versionidsFile) do katalogu lokalnego. Upewnij się, że źródło jest prawidłowym obiektem blob, miejscem docelowym jest folder lokalny i versionidsFile jest plikiem tekstowym, w którym każda wersja jest zapisywana w osobnym wierszu. Wszystkie określone wersje są pobierane w określonym folderze docelowym.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
Skopiuj pojedynczy obiekt blob do innego obiektu blob przy użyciu tokenu SAS.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Skopiuj pojedynczy obiekt blob do innego obiektu blob przy użyciu tokenu SAS i tokenu OAuth.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
Skopiuj jeden katalog wirtualny obiektu blob do innego przy użyciu tokenu SAS:
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
Skopiuj wszystkie kontenery obiektów blob, katalogi i obiekty blob z konta magazynu do innego przy użyciu tokenu SAS:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Skopiuj pojedynczy obiekt do usługi Blob Storage z usług Amazon Web Services (AWS) S3 przy użyciu klucza dostępu i tokenu SAS. Najpierw ustaw zmienną środowiskową AWS_ACCESS_KEY_ID i AWS_SECRET_ACCESS_KEY dla źródła usługi AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Skopiuj cały katalog do usługi Blob Storage z usługi AWS S3 przy użyciu klucza dostępu i tokenu SAS. Najpierw ustaw zmienną środowiskową AWS_ACCESS_KEY_ID i AWS_SECRET_ACCESS_KEY dla źródła usługi AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Zapoznaj się z artykułem , aby https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html lepiej zrozumieć symbol zastępczy [folder].
Skopiuj wszystkie zasobniki do usługi Blob Storage z usług Amazon Web Services (AWS) przy użyciu klucza dostępu i tokenu SAS. Najpierw ustaw zmienną środowiskową AWS_ACCESS_KEY_ID i AWS_SECRET_ACCESS_KEY dla źródła usługi AWS S3.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Skopiuj wszystkie zasobniki do usługi Blob Storage z regionu usług Amazon Web Services (AWS) przy użyciu klucza dostępu i tokenu SAS. Najpierw ustaw zmienną środowiskową AWS_ACCESS_KEY_ID i AWS_SECRET_ACCESS_KEY dla źródła usługi AWS S3.
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Skopiuj podzbiór zasobników przy użyciu symbolu wieloznacznego (*) w nazwie zasobnika. Podobnie jak w poprzednich przykładach, potrzebujesz klucza dostępu i tokenu SAS. Upewnij się, że ustawiono zmienną środowiskową AWS_ACCESS_KEY_ID i AWS_SECRET_ACCESS_KEY dla źródła usługi AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Skopiuj obiekty blob z jednego magazynu obiektów blob do innego i zachowaj tagi ze źródła. Aby zachować tagi, użyj następującej składni:
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
Przenieś pliki i katalogi na konto usługi Azure Storage i ustaw podane tagi zakodowane w ciągu zapytania w obiekcie blob.
Aby ustawić tagi {key = "bla bla", val = "foo"} i {key = "bla 2", val = "bar"}, użyj następującej składni:
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"Klucze i wartości są kodowane za pomocą adresu URL, a pary klucz-wartość są oddzielone znakiem ampersand('&')
Podczas ustawiania tagów obiektów blob istnieją dodatkowe uprawnienia (nie dla tagów) w sygnaturze dostępu współdzielonego, bez których usługa zwróci błąd autoryzacji.
Skopiuj pojedynczy obiekt do usługi Blob Storage z usługi Google Cloud Storage (GCS) przy użyciu klucza konta usługi i tokenu SAS. Najpierw ustaw zmienną środowiskową GOOGLE_APPLICATION_CREDENTIALS dla źródła GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Skopiuj cały katalog do usługi Blob Storage z usługi Google Cloud Storage (GCS) przy użyciu klucza konta usługi i tokenu SAS. Najpierw ustaw zmienną środowiskową GOOGLE_APPLICATION_CREDENTIALS dla źródła GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Skopiuj cały zasobnik do usługi Blob Storage z usługi Google Cloud Storage (GCS) przy użyciu klucza konta usługi i tokenu SAS. Najpierw ustaw zmienną środowiskową GOOGLE_APPLICATION_CREDENTIALS dla źródła GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Skopiuj wszystkie zasobniki do usługi Blob Storage z usługi Google Cloud Storage (GCS) przy użyciu klucza konta usługi i tokenu SAS. Najpierw ustaw zmienne środowiskowe GOOGLE_APPLICATION_CREDENTIALS i GOOGLE_CLOUD_PROJECT=<project-id> dla źródła GCS
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Skopiuj podzbiór zasobników przy użyciu symbolu wieloznacznego (*) w nazwie zasobnika z usługi Google Cloud Storage (GCS) przy użyciu klucza konta usługi i tokenu SAS dla miejsca docelowego. Najpierw ustaw zmienne GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> środowiskowe dla źródła GCS
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Aby skopiować pliki zmienione przed rozpoczęciem zadania narzędzia AzCopy lub po nim, narzędzie AzCopy udostępnia datę i godzinę w dzienniku zadania w formacie ISO8601 (wyszukaj ciąg "ISO 8601 START TIME" w dzienniku zadań), którego można używać z flagami --include-after i --include-before , zobacz przykłady poniżej. Jest to przydatne w przypadku kopii przyrostowych.
Skopiuj podzbiór plików zmodyfikowanych w określonym formacie daty i godziny (w formacie ISO8601) w kontenerze przy użyciu flagi include-after .
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"
Skopiuj podzbiór plików zmodyfikowanych zgodnie z daną datą i godziną (w formacie ISO8601) w kontenerze przy użyciu flagi include-before .
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"
Opcje
--as-subdir Wartość true domyślnie. Umieszcza źródła folderów jako podkatalogi w lokalizacji docelowej. (wartość domyślna true)
--backup Aktywuje element SeBackupPrivilege systemu Windows do przekazywania lub SeRestorePrivilege do pobrania, aby umożliwić narzędziu AzCopy odczytywanie wszystkich plików, niezależnie od uprawnień systemu plików i przywracanie wszystkich uprawnień. Wymaga, aby konto z uruchomionym narzędziem AzCopy ma już te uprawnienia (na przykład ma uprawnienia administratora lub jest członkiem grupy "Operatorzy kopii zapasowych"). Ta flaga aktywuje uprawnienia, które już ma konto
--blob-tags (ciąg) Ustawianie tagów obiektów blob w celu kategoryzowania danych na koncie magazynu
--blob-type (ciąg) Definiuje typ obiektu blob w miejscu docelowym. Jest to używane do przekazywania obiektów blob i kopiowania między kontami (domyślnie "Wykryj"). Prawidłowe wartości obejmują "Detect", "BlockBlob", "PageBlob" i "AppendBlob". Podczas kopiowania między kontami wartość "Detect" powoduje, że narzędzie AzCopy używa typu źródłowego obiektu blob w celu określenia typu docelowego obiektu blob. Podczas przekazywania pliku funkcja "Wykryj" określa, czy plik jest plikiem VHD lub VHDX opartym na rozszerzeniu pliku. Jeśli plik jest plikiem VHD lub VHDX, narzędzie AzCopy traktuje plik jako stronicowy obiekt blob. (domyślne "Wykryj")
--block-blob-tier (ciąg) przekaż blokowy obiekt blob do usługi Azure Storage przy użyciu tej warstwy obiektów blob. (domyślne "Brak")
--block-size-mb (zmiennoprzecinkowy) Użyj tego rozmiaru bloku (określonego w programie MiB) podczas przekazywania do usługi Azure Storage i pobierania z usługi Azure Storage. Wartość domyślna jest obliczana automatycznie na podstawie rozmiaru pliku. Ułamki dziesiętne są dozwolone (na przykład: 0,25). Podczas przekazywania lub pobierania maksymalny dozwolony rozmiar bloku wynosi 0,75 * AZCOPY_BUFFER_GB. Aby dowiedzieć się więcej, zobacz Optymalizowanie użycia pamięci.
--cache-control (ciąg) Ustaw nagłówek cache-control. Zwrócony podczas pobierania.
--check-length Sprawdź długość pliku w miejscu docelowym po przeniesieniu. Jeśli między źródłem a miejscem docelowym występuje niezgodność, transfer zostanie oznaczony jako niepowodzenie. (wartość domyślna true)
--check-md5 (ciąg) Określa, jak należy sprawdzić poprawność skrótów MD5 podczas pobierania. Dostępne tylko podczas pobierania. Dostępne opcje: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (ustawienie domyślne "FailIfDifferent") (ustawienie domyślne "FailIfDifferent")
--content-disposition (ciąg) Ustaw nagłówek content-disposition. Zwrócony podczas pobierania.
--content-encoding (ciąg) Ustaw nagłówek kodowania zawartości. Zwrócony podczas pobierania.
--content-language (ciąg) Ustaw nagłówek języka zawartości. Zwrócony podczas pobierania.
--content-type (ciąg) Określa typ zawartości pliku. Implikuje typ no-guess-mime. Zwrócony podczas pobierania.
--cpk-by-name (ciąg) Klient podał klucz według nazwy, który daje klientom wysyłanie żądań do usługi Azure Blob Storage w celu udostępnienia klucza szyfrowania dla poszczególnych żądań. Podana nazwa klucza jest pobierana z usługi Azure Key Vault i służy do szyfrowania danych
--cpk-by-value Wartość false domyślnie. Klient podał klucz według nazwy, który umożliwia klientom wysyłanie żądań do usługi Azure Blob Storage w celu udostępnienia klucza szyfrowania dla poszczególnych żądań. Podany klucz i jego skrót są pobierane ze zmiennych środowiskowych
--decompress Automatycznie dekompresuj pliki podczas pobierania, jeśli ich kodowanie zawartości wskazuje, że są kompresowane. Obsługiwane wartości kodowania zawartości to "gzip" i "deflate". Rozszerzenia plików ".gz"/".gzip" lub ".zz" nie są konieczne, ale są usuwane, jeśli istnieją.
--disable-auto-decoding Wartość false domyślnie umożliwia automatyczne dekodowanie nielegalnych znaków w systemie Windows. Można ustawić wartość true, aby wyłączyć automatyczne dekodowanie.
--dry-run Wartość false domyślnie. Drukuje ścieżki plików, które zostaną skopiowane przez to polecenie. Ta flaga nie kopiuje rzeczywistych plików. Flaga --overwrite nie ma wpływu. Jeśli ustawisz flagę --overwrite na fałsz, pliki w katalogu źródłowym będą wyświetlane nawet wtedy, gdy te pliki istnieją w katalogu docelowym.
--exclude-attributes (ciąg) (Tylko system Windows) Wyklucz pliki, których atrybuty są zgodne z listą atrybutów. Na przykład: A; S; R
--exclude-blob-type (ciąg) Opcjonalnie określa typ obiektu blob (BlockBlob/ PageBlob/ AppendBlob) do wykluczenia podczas kopiowania obiektów blob z kontenera lub konta. Użycie tej flagi nie ma zastosowania do kopiowania danych z usługi spoza platformy Azure do usługi. Więcej niż jeden obiekt blob powinien być oddzielony znakem ";".
--exclude-container (ciąg) Wyklucz te kontenery tylko podczas przenoszenia z konta na konto. Wiele kontenerów można rozdzielić znakami ";".
--exclude-path (ciąg) Wyklucz te ścieżki podczas kopiowania. Ta opcja nie obsługuje symboli wieloznacznych (*). Sprawdza prefiks ścieżki względnej (na przykład: myFolder; myFolder/subDirName/file.pdf). W przypadku użycia w połączeniu z przechodzeniem konta ścieżki nie zawierają nazwy kontenera.
--exclude-pattern (ciąg) Wyklucz te pliki podczas kopiowania. Ta opcja obsługuje symbole wieloznaczne (*)
--exclude-regex (ciąg) Wyklucz całą ścieżkę względną plików, które są zgodne z wyrażeniami regularnymi. Oddzielaj wyrażenia regularne znakami ";".
--follow-symlinks Użyj linków symbolicznych podczas przekazywania z lokalnego systemu plików.
--force-if-read-only Podczas zastępowania istniejącego pliku w systemie Windows lub Azure Files wymusić zastąpienie działania, nawet jeśli istniejący plik ma ustawiony atrybut tylko do odczytu
--from-to (ciąg) Opcjonalnie określa kombinację miejsca docelowego źródła. Na przykład: LocalBlob, BlobLocal, LocalBlobFS. Potokowanie: BlobPipe, PipeBlob
-h, --help pomoc dotycząca kopiowania
--include-after (ciąg) Uwzględnij tylko te pliki zmodyfikowane w dniu lub po podanej dacie/godzinie. Wartość powinna być w formacie ISO8601. Jeśli nie określono strefy czasowej, przyjmuje się, że wartość znajduje się w lokalnej strefie czasowej maszyny z uruchomionym narzędziem AzCopy. Np. 2020-08-19T15:04:00Z o godzinie UTC lub 2020-08-19 o północy (00:00) w lokalnej strefie czasowej. Począwszy od narzędzia AzCopy 10.5, ta flaga dotyczy tylko plików, a nie folderów, więc właściwości folderu nie zostaną skopiowane podczas używania tej flagi z --preserve-smb-info programem lub --preserve-smb-permissions.
--include-attributes (ciąg) (Tylko system Windows) Uwzględnij pliki, których atrybuty są zgodne z listą atrybutów. Na przykład: A; S; R
--include-before (ciąg) Uwzględnij tylko te pliki zmodyfikowane przed lub w podanej dacie/godzinie. Wartość powinna być w formacie ISO8601. Jeśli nie określono strefy czasowej, przyjmuje się, że wartość znajduje się w lokalnej strefie czasowej maszyny z uruchomionym narzędziem AzCopy. na przykład 2020-08-19T15:04:00Z dla godziny UTC lub 2020-08-19 północy (00:00) w lokalnej strefie czasowej. Począwszy od narzędzia AzCopy 10.7 ta flaga ma zastosowanie tylko do plików, a nie folderów, więc właściwości folderu nie zostaną skopiowane podczas używania tej flagi z --preserve-smb-info programem lub --preserve-smb-permissions.
--include-directory-stub Wartość False domyślnie ignoruje wycinki katalogu. Wycinki katalogów to obiekty blob z metadanymi hdi_isfolder:true. Ustawienie wartości true spowoduje zachowanie wycinków katalogu podczas transferów. Dołączenie tej flagi bez wartości domyślnych wartości true (npazcopy copy --include-directory-stub. jest taka sama jak azcopy copy --include-directory-stub=true).
--include-path (ciąg) Dołącz tylko te ścieżki podczas kopiowania. Ta opcja nie obsługuje symboli wieloznacznych (*). Sprawdza prefiks ścieżki względnej (na przykład: myFolder; myFolder/subDirName/file.pdf).
--include-pattern (ciąg) Uwzględnij tylko te pliki podczas kopiowania. Ta opcja obsługuje symbole wieloznaczne (*). Oddzielaj pliki przy użyciu ';'.
--include-regex (ciąg) Uwzględnij tylko ścieżkę względną plików, które są zgodne z wyrażeniami regularnymi. Oddzielaj wyrażenia regularne znakami ";".
--list-of-versions (ciąg) Określa plik, w którym każdy identyfikator wersji jest wyświetlany w osobnym wierszu. Upewnij się, że źródło musi wskazywać pojedynczy obiekt blob i wszystkie identyfikatory wersji określone w pliku przy użyciu tej flagi muszą należeć tylko do źródłowego obiektu blob. Narzędzie AzCopy pobierze określone wersje w udostępnionym folderze docelowym.
--metadata (ciąg) Przekaż do usługi Azure Storage przy użyciu tych par klucz-wartość jako metadanych.
--no-guess-mime-type Zapobiega wykrywaniu typu zawartości przez narzędzie AzCopy na podstawie rozszerzenia lub zawartości pliku.
--overwrite (ciąg) Zastąp pliki powodujące konflikty i obiekty blob w miejscu docelowym, jeśli ta flaga ma wartość true. (wartość domyślna "true") Możliwe wartości to "true", "false", "prompt" i "ifSourceNewer". W przypadku miejsc docelowych obsługujących foldery właściwości na poziomie folderu powodujące konflikt są zastępowane, jeśli ta flaga ma wartość "true" lub czy do monitu zostanie dostarczona pozytywna odpowiedź. (wartość domyślna "true")
--page-blob-tier (ciąg) Przekaż stronicowy obiekt blob do usługi Azure Storage przy użyciu tej warstwy obiektów blob. (wartość domyślna "Brak"). (domyślne "Brak")
--preserve-last-modified-time Dostępne tylko wtedy, gdy lokalizacja docelowa to system plików.
--preserve-owner Ma wpływ tylko na pobieranie i tylko wtedy, gdy --preserve-smb-permissions jest używany. Jeśli wartość true (wartość domyślna), plik Właściciel i Grupa są zachowywane w plikach do pobrania. Jeśli ustawiono wartość false,
--preserve-smb-permissions zachowa listy ACL, ale właściciel i grupa są oparte na użytkowniku z uruchomionym narzędziem AzCopy (wartość domyślna true)
--preserve-permissions Wartość false domyślnie. Zachowuje listy ACL między zasobami obsługującymi (Windows i Azure Files lub Azure Data Lake Storage do usługi Azure Data Lake Storage). W przypadku kont, które mają hierarchiczną przestrzeń nazw, podmiot zabezpieczeń musi być właścicielem kontenera docelowego lub musi mieć przypisaną rolę Właściciela danych obiektu blob usługi Storage w zakresie kontenera docelowego, konta magazynu, nadrzędnej grupy zasobów lub subskrypcji. W przypadku pobierania będzie również potrzebna flaga --backup , aby przywrócić uprawnienia, w których nowy właściciel nie będzie użytkownikiem z uruchomionym narzędziem AzCopy. Ta flaga dotyczy zarówno plików, jak i folderów, chyba że określono filtr tylko do pliku (na przykład include-pattern).
--preserve-posix-properties Wartość false domyślnie. Zachowuje informacje o właściwościach zebrane z stat metadanych obiektu lub statx do ich metadanych.
--preserve-smb-info W przypadku lokalizacji obsługujących protokół SMB flaga jest domyślnie ustawiona na true. Zachowuje informacje o właściwościach protokołu SMB (czas ostatniego zapisu, czas tworzenia, bity atrybutów) między zasobami obsługującymi protokół SMB (Windows i Azure Files). Przesyłane są tylko bity atrybutów obsługiwane przez usługę Azure Files; wszystkie inne są ignorowane. Ta flaga dotyczy zarówno plików, jak i folderów, chyba że określono filtr tylko do pliku (na przykład include-pattern). Informacje przesyłane dla folderów są takie same jak w przypadku plików, z wyjątkiem plików, dla Last Write Time których nigdy nie są zachowywane dla folderów. (wartość domyślna true)
--preserve-symlinks Jeśli to ustawienie jest włączone, miejsca docelowe symlinku są zachowywane jako zawartość obiektu blob, zamiast przekazywać plik lub folder na drugim końcu łącza symlinku.
--put-blob-size-mb Użyj tego rozmiaru (określonego w programie MiB) jako progu, aby określić, czy przekazać obiekt blob jako pojedyncze żądanie PUT podczas przekazywania do usługi Azure Storage. Wartość domyślna jest obliczana automatycznie na podstawie rozmiaru pliku. Ułamki dziesiętne są dozwolone (na przykład: 0,25).
--put-md5 Utwórz skrót MD5 każdego pliku i zapisz skrót jako właściwość Content-MD5 docelowego obiektu blob lub pliku. (Domyślnie skrót NIE jest tworzony). Dostępne tylko podczas przekazywania.
--recursive Przyjrzyj się podkatalogom rekursywnie podczas przekazywania z lokalnego systemu plików.
--s2s-detect-source-changed Wykryj, czy plik źródłowy/obiekt blob ulegnie zmianie podczas jego odczytu. (Ten parametr dotyczy tylko kopii typu service-to-service, ponieważ odpowiednia kontrola jest trwale włączona do przekazywania i pobierania).
--s2s-handle-invalid-metadata (ciąg) Określa sposób obsługi nieprawidłowych kluczy metadanych. Dostępne opcje: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (ustawienie domyślne "ExcludeIfInvalid"). (domyślne "ExcludeIfInvalid")
--s2s-preserve-access-tier Zachowaj warstwę dostępu podczas kopiowania usługi do usługi. Zapoznaj się z tematem Azure Blob Storage: warstwy dostępu Gorąca, Chłodna i Archiwum, aby upewnić się, że docelowe konto magazynu obsługuje ustawianie warstwy dostępu. W przypadkach, w których ustawienie warstwy dostępu nie jest obsługiwane, upewnij się, że użyj polecenia s2sPreserveAccessTier=false, aby pominąć kopiowanie warstwy dostępu. (wartość domyślna true). (wartość domyślna true)
--s2s-preserve-blob-tags Wartość false domyślnie. Zachowywanie tagów indeksu podczas transferu usługi z jednego magazynu obiektów blob do innego
--s2s-preserve-properties Zachowaj pełne właściwości podczas kopiowania do usługi. W przypadku usług AWS S3 i Azure File niezwiązanych z pojedynczym źródłem plików operacja listy nie zwraca pełnych właściwości obiektów i plików. Aby zachować pełne właściwości, narzędzie AzCopy musi wysłać jedno żądanie na obiekt lub plik. (wartość domyślna true)
--trailing-dot Domyślnie włączono obsługę operacji związanych z udziałem plików w bezpieczny sposób. Dostępne opcje: Enable, Disable. Wybierz Disable opcję powrotu do starszej wersji (potencjalnie niebezpiecznej) traktowania końcowych plików kropkowych, w których usługa plików przycina wszystkie końcowe kropki w ścieżkach. Może to spowodować potencjalne uszkodzenie danych, jeśli transfer zawiera dwie ścieżki, które różnią się tylko kropką końcową (na przykład mypath i mypath.). Jeśli ta flaga jest ustawiona na Disable , a narzędzie AzCopy napotka końcowy plik kropkowy, ostrzega klientów w dzienniku skanowania, ale nie podejmie próby przerwania operacji. Jeśli miejsce docelowe nie obsługuje końcowych plików kropkowych (Windows lub Blob Storage), narzędzie AzCopy zakończy się niepowodzeniem, jeśli końcowy plik kropki jest katalogiem głównym transferu i pomiń wszystkie końcowe ścieżki kropki napotkane podczas wyliczania.
Opcje dziedziczone z poleceń nadrzędnych
--cap-mbps (zmiennoprzecinkowy) Zwiększa szybkość transferu w megabitach na sekundę. Przepływność chwil po chwili może się nieznacznie różnić od limitu. Jeśli ta opcja jest ustawiona na zero lub zostanie pominięta, przepływność nie jest ograniczona.
--log-level (ciąg) Zdefiniuj szczegółowość dziennika dla pliku dziennika, dostępne poziomy: INFO(wszystkie żądania/odpowiedzi), WARNING (wolne odpowiedzi), ERROR (tylko żądania, które zakończyły się niepowodzeniem) i NONE (brak dzienników wyjściowych). (domyślne 'INFO'). (domyślne "INFO")
--output-type (ciąg) Format danych wyjściowych polecenia. Dostępne opcje to: tekst, json. Wartość domyślna to "text". (domyślny "tekst")
--trusted-microsoft-suffixes (ciąg) Określa dodatkowe sufiksy domeny, w których można wysyłać tokeny logowania entra firmy Microsoft. Wartość domyślna to '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Wszystkie wymienione tutaj są dodawane do wartości domyślnej. W celu zapewnienia bezpieczeństwa należy umieścić tutaj tylko domeny platformy Microsoft Azure. Oddziel wiele wpisów średnikami.