共用方式為


AzCopy v10 組態設定 (Azure 儲存體)

AzCopy 是命令列公用程式,可讓您在儲存體帳戶之間複製 Blob 或檔案。 本文包含可用來設定 AzCopy v10 的環境變數清單。

注意

如果您要尋找內容以協助您開始使用 AzCopy,請參閱 開始使用 AzCopy

AzCopy v10 環境變數

下表描述每個環境變數,並提供可協助您使用變數的內容連結。

環境變數 描述
AWS_ACCESS_KEY_ID Amazon Web Services 存取金鑰。 提供密鑰以授權 Amazon Web Services。使用 AzCopy 將資料從 Amazon S3 複製到 Azure 儲存體
AWS_SECRET_ACCESS_KEY Amazon Web Services 秘密存取密鑰 提供秘密密鑰,以授權 Amazon Web Services。 使用 AzCopy 將資料從 Amazon S3 複製到 Azure 儲存體
AZCOPY_ACTIVE_DIRECTORY_ENDPOINT 要使用的 Microsoft Entra 端點。 此變數僅用於自動登入,請在叫用登入命令時改用命令行旗標。
AZCOPY_AUTO_LOGIN_TYPE 將這個變數設定為DEVICE、、SPNMSIAZCLIPSCRED。 此變數可讓您在不使用 命令的情況下 azcopy login 授權。 請參閱 使用 AzCopy 和 Microsoft Entra ID 授權 Blob 的存取權。
AZCOPY_BUFFER_GB 指定下載和上傳檔案時,您希望 AzCopy 使用的系統記憶體數量上限。 以 GB 表示此值。 請參閱 優化記憶體使用量
AZCOPY_CACHE_PROXY_LOOKUP 根據預設,Windows 上的 AzCopy 會在主機名層級快取 Proxy 伺服器查閱(不考慮 URL 路徑)。 設定為 'true' 以外的任何其他值,以停用快取。
AZCOPY_CONCURRENCY_VALUE 指定可能發生的並行要求數目。 您可以使用此變數來增加輸送量。 如果您的電腦少於 5 個 CPU,則此變數的值會設定為 32。 否則,預設值會等於 16 乘以 CPU 數目。 此變數的預設值上限為 3000,但您可以手動設定此值的較高或更低。 請參閱 增加並行存取
AZCOPY_CONCURRENT_FILES 藉由控制我們同時起始傳輸的檔案數目,覆寫任何一次進行中的檔案數目(近似值)。
AZCOPY_CONCURRENT_SCAN 控制掃描期間所使用平行處理原則的 (max) 程度。 只會影響平行化列舉值,其中包括 Azure 檔案儲存體/Blob 和本機文件系統。
AZCOPY_CONTENT_TYPE_MAP 覆寫作業系統所定義的一或多個預設MIME類型對應。 將此變數設定為定義任何對應的 JSON 檔案路徑。 以下是範例 JSON 檔案的內容:

{
  “MIMETypeMapping”: {
    “.323”: “text/h323”,
    “.aaf”: “application/octet-stream”,
    “.aca”: “application/octet-stream”,
    “.accdb”: “application/msaccess”
     }
}
AZCOPY_DEFAULT_SERVICE_API_VERSION 覆寫服務 API 版本,讓 AzCopy 可以容納 Azure Stack 等自定義環境。
AZCOPY_DISABLE_HIERARCHICAL_SCAN 僅適用於 Azure Blob 是來源時。 並行掃描速度較快,但採用階層式清單 API,這可能會導致更多 IO/成本。 指定 'true' 以犧牲效能,但節省成本。
AZCOPY_DISABLE_SYSLOG 停用 Syslog 或 Windows 事件記錄器中的記錄。 根據預設,AzCopy 會將記錄傳送至這些通道。 如果您想要減少 Syslog 或 Windows 事件記錄檔中的雜訊,您可以將此變數設定為 true。
AZCOPY_DOWNLOAD_TO_TEMP_PATH 將 AzCopy 設定為在實際下載之前下載至暫存路徑。 允許的值為 true 或 false
AZCOPY_JOB_PLAN_LOCATION 覆寫作業計畫檔案的儲存位置(用於進度追蹤和繼續),以避免填滿磁碟。
AZCOPY_LOG_LOCATION 覆寫儲存記錄檔的位置,以避免填滿磁碟。
AZCOPY_MSI_CLIENT_ID 使用者指派受控識別的用戶端標識碼。 當設定為MSIAZCOPY_AUTO_LOGIN_TYPE,請使用 。 請參閱 不使用秘密存放區授權
AZCOPY_MSI_OBJECT_ID 使用者指派受控識別的物件標識碼。 當設定為MSIAZCOPY_AUTO_LOGIN_TYPE,請使用 。 請參閱 不使用秘密存放區授權
AZCOPY_MSI_RESOURCE_STRING 使用者指派受控識別的資源標識碼。 請參閱 不使用秘密存放區授權
AZCOPY_PACE_PAGE_BLOBS 分頁 Blob 的輸送量是否應該自動調整以符合服務限制? 預設為 true。 設定為 『false』 以停用
AZCOPY_PARALLEL_STAT_FILES 當掃描本機文件系統時,會導致 AzCopy 在平行 『threads』 上查閱檔案屬性。 線程會從AZCOPY_CONCURRENT_SCAN所定義的集區中繪製。 將此設定為 true 可能會改善 Linux 上的掃描效能。 Windows 上不需要或建議使用。
AZCOPY_REQUEST_TRY_TIMEOUT 設定 AzCopy 在 AzCopy 逾時之前,應該嘗試上傳每個要求的檔案的分鐘數。
AZCOPY_SHOW_PERF_STATES 如果設定為任何專案,螢幕上的輸出將會依狀態包含區塊計數
AZCOPY_SPA_APPLICATION_ID 服務主體應用程式註冊的應用程式識別碼。 當 設定為 SPNAZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權
AZCOPY_SPA_CERT_PASSWORD 憑證的密碼。 當 設定為 SPNAZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權
AZCOPY_SPA_CERT_PATH 憑證檔案的相對或完整路徑。 當 設定為 SPNAZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權
AZCOPY_SPA_CLIENT_SECRET 客戶端密碼。 當設定為SPNAZCOPY_AUTO_LOGIN_TYPE,請使用 。 請參閱 不使用秘密存放區授權
AZCOPY_TENANT_ID 要用於 OAuth 裝置互動式登入的 Microsoft Entra 租使用者識別碼。 此變數僅用於自動登入,請在叫用登入命令時改用命令行旗標。
AZCOPY_TUNE_TO_CPU 設定為 false 以防止 AzCopy 在自動調整其並行層級時考慮 CPU 使用量(例如,在基準檢驗命令中)。
AZCOPY_USER_AGENT_PREFIX 將前置詞新增至預設 AzCopy User Agent,以用於遙測用途。 會自動插入空格。
CPK_ENCRYPTION_KEY Base64 編碼的 AES-256 加密金鑰值。 使用客戶提供的金鑰來加密和解密 Blob 記憶體作業上的數據時,讀取和寫入要求都需要此變數。 您可以藉由設定 --cpk-by-value=true 旗標來使用客戶提供的金鑰。
CPK_ENCRYPTION_KEY_SHA256 加密金鑰的Base64編碼SHA256。 使用客戶提供的金鑰來加密和解密 Blob 記憶體作業上的數據時,讀取和寫入要求都需要此變數。 您可以藉由設定 --cpk-by-value=true 旗標來使用客戶提供的金鑰。
GOOGLE_APPLICATION_CREDENTIALS 服務帳戶金鑰檔案的絕對路徑 提供金鑰以授權 Google Cloud 儲存體。 使用 AzCopy 將資料從 Google Cloud 儲存體 複製到 Azure 儲存體 (預覽)
GOOGLE_CLOUD_PROJECT Google Cloud 儲存體 中服務等級周遊所需的專案標識碼。
HTTPS_PROXY 設定 AzCopy 的 Proxy 設定。 將此變數設定為 Proxy IP 位址和 Proxy 埠號碼。 例如: xx.xxx.xx.xxx:xx 。 如果您在 Windows 上執行 AzCopy,AzCopy 會自動偵測 Proxy 設定,因此您不需要在 Windows 中使用此設定。 如果您選擇在 Windows 中使用此設定,其將會覆寫自動偵測。 請參閱 設定 Proxy 設定

設定 Proxy 設定

若要設定 AzCopy 的 Proxy 設定,請設定 HTTPS_PROXY 環境變數。 如果您在 Windows 上執行 AzCopy,AzCopy 會自動偵測 Proxy 設定,因此您不需要在 Windows 中使用此設定。 如果您選擇在 Windows 中使用此設定,其將會覆寫自動偵測。

作業系統 Command
Windows 在命令提示字元中,請使用:set HTTPS_PROXY=<proxy IP>:<proxy port>
在 PowerShell 中使用: $env:HTTPS_PROXY="<proxy IP>:<proxy port>"
Linux export HTTPS_PROXY=<proxy IP>:<proxy port>
macOS export HTTPS_PROXY=<proxy IP>:<proxy port>

目前,AzCopy 不支援使用 NTLM 或 Kerberos 進行驗證的 Proxy。

略過 Proxy

如果您在 Windows 上執行 AzCopy,而且想要告訴它 完全不使用 Proxy(而不是自動偵測設定),請使用這些命令。 使用這些設定,AzCopy 將不會查閱或嘗試使用任何 Proxy。

作業系統 Environment 命令
Windows 命令提示字元 (CMD) set HTTPS_PROXY=dummy.invalid
set NO_PROXY=*
Windows PowerShell $env:HTTPS_PROXY="dummy.invalid"
$env:NO_PROXY="*"

在其他操作系統上,如果您想要不使用 Proxy,只要將HTTPS_PROXY變數保持未設定。

另請參閱