共用方式為


PAC 驗證

管理您對各種服務的驗證方式

連線到您的租用戶

使用 pac auth create 命令 連線到您的租用戶。 執行 在您的 pac auth create 電腦上建立驗證設定檔。 您可以有多個可用的驗證設定檔。 當您使用多個租用戶時,擁有多個身份驗證配置檔很有趣。 例如,當您的公司使用多個租用戶 (用於開發、生產和測試) 時,或者當您是為多個客戶工作的顧問時。

pac auth create 命令有幾個有用的參數:

  • --environment 參數可讓您自動連線到正確的環境。 如果您省略參數 --environment ,您會連線到預設環境,但新增參數後 --environment ,您可以連線到不同的環境。 您可以使用環境 ID、URL、唯一名稱或部分名稱作為值。

  • 在您無法使用互動式體驗的環境中,新增參數 --deviceCode 可確保您仍可連線。 例如,在 GitHub Codespaces 中, --deviceCode 當您執行 pac auth create時,會自動新增參數。

Example

若要連線到 HR-Dev 環境,您可以使用下列範例:

pac auth create --environment "HR-Dev"

切換至其他驗證設定檔

當您有多個身份驗證配置檔案時,您可以使用 pac auth list 和pac auth select 命令輕鬆切換。

pac auth list 命令會列出您電腦上的所有驗證設定檔。 指令會 pac auth select 選取不同的指令。

pac auth list

若要列出所有驗證設定檔,請使用下列範例:

pac auth list

執行命令 pac auth list 會傳回所有驗證設定檔:

Index Active Kind      Name Friendly Name                   Url                                 User                                     Cloud  Type
[1]   *      UNIVERSAL      Personal Productivity (Default) https://x.crm.dynamics.com/         user@contoso.onmicrosoft.com             Public User

使用索引值選取不同的驗證設定檔。

pac auth select --index 2

Commands

Command Description
PAC 驗證清除 清除儲存在此電腦上的所有驗證設定檔
pac auth 建立 在此電腦上建立和儲存驗證設定檔
pac auth 刪除 刪除特定驗證設定檔
PAC 驗證清單 列出儲存在此電腦上的驗證設定檔
PAC 驗證名稱 命名或重新命名現有的驗證設定檔
pac auth select 選取應作用中的驗證設定檔
PAC 驗證更新 更新現有驗證設定檔的名稱或目標環境
pac auth who 顯示目前選取的驗證設定檔的相關資訊

PAC 驗證清除

清除儲存在此電腦上的所有驗證設定檔

pac auth 建立

在此電腦上建立和儲存驗證設定檔

範例

下列範例顯示命令的 pac auth create 使用方式。

基本創建

此範例會提示您輸入認證,並連線到認證所屬的租用戶。

pac auth create

備註

在 Codespaces 中執行 Power Platform CLI 時,這會觸發裝置程式碼登入。

環境創建

此範例將提示您輸入認證,並使用您指定的環境識別碼連線到 Power Platform 環境。

pac auth create --environment < Your environment ID >

小提示

若要尋找環境識別碼:

  1. 開啟 Power Platform 系統管理中心 ,然後選取您要連線的 環境 。 在 [詳細資料] 區段中,尋找 [環境識別碼]

命名 Create

此範例會向您的租用戶進行驗證,並為其提供名稱 MyOrg

pac auth create --name MyOrg

具名 Create with Service Principal

此範例會向租用戶進行驗證、為其提供名稱 MyOrg-SPN ,並使用服務主體來執行此動作。 請勿忘記將服務主體新增至您的環境。

pac auth create --name MyOrg-SPN --applicationId 00000000-0000-0000-0000-000000000000 --clientSecret $clientSecret --tenant 00000000-0000-0000-0000-000000000000

auth create 的選用參數

--applicationId -id

選用項目: 要鑑別的應用程式 ID。

--azureDevOpsFederated -adof

(預覽)使用 Azure DevOps 同盟進行服務主體驗證;需要 --tenant 和 --applicationId 引數

此參數不需要任何值。 這是一個開關。

--certificateDiskPath -cdp

選用項目: 要鑑別的憑證磁碟路徑

--certificatePassword -cp

選用項目: 要鑑別的憑證密碼

--clientSecret -cs

選用項目:要鑑別的用戶端密碼

--cloud -ci

選用項目: 要鑑別的雲端實例

