AzCopy 是命令列公用程式，可讓您在儲存體帳戶之間複製 Blob 或檔案。 本文包含可用來設定 AzCopy v10 的環境變數清單。
備註
如果您要尋找可協助您開始使用 AzCopy 的內容，請參閱 開始 使用 AzCopy。
AzCopy v10 環境變數
下表說明每個環境變數，並提供可協助您使用變數的內容連結。
| 環境變數 | Description |
|---|---|
| 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， MSI， SPN， AZCLIWORKLOAD或 PSCRED。 此變數提供授權而不使用 azcopy login 命令的能力。 請參閱 授權使用 AzCopy 和 Microsoft Entra ID 存取 Blob。 |
| AZCOPY_BUFFER_GB | 指定您希望 AzCopy 在下載和上傳檔案時使用的系統記憶體數量上限。 以 GB （GB） 表示此值。 請參閱 最佳化記憶體使用 |
| AZCOPY_CACHE_PROXY_LOOKUP | 根據預設，Windows 上的 AzCopy 會在主機名稱層級快取 Proxy 伺服器查閱 （，不考慮 URL 路徑） 。 設定為 'true' 以外的任何其他值以停用快取。 |
| AZCOPY_CONCURRENCY_VALUE | 指定可能發生的並行要求數目。 您可以使用此變數來增加輸送量。 如果您的電腦的 CPU 少於 5 個，則此變數的值會設定為 32。 否則，預設值等於 16 乘以 CPU 數目。 此變數的最大預設值為 3000，但您可以手動將此值設定為更高或更低。 請參閱 增加並行 |
| AZCOPY_CONCURRENT_FILES | 透過控制我們同時起始傳輸的檔案數量，覆寫任何時間正在進行的檔案數量（大約）。 |
| AZCOPY_CONCURRENT_SCAN | 控制掃描期間使用的平行度 （最大） 程度。 只會影響平行化列舉值，其中包括 Azure 檔案儲存體/Blob 和本機檔案系統。 |
| AZCOPY_CONTENT_TYPE_MAP | 置換作業系統所定義的一或多個預設 MIME 類型對應。 將此變數設定為定義任何對應的 JSON 檔案路徑。 以下是範例 JSON 檔案的內容： { “MIMEType映射”： { “.323”： “文字/h323”， “.aaf”： “應用程式/八位元組串流”， “.aca”： “應用程式/八位元組串流”， “.accdb”： “應用程式/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 | 使用者指派受控識別的用戶端識別碼。 使用 when AZCOPY_AUTO_LOGIN_TYPE 設定為 MSI。 請參閱 使用使用者指派的受控識別進行授權 |
| AZCOPY_MSI_OBJECT_ID | 使用者指派受控識別的物件識別碼。 使用 when AZCOPY_AUTO_LOGIN_TYPE 設定為 MSI。 請參閱 使用使用者指派的受控識別進行授權 |
| AZCOPY_MSI_RESOURCE_STRING | 使用者指派的受控識別的資源識別碼。 請參閱 使用使用者指派的受控識別進行授權 |
| AZCOPY_PACE_PAGE_BLOBS | 分頁 Blob 的輸送量是否應該自動調整以符合服務限制？ 預設值是「true」。 設定為「false」可停用 |
| AZCOPY_PARALLEL_STAT_FILES | 導致 AzCopy 在掃描本機檔案系統時，在平行 '執行緒' 上查閱檔案屬性。 執行緒會從AZCOPY_CONCURRENT_SCAN所定義的儲存區中繪製。 將此設定為 true 可能會改善 Linux 上的掃描效能。 在 Windows 上不需要或不建議使用。 |
| AZCOPY_REQUEST_TRY_TIMEOUT | 設定 AzCopy 在 AzCopy 逾時之前，應該嘗試上傳每個要求的檔案的分鐘數。 |
| AZCOPY_SHOW_PERF_STATES | 如果設定為任何值，螢幕上的輸出將包含依狀態的區塊計數 |
| AZCOPY_SPA_APPLICATION_ID | 服務主體應用程式註冊的應用程式識別碼。 使用 when AZCOPY_AUTO_LOGIN_TYPE 設定為 SPN。 請參閱 使用用戶端密碼授權服務主體 |
| AZCOPY_SPA_CERT_PASSWORD | 憑證的密碼。 使用 when AZCOPY_AUTO_LOGIN_TYPE 設定為 SPN。 請參閱 使用用戶端密碼授權服務主體 |
| AZCOPY_SPA_CERT_PATH | 憑證檔案的相對或完整路徑。 使用 when AZCOPY_AUTO_LOGIN_TYPE 設定為 SPN。 請參閱 使用用戶端密碼授權服務主體 |
| AZCOPY_SPA_CLIENT_SECRET | 用戶端密碼。 使用 when AZCOPY_AUTO_LOGIN_TYPE 設定為 SPN。 請參閱 使用用戶端密碼授權服務主體 |
| AZCOPY_TENANT_ID | 要用於 OAuth 裝置互動式登入的 Microsoft Entra 租用戶識別碼。 此變數僅用於自動登入，請在呼叫登入命令時改用命令列標誌。 |
| AZCOPY_TUNE_TO_CPU | 設定為 false 可防止 AzCopy 在自動調整並行層級時考慮 CPU 使用量 （例如，在基準測試命令中）。 |
| AZCOPY_USER_AGENT_PREFIX | 將前置詞新增至預設的 AzCopy 使用者代理程式，以用於遙測目的。 系統會自動插入空格。 |
| 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 Storage 進行授權。 使用 AzCopy 將資料從 Google Cloud Storage 複製到 Azure 儲存體 （預覽版） |
| GOOGLE_CLOUD_PROJECT | Google Cloud Storage 中服務等級周遊所需的專案 ID。 |
| HTTPS_PROXY | 設定 AzCopy 的 Proxy 設定。 將此變數設定為代理IP位址和代理埠號。 例如： xx.xxx.xx.xxx:xx 。 如果您在 Windows 上執行 AzCopy，AzCopy 會自動偵測 Proxy 設定，因此您不需要在 Windows 中使用此設定。 如果您選擇在 Windows 中使用此設置，它將覆蓋自動檢測。 請參閱 設定 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。
繞過代理
如果您在 Windows 上執行 AzCopy，而且您想要告訴它完全 不使用 Proxy （而不是自動偵測設定） ，請使用這些命令。 使用這些設定時，AzCopy 將不會查閱或嘗試使用任何 Proxy。
| 操作系統 | 環境 | Commands |
|---|---|---|
| Windows 作業系統 | 命令提示字元 （CMD） | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows 作業系統 | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
在其他作業系統上，如果您想不使用代理，只需將HTTPS_PROXY變數保留為未設定即可。