共用方式為

azcopy 複製

  • 發行項

將源數據複製到目的地位置。

注意

AzCopy 不支援會在傳輸期間主動變更來源或目的地的案例。

概要

將源數據複製到目的地位置。 支援的方向如下：

  • 本機 <-> Azure Blob（SAS 或 OAuth 驗證）
  • local <-> Azure 檔案儲存體 （共用/目錄 SAS 驗證或 OAuth 驗證）
  • 本機 <-> Azure Data Lake Storage （SAS、OAuth 或 SharedKey 驗證）
  • Azure Blob （SAS 或公用） -> Azure Blob （SAS 或 OAuth 驗證）
  • Azure Data Lake Storage （SAS 或公用） -> Azure Data Lake Storage （SAS 或 OAuth 驗證）
  • Azure Blob （SAS 或 OAuth 驗證） <-> Azure Blob （SAS 或 OAuth 驗證） - 請參閱 指導方針。
  • Azure Data Lake Storage （SAS 或 OAuth 驗證） <-> Azure Data Lake Storage （SAS 或 OAuth 驗證）
  • Azure Data Lake Storage （SAS 或 OAuth 驗證） <-> Azure Blob （SAS 或 OAuth 驗證）
  • Azure Blob （SAS 或公用） -> Azure 檔案儲存體 （SAS）
  • Azure 檔案 （SAS 或 OAuth 驗證） <-> Azure 檔案 （SAS 或 OAuth 驗證）
  • Azure 檔案儲存體 （SAS） ->Azure Blob （SAS 或 OAuth 驗證）
  • AWS S3 （存取金鑰） -> Azure 區塊 Blob （SAS 或 OAuth 驗證）
  • Google 雲端記憶體 （服務帳戶金鑰） -> Azure 區塊 Blob （SAS 或 OAuth 驗證）

如需詳細資訊，請參閱範例。

進階

AzCopy 會根據擴展名或內容，從本機磁碟上傳時，自動偵測檔案的內容類型（如果未指定擴展名）。

內建查閱表格很小，但在 Unix 上，如果可在下列其中一或多個名稱下提供，則會透過本機系統的 mime.types 檔案來增強：

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

在 Windows 上，MIME 類型會從登錄擷取。 此功能可以透過旗標的說明關閉。 請參閱旗標區段。

如果您使用命令行來設定環境變數，該變數可在命令行歷程記錄中讀取。 請考慮清除包含命令行歷程記錄認證的變數。 若要防止變數出現在您的歷程記錄中，您可以使用腳本來提示使用者輸入其認證，以及設定環境變數。

azcopy copy [source] [destination] [flags]

範例

使用 OAuth 驗證上傳單一檔案。 如果您尚未登入 AzCopy，請先執行 azcopy login 命令，再執行下列命令。

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

與上述相同，但這次也會計算檔案內容的 MD5 哈希，並將其儲存為 Blob 的 Content-MD5 屬性：

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

使用 SAS 令牌上傳單一檔案：

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

使用 SAS 令牌和管線上傳單一檔案（僅限區塊 Blob）：

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

使用 OAuth 和管線上傳單一檔案（僅限區塊 Blob）：

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

使用 SAS 令牌上傳整個目錄：

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

或

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

使用 SAS 令牌和通配符將一組檔案上傳：

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

使用 SAS 令牌與通配符檔案與目錄上傳：

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

將檔案和目錄上傳至 Azure 儲存體 帳戶，並在 Blob 上設定查詢字串編碼標記。

  • 若要設定標記 {key = “bla bla”，val = “foo”} 和 {key = “bla bla 2”， val = “bar”}，請使用下列語法：
  • 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"
  • 索引鍵和值是 URL 編碼，而索引鍵/值組會以 ampersand（'&'） 分隔
  • 在 Blob 上設定標籤時，SAS 中有更多許可權（不適用於標籤），而服務不會讓授權錯誤傳回。

