azcopy copy

Kopiuje dane źródłowe do lokalizacji docelowej.

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 SAS udziału/katalogu)
  • local <—> Azure Data Lake Storage Gen2 (uwierzytelnianie SAS, OAuth lub SharedKey)
  • Azure Blob (SAS lub public) —> Azure Blob (uwierzytelnianie SAS lub OAuth)
  • Azure Blob (SAS lub public) —> Azure Files (SAS)
  • Azure Files (SAS) —> Azure Files (SAS)
  • Azure Files (SAS) —> Azure Blob (uwierzytelnianie SAS lub OAuth)
  • AWS S3 (klucz dostępu) —> azure Block Blob (uwierzytelnianie SAS lub OAuth)
  • Google Cloud Storage (klucz konta usługi) —> uwierzytelnianie sas lub OAuth w usłudze Azure Block Blob

Aby uzyskać więcej informacji, zapoznaj się z przykładami.

Zaawansowany

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 rozszerzona o 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 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]

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 obliczysz również 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 SYGNATURy dostępu współdzielonego 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 sygnatury dostępu współdzielonego:

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 sygnatury dostępu współdzielonego 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 sygnatury dostępu współdzielonego 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ą zakodowane pod adresem URL, a pary klucz-wartość są oddzielone znakiem ampersand('&')
  • Podczas ustawiania tagów w obiektach blob istnieją dodatkowe uprawnienia (nie dotyczy tagów) w sygnaturze dostępu współdzielonego, bez których usługa zwróci 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 sygnatury dostępu współdzielonego, 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 sygnatury dostępu współdzielonego:

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 podzestaw 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 do katalogu lokalnego. Upewnij się, że źródło jest prawidłowym obiektem blob, miejscem docelowym jest folder lokalny i versionidsFile który znajduje się w ścieżce do pliku, w którym każda wersja jest zapisywana w osobnym wierszu. Wszystkie określone wersje zostaną pobrane 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 obiektów 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 za pomocą tokenu SAS:

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

Skopiuj pojedynczy obiekt do obiektu 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ług 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 Storage obiektów blob 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ług 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 https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html artykułem , aby lepiej zrozumieć symbol zastępczy [folder].

Skopiuj wszystkie zasobniki do Storage obiektów blob 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ług AWS S3.

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

Skopiuj wszystkie zasobniki do Storage obiektów blob 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ług AWS S3.

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

Skopiuj podzestaw zasobników przy użyciu symbolu wieloznacznego (*) w nazwie zasobnika. Podobnie jak w poprzednich przykładach, będziesz potrzebować 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ą zakodowane pod adresem URL, a pary klucz-wartość są oddzielone znakiem ampersand('&')

  • Podczas ustawiania tagów w obiektach blob istnieją dodatkowe uprawnienia (nie dotyczy tagów) w sygnaturze dostępu współdzielonego, bez których usługa zwróci błąd autoryzacji.

Skopiuj pojedynczy obiekt do Storage obiektów blob 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 Storage obiektów blob 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 Storage obiektów blob 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 Storage obiektów blob 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 podzestaw 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 środowiskowe GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> dla źródła GCS

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

Opcje

--as-subdir Domyślnie prawda. Umieszcza źródła folderów jako podkatalogi w obszarze docelowym. (wartość domyślna true)

--backupAktywuje Windows SeBackupPrivilege na potrzeby przekazywania lub SeRestorePrivilege do pobrania, aby umożliwić narzędziu AzCopy odczytywanie wszystkich plików, niezależnie od ich uprawnień systemu plików i przywracanie wszystkich uprawnień. Wymaga, aby konto, na którym działa narzędzie 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 ma już 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 do określenia typu docelowego obiektu blob. Podczas przekazywania pliku funkcja "Wykryj" określa, czy plik jest plikiem VHD lub VHDX na podstawie rozszerzenia 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. (wartość domyślna "Brak")

--block-size-mb(float) 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 automatycznie obliczana na podstawie rozmiaru pliku. Ułamki dziesiętne są dozwolone (na przykład: 0,25).

