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、、SPNMSI、 AZCLI和 PSCRED。 此變數可讓您在不使用 命令的情況下 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 | 使用者指派受控識別的用戶端標識碼。 當設定為MSI時AZCOPY_AUTO_LOGIN_TYPE，請使用 。 請參閱 不使用秘密存放區授權 |
| AZCOPY_MSI_OBJECT_ID | 使用者指派受控識別的物件標識碼。 當設定為MSI時AZCOPY_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 | 服務主體應用程式註冊的應用程式識別碼。 當 設定為 SPN 時 AZCOPY_AUTO_LOGIN_TYPE ，請使用 。 請參閱 不使用秘密存放區授權 |
| AZCOPY_SPA_CERT_PASSWORD | 憑證的密碼。 當 設定為 SPN 時 AZCOPY_AUTO_LOGIN_TYPE ，請使用 。 請參閱 不使用秘密存放區授權 |
| AZCOPY_SPA_CERT_PATH | 憑證檔案的相對或完整路徑。 當 設定為 SPN 時 AZCOPY_AUTO_LOGIN_TYPE ，請使用 。 請參閱 不使用秘密存放區授權 |
| AZCOPY_SPA_CLIENT_SECRET | 客戶端密碼。 當設定為SPN時AZCOPY_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變數保持未設定。