使用 OAuth 驗證下載單一檔案。 如果您尚未登入 AzCopy，請先執行 azcopy login 命令，再執行下列命令。

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

使用 SAS 令牌下載單一檔案：

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

使用 SAS 令牌下載單一檔案，然後將輸出管線傳送至檔案（僅限區塊 Blob）：

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

使用 OAuth 下載單一檔案，然後將輸出管線傳送至檔案（僅限區塊 Blob）：

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

使用 SAS 令牌下載整個目錄：

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

關於在網址中使用通配符 \ 的附註：

URL 中只有兩種支援的通配符使用方式。

  • 您可以在 URL 的最後一個正斜線 （/） 之後使用一個。 這會將目錄中的所有檔案直接複製到目的地，而不將它們放入子目錄。

  • 只要 URL 只參考容器，而不是 Blob，您也可以使用容器名稱中的一個。 您可以使用此方法，從容器子集取得檔案。

下載目錄的內容，而不複製包含的目錄本身。

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

下載整個記憶體帳戶。

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

在容器名稱中使用通配符 * 下載記憶體帳戶內的容器子集。

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

將 blob 的所有版本從文字檔案中所列的 Azure 儲存體 下載到本機目錄。 versionidsFile 請確定來源是有效的 Blob，目的地是本機資料夾，而且 versionidsFile 是文本檔，其中每個版本都會在不同的行上寫入。 所有指定的版本都會在指定的目的地資料夾中下載。

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

使用 SAS 令牌將單一 Blob 複製到另一個 Blob。

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

使用 SAS 令牌和 OAuth 令牌，將單一 Blob 複製到另一個 Blob。

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

使用 SAS 令牌，將一個 Blob 虛擬目錄複製到另一個 Blob 虛擬目錄：

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

使用 SAS 令牌，將所有 Blob 容器、目錄和 Blob 從記憶體帳戶複製到另一個 Blob：

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

使用存取金鑰和 SAS 令牌，從 Amazon Web Services （AWS） S3 將單一物件複製到 Blob 記憶體。 首先，設定 AWS S3 來源的環境變數AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。

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

使用存取金鑰和 SAS 令牌，從 AWS S3 將整個目錄複製到 Blob 記憶體。 首先，設定 AWS S3 來源的環境變數AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。

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

請參閱 以 https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html 進一步瞭解 [資料夾] 佔位元。

使用存取金鑰和 SAS 令牌，將所有貯體複製到 Amazon Web Services （AWS） 的 Blob 記憶體。 首先，設定 AWS S3 來源的環境變數AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。

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

使用存取金鑰和 SAS 令牌，將所有貯體複製到 Amazon Web Services （AWS） 區域的 Blob 記憶體。 首先，設定 AWS S3 來源的環境變數AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。

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

在貯體名稱中使用萬用字元符號 (*)，以複製貯體的子集。 如同先前的範例，您需要存取密鑰和 SAS 令牌。 請務必為 AWS S3 來源設定環境變數AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。

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

將 Blob 從一個 Blob 記憶體複製到另一個 Blob 記憶體，並保留來源的標記。 若要保留標記，請使用下列語法：

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

將檔案和目錄傳送至 Azure 儲存體 帳戶，並在 Blob 上設定指定的查詢字串編碼標記。

  • 若要設定標記 {key = “bla bla”，val = “foo”} 和 {key = “bla bla 2”， val = “bar”}，請使用下列語法：

    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"

  • 索引鍵和值是 URL 編碼，而索引鍵/值組會以 ampersand（'&'） 分隔

  • 在 Blob 上設定標籤時，SAS 中有額外的許可權（不適用於標籤），而服務不會讓授權錯誤傳回。

使用服務帳戶金鑰和 SAS 令牌，將單一物件從 Google Cloud Storage （GCS） 複製到 Blob 記憶體。 首先，為 GCS 來源設定環境變數GOOGLE_APPLICATION_CREDENTIALS。

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