--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 występuje niezgodność między lokalizacją źródłową i docelową, transfer zostanie oznaczony jako nieudany. (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 pod warunkiem klucza według nazwy, który umożliwia klientom wysyłanie żądań do usługi Azure Blob Storage opcję udostępnienia klucza szyfrowania dla poszczególnych żądań. Podana nazwa klucza zostanie pobrana z usługi Azure Key Vault i będzie używana do szyfrowania danych

--cpk-by-value Klient podał klucz według nazwy, który umożliwia klientom wysyłanie żądań do usługi Azure Blob Storage opcję udostępnienia klucza szyfrowania dla poszczególnych żądań. Podany klucz i jego skrót zostaną pobrane 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 zostaną usunięte, jeśli istnieje.

--disable-auto-decodingWartość False domyślnie umożliwia automatyczne dekodowanie nielegalnych znaków na Windows. Można ustawić wartość true, aby wyłączyć automatyczne dekodowanie.

--dry-run Drukuje ścieżki plików, które zostaną skopiowane przez to polecenie. Ta flaga nie kopiuje rzeczywistych plików.

--exclude-attributes(ciąg) (tylko Windows) Wyklucz pliki, których atrybuty pasują do listy 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 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. Oddzielanie wyrażeń regularnych znakami ";".

--follow-symlinks Użyj linków symbolicznych podczas przekazywania z lokalnego systemu plików.

--force-if-read-onlyPodczas zastępowania istniejącego pliku w Windows lub Azure Files wymuś zastąpienie pracy, 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. Potoki: BlobPipe, PipeBlob

-h, --help pomoc dotycząca kopiowania

--include-after (ciąg) Uwzględnij tylko te pliki zmodyfikowane w dniu lub po danej 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 czasu UTC lub 2020-08-19 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 folderów nie zostaną skopiowane podczas używania tej flagi z --preserve-smb-info programem lub --preserve-smb-permissions.

--include-attributes(ciąg) (tylko Windows) Dołącz pliki, których atrybuty pasują do listy 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 o północy (00:00) w lokalnej strefie czasowej. Począwszy od narzędzia AzCopy 10.7, ta flaga dotyczy tylko plików, a nie folderów, więc właściwości folderów nie zostaną skopiowane podczas używania tej flagi z --preserve-smb-info--preserve-smb-permissionslub .

--include-directory-stub Wartość False domyślnie ignoruje wycinki katalogu. Wycinki katalogu to obiekty blob z metadanymi hdi_isfolder:true. Ustawienie wartości true spowoduje zachowanie wycinków katalogu podczas transferów.

--include-path (ciąg) Uwzględnij 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. Oddzielanie wyrażeń regularnych 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, a 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.

--log-level (ciąg) Zdefiniuj szczegółowość dziennika dla pliku dziennika, dostępne poziomy: INFO(wszystkie żądania/odpowiedzi), WARNING (powolne odpowiedzi), ERROR (tylko żądania, które zakończyły się niepowodzeniem) i NONE (brak dzienników wyjściowych). (domyślne 'INFO'). (domyślne "INFO")

--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 zostaną zastąpione tą flagą jest "true" lub jeśli zostanie dostarczona pozytywna odpowiedź do monitu. (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"). (wartość domyślna "Brak")

--preserve-last-modified-time Dostępne tylko wtedy, gdy miejsce docelowe 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 nadal zachowa listy ACL, ale właściciel i grupa będą oparte na użytkowniku z uruchomionym narzędziem AzCopy (wartość domyślna true)

--preserve-permissions Domyślnie fałsz. Zachowuje listy ACL między zasobami obsługującymi (Windows i Azure Files lub Azure Data Lake Storage Gen2 do Azure Data Lake Storage Gen2). W przypadku kont hierarchicznej przestrzeni nazw będziesz potrzebować tokenu SAS lub OAuth kontenera z uprawnieniami Modyfikowanie własności i Modyfikowanie uprawnień. 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 programu AzCopy. Ta flaga dotyczy zarówno plików, jak i folderów, chyba że zostanie określony filtr tylko do pliku (na przykład wzorzec dołączania).

--preserve-smb-info W przypadku lokalizacji obsługujących protokół SMB flaga zostanie ustawiona na wartość true domyślnie. 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). Zostaną przeniesione tylko bity atrybutów obsługiwane przez Azure Files; wszystkie inne zostaną zignorowane. Ta flaga dotyczy zarówno plików, jak i folderów, chyba że zostanie określony filtr tylko do pliku (na przykład wzorzec dołączania). Informacje przesyłane dla folderów są takie same jak w przypadku plików, z wyjątkiem Last Write Time tych, które nigdy nie są zachowywane dla folderów. (wartość domyślna true)

--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 zmieni się podczas jego odczytywania. (Ten parametr dotyczy tylko kopii usługi do usługi, ponieważ odpowiednie sprawdzanie jest trwale włączone 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. (wartość domyślna "ExcludeIfInvalid"). (domyślne "ExcludeIfInvalid")

--s2s-preserve-access-tier Zachowaj warstwę dostępu podczas kopiowania usługi. Zapoznaj się z usługą Azure Blob Storage: warstwami 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 do obejścia warstwy dostępu pomijającej kopiowanie warstwy dostępu należy użyć polecenia s2sPreserveAccessTier=false. (wartość domyślna true). (wartość domyślna true)

--s2s-preserve-blob-tags 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 usługi. W przypadku usług AWS S3 i Azure File bez pojedynczego źródła 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)

Opcje dziedziczone z poleceń nadrzędnych

--cap-mbps (float) Limituje szybkość transferu w megabitach na sekundę. Przepływność moment 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.

--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 mogą być wysyłane Azure Active Directory tokeny logowania. 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 przypadku zabezpieczeń należy umieścić w tym miejscu tylko Microsoft Azure domeny. Rozdziel wiele wpisów średnikami.

Zobacz też