使用下列其中一個值:

  • Public
  • UsGov
  • UsGovHigh
  • UsGovDod
  • China

--deviceCode -dc

使用 Microsoft Entra ID 裝置程式碼流程進行互動式登入。

此參數不需要任何值。 這是一個開關。

--environment -env

預設環境 (ID、URL、唯一名稱或部分名稱)。

--githubFederated -ghf

(預覽)使用 GitHub Federation 進行服務主體驗證;需要 --tenant 和 --applicationId 引數

此參數不需要任何值。 這是一個開關。

--managedIdentity -mi

使用 Azure 受控識別。

此參數不需要任何值。 這是一個開關。

--name -n

您要指定給此驗證設定檔的名稱(最多 30 個字元)。

注意:名稱的長度應介於 1 到 30 之間

--password -p

選用項目: 要鑑別的密碼

--tenant -t

如果使用應用程式 ID/用戶端密碼或應用程式 ID/用戶端憑證,則為租用戶 ID。

--url -u

棄用:請改用--environment

--username -un

選用:要鑑別的使用者名稱;如果未指定,則會顯示 Microsoft Entra ID 對話方塊。

備註

對於 cloud 參數,要使用的值會對應至下列其他常見首字母縮寫或名稱:

  • 海灣合作委員會 = UsGov
  • 海灣合作委員會高 = UsGovHigh
  • 國防部 = UsGovDod

WSL2 驗證問題

使用適用於 Linux 的 Windows 子系統第 2 版 (WSL2) 時,您可能會遇到驗證問題,例如 Error: Unable to open a web page using xdg-open, gnome-open, kfmclient or wslview tools 當您的 WSL2 環境中沒有設定預設瀏覽器時。

若要解決此問題,您可以將旗標新增至 --deviceCode 命令, auth create 以使用裝置代碼驗證: pac auth create --environment {env-id} --deviceCode。 您必須在 WSL2 外部的瀏覽器中輸入代碼,才能完成驗證程式。

pac auth 刪除

刪除特定驗證設定檔

Example

pac auth delete --index 2

驗證刪除的選擇性參數

--index -i

要刪除的設定檔索引

附註: 此值必須是最小值為 1 的整數。

--name -n

要作用中的設定檔名稱

注意:名稱的長度應介於 1 到 30 之間

PAC 驗證清單

列出儲存在此電腦上的驗證設定檔

PAC 驗證名稱

命名或重新命名現有的驗證設定檔

Example

下列範例顯示如何重新命名驗證設定檔。 在此情況下,索引為 1 的配置檔將會重新命名為 'Contoso Dev'。

pac auth name --index 1 --name "Contoso Dev"

驗證名稱的必要參數

--index -i

要命名/重新命名的設定檔索引

附註: 此值必須是最小值為 1 的整數。

--name -n

您要指定給此驗證設定檔的名稱(最多 30 個字元)。

注意:名稱的長度應介於 1 到 30 之間

pac auth select

選取應作用中的驗證設定檔

Example

pac auth select --index 2

auth select 的選擇性參數

--index -i

要作用中的設定檔索引。

附註: 此值必須是最小值為 1 的整數。

--name -n

要作用中的設定檔名稱

注意:名稱的長度應介於 1 到 30 之間

PAC 驗證更新

更新現有驗證設定檔的名稱或目標環境

範例

下列範例顯示如何使用 pac auth update 命令。

使用環境 URL 更新驗證設定檔

此範例顯示如何使用名稱 Contoso Dev 和環境URL https://contosodev.crm.dynamics.com更新索引為 1 的驗證設定檔。

pac auth update --index 1 --name "Contoso Dev" --environment "https://contosodev.crm.dynamics.com"

使用環境識別碼更新驗證設定檔

此範例說明如何使用環境識別碼 00000000-0000-0000-0000-000000000000更新索引 1 的驗證設定檔。

pac auth update --index 1 --environment 00000000-0000-0000-0000-000000000000

驗證更新的必要參數

--index -i

要命名/重新命名的設定檔索引

附註: 此值必須是最小值為 1 的整數。

驗證更新的選擇性參數

--environment -env

預設環境 (ID、URL、唯一名稱或部分名稱)。

--name -n

您要指定給此驗證設定檔的名稱(最多 30 個字元)。

pac auth who

顯示目前選取的驗證設定檔的相關資訊

另請參閱

Microsoft Power Platform CLI 命令群組
Microsoft Power Platform CLI 概觀