使用服務帳戶金鑰和 SAS 令牌，將整個目錄從 Google Cloud Storage （GCS） 複製到 Blob 記憶體。 首先，為 GCS 來源設定環境變數GOOGLE_APPLICATION_CREDENTIALS。

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

使用服務帳戶金鑰和 SAS 令牌，將整個貯體複製到 Google Cloud Storage （GCS） 中的 Blob 記憶體。 首先，為 GCS 來源設定環境變數GOOGLE_APPLICATION_CREDENTIALS。

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

使用服務帳戶金鑰和 SAS 令牌，將所有貯體從 Google Cloud Storage （GCS） 複製到 Blob 記憶體。 首先，GOOGLE_APPLICATION_CREDENTIALS和 GOOGLE_CLOUD_PROJECT=<project-id> GCS 來源設定環境變數

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

使用服務帳戶金鑰和目的地的 SAS 令牌，從 Google Cloud Storage （GCS） 的貯體名稱中，使用通配符符號 \ 複製貯體子集。 首先，設定 GCS 來源的環境變數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

若要在 AzCopy 作業開始之前或之後複製變更的檔案，AzCopy 會以ISO8601格式提供作業記錄中的日期和時間（在作業記錄中搜尋 'ISO 8601 START TIME'），這些檔案可以搭配 --include-after 和 --include-before 旗標使用，請參閱下列範例。 這對增量複本很有説明。

使用 include-after 旗標，在容器中複製在指定日期和時間 （ISO8601 格式） 上或之後修改的檔案子集。

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"

使用 include-before 旗標，在容器中複製在指定日期和時間之前修改的檔案子集（ISO8601格式）。

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"

選項。

--as-subdir True 預設為 True。 將資料夾來源放置為目的地下的子目錄。 （預設值 true）

--backup 啟用 Windows 的 SeBackupPrivilege 進行上傳，或針對下載啟用 SeRestorePrivilege，以允許 AzCopy 查看讀取所有檔案，而不論其文件系統許可權為何，以及還原所有許可權。 要求執行 AzCopy 的帳戶已經有這些許可權（例如，具有系統管理員許可權，或是 「備份操作員」群組的成員）。 此旗標會啟用帳戶已擁有的許可權

--blob-tags （字串）在 Blob 上設定標記，以分類記憶體帳戶中的數據

--blob-type （字串）定義目的地的 Blob 類型。 這用於上傳 Blob，以及在帳戶之間複製時（預設為 「偵測」）。 有效值包括 『Detect』、『BlockBlob』、『PageBlob』 和 'AppendBlob'。 在帳戶之間複製時，'Detect' 的值會使 AzCopy 使用來源 Blob 的類型來判斷目的地 Blob 的類型。 上傳檔案時，'Detect' 會根據擴展名來判斷檔案是否為 VHD 或 VHDX 檔案。 如果檔案是 VHD 或 VHDX 檔案，AzCopy 會將檔案視為分頁 Blob。 （預設 “Detect”）

--block-blob-tier（string） 使用此 Blob 層將區塊 Blob 上傳至 Azure 儲存體。 （預設值“None”）

--block-size-mb（float）上傳至 Azure 儲存體 並從 Azure 儲存體 下載時，請使用此區塊大小（以 MiB 指定）。 預設值會根據檔案大小自動計算。 允許小數點 （例如：0.25）。 上傳或下載時，允許的區塊大小上限為0.75 * AZCOPY_BUFFER_GB。 若要深入瞭解，請參閱 優化記憶體使用量。

--cache-control （字串）設定快取控件標頭。 下載時傳回。

--check-length 在傳輸之後檢查目的地上的檔案長度。 如果來源和目的地之間不符，傳輸會標示為失敗。 （預設值 true）

--check-md5 （字串）指定下載時應驗證 MD5 哈希的頻率。 只有在下載時才能使用。 可用的選項：NoCheck、LogOnly、FailIfDifferent、FailIfDifferentOrMissing。 （預設為 'FailIfDifferent'）（預設值 “FailIfDifferent”）

