azcopy login

登入 Microsoft Entra ID 以存取Azure 儲存體資源。

概要

登入 Microsoft Entra ID 以存取Azure 儲存體資源。

若要獲得Azure 儲存體帳戶的授權,您必須在儲存體帳戶、父資源群組或父訂用帳戶的內容中,將儲存體 Blob 資料參與者 角色指派 給使用者帳戶。

此命令會使用 OS 內建機制快取目前使用者的加密登入資訊。

重要

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

azcopy login [flags]

範例

以互動方式登入,預設的 Microsoft Entra 租使用者識別碼設定為一般:

azcopy login

使用指定的租使用者識別碼以互動方式登入:

azcopy login --tenant-id "[TenantID]"

使用虛擬機器的系統指派身分識別登入 (VM):

azcopy login --identity

使用 VM 的使用者指派身分識別,以及服務身分識別的用戶端識別碼來登入:

azcopy login --identity --identity-client-id "[ServiceIdentityClientID]"

使用 VM 的使用者指派身分識別和服務身分識別的物件識別碼登入:

azcopy login --identity --identity-object-id "[ServiceIdentityObjectID]"

使用 VM 的使用者指派身分識別,以及服務身分識別的資源識別碼來登入:

azcopy login --identity --identity-resource-id "/subscriptions/<subscriptionId>/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID"

使用用戶端密碼以服務主體身分登入:

將環境變數AZCOPY_SPA_CLIENT_SECRET設定為秘密型服務主體驗證的用戶端密碼。

azcopy login --service-principal --application-id <your service principal's application ID>

使用憑證以服務主體身分登入,其密碼如下:

將環境變數 AZCOPY_SPA_CERT_PASSWORD 設定為憑證型服務主體驗證的憑證密碼

azcopy login --service-principal --certificate-path /path/to/my/cert --application-id <your service principal's application ID>

將 /path/to/my/cert 視為 PEM 或 PKCS12 檔案的路徑--. AzCopy 無法連線到系統憑證存放區以取得您的憑證。 --certificate-path 執行憑證式服務主體驗證時,為必要專案。

登入的子命令,可檢查您目前會話的登入狀態。

azcopy login status

選項。

--aad-endpoint (字串)要使用的 Microsoft Entra 端點。 預設 ( https://login.microsoftonline.com ) 適用于全域 Azure 雲端。 在國家雲端進行驗證時設定此參數。 受控服務識別不需要。 若要查看國家雲端 Microsoft Entra 端點的清單,請參閱 Microsoft Entra 驗證端點

--application-id (字串)使用者指派身分識別的應用程式識別碼。 服務主體驗證的必要專案。

--certificate-path (字串)SPN 驗證憑證的路徑。 憑證型服務主體驗證的必要專案。

-h--help 登入說明

--identity 使用虛擬機器的身分識別登入,也稱為受控服務識別 (MSI)。

--identity-client-id (字串)使用者指派身分識別的用戶端識別碼。

--identity-object-id (字串)使用者指派身分識別的物件識別碼。

--identity-resource-id (字串)使用者指派身分識別的資源識別碼。

--service-principal 使用憑證或秘密,透過服務主體名稱 (SPN) 登入。 用戶端密碼或憑證密碼必須放在適當的環境變數中。 輸入 AzCopy env 以查看環境變數的名稱和描述。

--tenant-id (字串)要用於 OAuth 裝置互動式登入的 Microsoft Entra 租使用者識別碼。

繼承自父命令的選項

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

--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 網域。 使用分號分隔多個專案。

另請參閱