管理您對各種服務的驗證方式
連線到您的租用戶
請使用指令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"
切換至其他驗證設定檔
當你有多個認證設定檔時，你可以用 and pac auth select 指令輕鬆切換pac auth list。
此 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 auth clear | 清除儲存在此電腦上的所有驗證設定檔 |
| pac auth create | 在此電腦上建立和儲存驗證設定檔 |
| pac auth delete | 刪除特定驗證設定檔 |
| pac auth list | 列出儲存在此電腦上的驗證設定檔 |
| pac auth name | 命名或重新命名現有的驗證設定檔 |
| pac auth select | 選取應作用中的驗證設定檔 |
| pac auth update | 更新現有驗證設定檔的名稱或目標環境 |
| pac auth who | 顯示目前選取的驗證設定檔的相關資訊 |
pac auth clear
清除儲存在此電腦上的所有驗證設定檔
pac auth create
在此電腦上建立和儲存驗證設定檔
範例
下列範例顯示命令的 pac auth create 使用方式。
基本創建
這個範例會提示你輸入憑證，並連接到該憑證所屬的租戶。
pac auth create
備註
在 Codespaces 執行 Power Platform CLI 時，此操作會觸發裝置程式碼登入。
環境創建
這個範例會提示你輸入憑證，並連接到你指定的環境 ID 的 Power Platform 環境。
pac auth create --environment < Your environment ID >
小提示
要找到環境 ID：打開 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
Azure 身分識別
當在支援 Azure Identity 的環境中運行時（例如 Azure Cloud Shell、帶有管理身份的 Azure VM 或 Azure Account 擴充功能的 Visual Studio Code），你可以使用 --managedIdentity 該旗標來使用 Azure Identity 進行認證。 PAC CLI 使用 預設的 Azure 憑證 ，這是一條有主見且預先設定的憑證鏈。
預設 Azure 憑證設計支援多種環境，以及最常見的認證流程與開發者工具。 你可以依照 Azure 預設憑證文件中描述的設定環境變數來自訂行為。 例如，若要使用使用者指派的管理身份進行認證，將環境變數設 AZURE_CLIENT_ID 為該受管理身份的客戶端 ID。 更多細節請參見 「設定應用程式環境變數」。
可選參數 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 delete
刪除特定驗證設定檔
Example
pac auth delete --index 2
可選參數 auth delete
--index
-i
要刪除的設定檔索引
附註： 此值必須是最小值為 1 的整數。
--name
-n
要作用中的設定檔名稱
注意：名稱的長度應介於 1 到 30 之間
pac auth list
列出儲存在此電腦上的驗證設定檔
pac auth name
命名或重新命名現有的驗證設定檔
Example
下列範例顯示如何重新命名驗證設定檔。 在此情況下，索引為 1 的配置檔將會重新命名為 'Contoso Dev'。
pac auth name --index 1 --name "Contoso Dev"
所需參數 auth name
--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 auth update
更新現有驗證設定檔的名稱或目標環境
範例
下列範例顯示命令的 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
所需參數 auth update
--index
-i
要命名/重新命名的設定檔索引
附註： 此值必須是最小值為 1 的整數。
可選參數 auth update
--environment
-env
預設環境 （ID、URL、唯一名稱或部分名稱）。
--name
-n
您要指定給此驗證設定檔的名稱（最多 30 個字元）。
pac auth who
顯示目前選取的驗證設定檔的相關資訊
另請參閱
Microsoft Power Platform CLI 命令群組
Microsoft Power Platform CLI 概觀