--content-disposition （字串）設定 content-disposition 標頭。 下載時傳回。

--content-encoding （字串）設定內容編碼標頭。 下載時傳回。

--content-language （字串）設定 content-language 標頭。 下載時傳回。

--content-type （字串）指定檔案的內容類型。 表示 no-guess-mime-type。 下載時傳回。

--cpk-by-name （字串）用戶端依名稱提供金鑰，可讓用戶端向 Azure Blob 記憶體提出要求，可以選擇根據每個要求提供加密密鑰。 提供的密鑰名稱是從 Azure 金鑰保存庫 擷取，並用來加密數據

--cpk-by-value False 預設為 False。 用戶端會依名稱提供金鑰，可讓用戶端向 Azure Blob 記憶體提出要求，以選擇根據每個要求提供加密密鑰。 提供的密鑰及其哈希是從環境變數擷取

--decompress 下載時自動解壓縮檔，如果內容編碼表示檔案已壓縮。 支援的內容編碼值為 『gzip』 和 『deflate』。 不需要 '.gz'/'.gzip' 或 '.zz' 的擴展名，但如果存在，則會移除。

--disable-auto-decoding False 預設為啟用 Windows 上非法字元的自動譯碼。 可以設定為 true 以停用自動譯碼。

--dry-run False 預設為 False。 列印此命令所複製的檔案路徑。 此旗標不會複製實際檔案。 --overwrite 旗標沒有任何作用。 如果您將 --overwrite 旗標設定為 false，即使這些檔案存在於目的地目錄中，來源目錄中的檔案也會列出。

--exclude-attributes （字串）（僅限 Windows）排除屬性符合屬性清單的檔案。 例如：A;S;R

--exclude-blob-type （字串）選擇性地指定從容器或帳戶複製 Blob 時要排除的 Blob 類型（BlockBlob/PageBlob/AppendBlob）。 使用此旗標不適用於將數據從非 Azure 服務複製到服務。 多個 Blob 應該以 ';' 分隔。

--exclude-container （字串）僅從帳戶傳輸到帳戶時，請排除這些容器。 您可以使用 『;』 分隔多個容器。

--exclude-path （字串）複製時排除這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞（例如：myFolder;myFolder/subDirName/file.pdf）。 搭配帳戶周遊使用時，路徑不會包含容器名稱。

--exclude-pattern （字串）複製時排除這些檔案。 這個選項支援通配符 \

--exclude-regex （字串）排除與正則表達式對齊之檔案的所有相對路徑。 使用 『;' 分隔正則表示式。

--follow-symlinks 從本機檔系統上傳時，請遵循符號連結。

--force-if-read-only在 Windows 或 Azure 檔案儲存體 覆寫現有的檔案時，即使現有檔案已設定只讀屬性，仍強制覆寫運作

--from-to （字串）選擇性地指定來源目的地組合。 例如：LocalBlob、BlobLocal、LocalBlobFS。 管線：BlobPipe、PipeBlob

-h， --help 複製的說明

--include-after （字串）只包含在指定日期/時間之後修改的檔案。 此值的格式應為 ISO8601。 如果未指定時區，則會假設值位於執行 AzCopy 之計算機的當地時區。 例如， 2020-08-19T15:04:00Z 在 UTC 時間，或 2020-08-19 當地時區的午夜 （00：00） 。 自 AzCopy 10.5 起，此旗標僅適用於檔案，不適用於資料夾，因此在搭配 --preserve-smb-info 或 --preserve-smb-permissions使用此旗標時，不會複製資料夾屬性。

--include-attributes （字串）（僅限 Windows）包含屬性符合屬性清單的檔案。 例如：A;S;R

