管理您對各種服務的驗證方式
連線到您的租用戶
使用 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 >
命名 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
選用項目: 要鑑別的雲端實例
使用下列其中一個值:
PublicUsGovUsGovHighUsGovDodChina
--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 概觀