--include-before （字串）只包含之前或指定日期/時間上修改的檔案。 此值的格式應為 ISO8601。 如果未指定時區，則會假設值位於執行 AzCopy 之計算機的當地時區。 例如， 2020-08-19T15:04:00Z 針對 UTC 時間，或 2020-08-19 當地時區的午夜 （00：00） 。 自 AzCopy 10.7 起，此旗標僅適用於檔案，不適用於資料夾，因此在搭配 --preserve-smb-info 或 --preserve-smb-permissions使用此旗標時，不會複製資料夾屬性。

--include-directory-stub False 預設會忽略目錄存根。 目錄存根是具有元數據 hdi_isfolder:true的 Blob。 將值設定為 true 會在傳輸期間保留目錄存根。 包含此旗標且沒有值預設值為 true （例如， azcopy copy --include-directory-stub 與 azcopy copy --include-directory-stub=true相同）。

--include-path （字串）複製時只包含這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞 （例如：myFolder;myFolder/subDirName/file.pdf）。

--include-pattern （字串）複製時只包含這些檔案。 此選項支援通配符 \。 使用 ';' 分隔檔案。

--include-regex （字串）只包含與正則表示式對齊之檔案的相對路徑。 使用 『;' 分隔正則表示式。

--list-of-versions （字串）指定檔案，其中每個版本標識碼都會列在個別行上。 請確定來源必須指向單一 Blob，而且使用此旗標在檔案中指定的所有版本識別碼都必須屬於來源 Blob。 AzCopy 會在提供的目的地資料夾中下載指定的版本。

--metadata（字串）上傳至具有這些索引鍵/值組作為元數據的 Azure 儲存體。

--no-guess-mime-type 防止 AzCopy 根據檔案的擴展名或內容來偵測內容類型。

--overwrite （字串）如果此旗標設定為 true，請覆寫目的地的衝突檔案和 Blob。 （預設值 'true'）可能的值包括 'true'、'false'、'prompt'和 'ifSourceNewer'。 對於支援資料夾的目的地，如果此旗標為 'true' 或提示提供正回應，則會覆寫衝突的資料夾層級屬性。 （預設值 “true”）

--page-blob-tier（字串）使用此 Blob 層將分頁 Blob 上傳至 Azure 儲存體。 （預設為 'None'）。 （預設值“None”）

--preserve-last-modified-time 只有在目的地是文件系統時，才能使用。

--preserve-owner 只有在下載中才會有效果，而且只有在使用時才 --preserve-smb-permissions 有作用。 如果為 true（預設值），則會在下載中保留檔案擁有者和群組。 如果設定為 false，

--preserve-smb-permissions 仍會保留 ACL，但擁有者和群組是以執行 AzCopy 的使用者為基礎 （預設值 true）

--preserve-permissions False 預設為 False。 保留感知資源之間的 ACL（Windows 和 Azure 檔案儲存體，或 Azure Data Lake Storage 至 Azure Data Lake Storage）。 對於具有階層命名空間的帳戶，您的安全性主體必須是目標容器的擁有者使用者，或者必須指派記憶體 Blob 數據擁有者角色，範圍設定為目標容器、記憶體帳戶、父資源群組或訂用帳戶。 針對下載，您也需要 --backup 旗標來還原許可權，其中新的擁有者不會是執行 AzCopy 的使用者。 除非指定僅限檔案的篩選條件，否則此旗標會同時套用至檔案和資料夾（例如 include-pattern）。

--preserve-posix-properties False 預設為 False。 保留從 stat 物件 statx 元數據或擷取到的屬性資訊。

--preserve-smb-info 針對SMB感知位置，旗標預設會設定為 true。 在SMB感知資源之間保留SMB屬性資訊（上次寫入時間、建立時間、屬性位）（Windows和 Azure 檔案儲存體）。 只會傳輸 Azure 檔案儲存體 支援的屬性位;會忽略任何其他位。 除非指定僅限檔案的篩選條件，否則此旗標會同時套用至檔案和資料夾（例如 include-pattern）。 針對資料夾傳輸的信息與檔案的資訊相同，但 Last Write Time 資料夾永遠不會保留。 （預設值 true）

--preserve-symlinks 如果啟用，符號連結目的地會保留為 Blob 內容，而不是上傳符號連結另一端的檔案或資料夾。

--put-blob-size-mb使用此大小（以MiB指定）作為臨界值，以判斷上傳至 Azure 儲存體時，是否要將 Blob 上傳為單一 PUT 要求。 預設值會根據檔案大小自動計算。 允許小數點 （例如：0.25）。

--put-md5 建立每個檔案的 MD5 哈希，並將哈希儲存為目的地 Blob 或檔案的 Content-MD5 屬性。 （根據預設，不會建立哈希。）只有在上傳時才能使用。

--recursive 從本機文件系統上傳時，以遞歸方式查看子目錄。

--s2s-detect-source-changed 偵測來源檔案/Blob 在讀取時是否變更。 （此參數僅適用於服務對服務複本，因為已永久啟用上傳和下載的對應檢查。

--s2s-handle-invalid-metadata （字串）指定如何處理無效的元數據索引鍵。 可用選項：ExcludeIfInvalid、FailIfInvalid、RenameIfInvalid。 （預設為 'ExcludeIfInvalid'）。 （預設值 “ExcludeIfInvalid”）

--s2s-preserve-access-tier 在服務對服務複製期間保留存取層。 請參閱 Azure Blob 記憶體：經常性存取層、非經常性存取層和封存存取層，以確保目的地記憶體帳戶支援設定存取層。 在不支持設定存取層的情況下，請務必使用 s2sPreserveAccessTier=false 來略過複製存取層。 （預設值為 true）。 （預設值 true）

--s2s-preserve-blob-tags False 預設為 False。 在服務期間保留索引標籤，以將服務從一個 Blob 記憶體傳輸到另一個 Blob 記憶體

--s2s-preserve-properties 在服務到服務複本期間保留完整屬性。 針對 AWS S3 和 Azure 檔案非單一檔案來源，清單作業不會傳回物件和檔案的完整屬性。 若要保留完整的屬性，AzCopy 必須為每個物件或檔案傳送一個以上的要求。 （預設值 true）

--trailing-dot 默認啟用以安全的方式處理檔案共享相關作業。 可用選項： Enable、 Disable。 選擇 Disable 回到舊版 （可能不安全） 處理尾端點檔案，其中檔案服務會修剪路徑中的任何尾端點。 如果傳輸只包含尾端點不同的兩個路徑，這可能會導致數據損毀（例如 mypath 和 mypath.）。 如果此旗標設定為 Disable ，且 AzCopy 遇到尾端的點檔案，則會警告掃描記錄中的客戶，但不會嘗試中止作業。 如果目的地不支援尾端點檔案 （Windows 或 Blob 記憶體），如果尾端點檔案是傳輸的根目錄，且略過列舉期間遇到的任何尾端點路徑，AzCopy 將會失敗。

繼承自父命令的選項

--cap-mbps （float）以每秒 MB 為單位來限制傳輸速率。 暫時輸送量可能會與上限稍有不同。 如果此選項設定為零，或省略此選項，則不會限制輸送量。

--log-level （字串）定義記錄檔的記錄詳細資訊、可用的層級：INFO（所有要求/回應）、WARNING（慢速回應）、ERROR（僅失敗的要求），以及 NONE（沒有輸出記錄）。 （預設為 'INFO'）。 （預設“INFO”）

--output-type （字串）命令輸出的格式。 選項包括：text、json。 預設值為 『text』。 （預設 “text”）

--trusted-microsoft-suffixes （字串）指定可以傳送Microsoft Entra 登入令牌的其他網域後綴。 預設值為 『.core.windows.net;。core.chinacloudapi.cn;。core.cloudapi.de;。core.usgovcloudapi.net;*.storage.azure.net'。 此處所列的任何專案會新增至預設值。 為了安全性，您應該只在這裡放置Microsoft Azure 網域。 使用分號分隔多個專案。

另請參閱