Windows 安裝 Microsoft Power Platform CLI，並成功連接 Power Platform 環境
Copyright Notice: This article is an original work licensed under the CC 4.0 BY-NC-ND license.
If you wish to repost this article, please include the original source link and this copyright notice.
Source link: https://v2know.com/article/1328
Microsoft Power Platform 除了可以透過瀏覽器中的 Power Apps、Power Automate、Power Pages 和 Power Platform 管理中心進行操作，也提供了官方命令列工具：
Microsoft Power Platform CLI
它的執行命令是：
pac
可以把它理解成 Power Platform 版本的 GitHub CLI：
GitHub CLI → gh
Azure CLI → az
Power Platform CLI → pac
PAC CLI 可以用來處理 Power Platform 的驗證、環境、Dataverse、Solution、Canvas App、Model-driven App、Power Pages、PCF 元件和部署流程等工作。
本文記錄如何在 Windows 中下載並安裝 PAC CLI，以及如何登入 Microsoft 帳號、確認目前環境，最終完成 PAC CLI 的基本配置。
一、下載 PAC CLI
Windows 使用者可以直接安裝 Microsoft 官方提供的 MSI 安裝包。
官方下載地址
下載 Power Platform CLI Windows 安裝包
Microsoft 官方安裝說明：
使用 Windows MSI 安裝 Power Platform CLI
下載後取得的檔案名稱通常為：
powerapps-cli-1.0.msi
開啟 MSI 安裝包後：
-
接受授權條款
-
點擊
Install -
等待安裝完成
-
點擊
Finish
官方文件也確認，Windows MSI 版本可以使用 pac install latest 取得最新更新。
二、確認 PAC CLI 是否安裝成功
安裝完成後，重新開啟 Windows PowerShell。
執行：
pac
如果安裝成功，就會顯示 Power Platform CLI 的版本和可用命令，例如：
Microsoft PowerPlatform CLI
Version: 2.9.3
Usage: pac [admin] [application] [auth] [canvas] [catalog]
[code] [connection] [connector] [copilot] [data]
[env] [model] [pages] [pcf] [solution] ...
這代表：
PAC CLI 已安裝
PowerShell 可以找到 pac 命令
Windows PATH 配置正常
關於 pac --version
在本次安裝的 PAC CLI 2.9.3 中，執行：
pac --version
雖然會先顯示版本：
Version: 2.9.3
但後面也可能顯示：
Error: Not a valid command.
這不是安裝失敗，而是因為這個版本沒有把單獨的 --version 識別為完整命令。
因此，直接執行下面的命令確認即可：
pac
或者：
pac help
三、將 PAC CLI 更新到最新版本
執行：
pac install latest
本次執行結果為：
Installing package 'Microsoft.PowerApps.CLI'
パッケージ "Microsoft.PowerApps.CLI.2.9.3" は既にインストールされています。
日文提示的意思是：
Microsoft.PowerApps.CLI 2.9.3 已經安裝。
也就是說，當前電腦中已經存在相同版本，不需要重複安裝。
Microsoft 官方推薦 Windows MSI 安裝版本使用以下命令進行更新：
pac install latest
四、登入 Microsoft Power Platform
安裝完成後，執行：
pac auth create
瀏覽器會要求登入 Microsoft 帳號。
登入成功後，PowerShell 顯示：
'[email protected]' authenticated successfully.
Validating connection...
Connected to... example.com (default)
Default organization: example.com (default)
Authentication profile created
這表示：
Microsoft 帳號驗證成功
已連接到預設 Power Platform 環境
本機驗證設定檔已建立
pac auth create 會在目前電腦建立並儲存一個驗證設定檔。PAC CLI 允許保存多個設定檔，因此也可以分別保存開發、測試、正式環境或不同客戶的登入資訊。
也可以在登入時直接指定環境：
pac auth create --environment "環境名稱或環境ID"
例如：
pac auth create --environment "Development"
五、查看目前的登入設定檔
執行：
pac auth list
輸出範例如下：
Index Active Kind Name User Cloud Type
[1] * UNIVERSAL [email protected] Public User
其中：
[1]
代表驗證設定檔的索引。
*
代表這個設定檔目前處於啟用狀態。
UNIVERSAL
代表 PAC CLI 使用的通用驗證設定檔。
Public
代表連接的是 Microsoft 公有雲環境。
User
代表目前使用一般使用者帳號登入，而不是 Service Principal 或 Managed Identity。
Microsoft 官方說明中，pac auth list 的用途就是列出保存在目前電腦上的所有驗證設定檔。
如果將來存在多個設定檔，可以使用索引切換：
pac auth select --index 2
六、確認目前登入的使用者與環境
執行：
pac auth who
輸出內容通常包括：
Connected as [email protected]
Type: User
Cloud: Public
Tenant Id: ********
Tenant Country: JP
User: [email protected]
Entra ID Object Id: ********
Environment Geo: JPN
Environment Id: ********
Environment Type: Default
Organization Id: ********
Organization Friendly Name: example.com (default)
其中比較重要的是：
| 項目 | 意義 |
|---|---|
| Connected as | 目前登入的 Microsoft 帳號 |
| Type | 登入身份種類 |
| Cloud | Microsoft 雲端種類 |
| Tenant Country | 租戶所在國家或地區 |
| Tenant ID | Microsoft Entra ID 租戶識別碼 |
| Environment ID | 目前 Power Platform 環境識別碼 |
| Environment Type | 環境類型 |
| Organization Friendly Name | Dataverse 組織顯示名稱 |
本次結果顯示：
Type: User
Cloud: Public
Tenant Country: JP
Environment Geo: JPN
Environment Type: Default
因此可以確認：
PAC CLI 已經成功連接日本區域的 Power Platform 預設環境。
pac auth who 是 Microsoft 官方提供的命令，用於顯示目前選取的驗證設定檔及連線資訊。
七、列出所有 Power Platform 環境
執行：
pac env list
本次成功列出了兩個環境：
PowerPagesDeveloper-******
example.com (default)
輸出中帶有星號 * 的環境，是目前正在使用的環境：
* example.com (default)
這表示目前 PAC CLI 已經成功取得租戶中的 Dataverse 環境清單。
Microsoft 官方將 pac env list 定義為從 Global Discovery Service 列出目前帳號能夠存取的 Dataverse 環境。
如果想切換到另一個環境，可以執行：
pac env select --environment "環境ID或環境名稱"
例如：
pac env select --environment "PowerPagesDeveloper"
切換後，再次確認：
pac auth who
八、本次配置結果
完成以下命令後：
pac install latest
pac auth create
pac auth list
pac auth who
pac env list
目前狀態為：
PAC CLI 安裝成功
PAC CLI 版本：2.9.3
Microsoft 帳號登入成功
驗證設定檔建立成功
預設 Dataverse 環境連接成功
Power Platform 環境清單讀取成功
因此，PAC CLI 的安裝和最基本的連接設定已經全部完成。
接下來已經可以執行：
pac solution list
查看目前環境中的 Solution。
也可以執行：
pac model list
查看 Model-driven App。
查看 Canvas App 相關命令：
pac canvas help
查看 Power Pages 網站：
pac pages list
或者直接打開目前環境的 Power Apps Maker Portal：
pac tool maker
九、建議重新命名驗證設定檔
目前驗證設定檔可能沒有設定容易識別的名稱。
可以執行：
pac auth name --index 1 --name "Proface Default"
再次查看：
pac auth list
將來如果增加開發、測試和正式環境，可以分別命名：
Proface Dev
Proface Test
Proface Production
然後使用：
pac auth select --name "Proface Dev"
進行切換。
Microsoft 官方支持透過 pac auth name 命名或重新命名驗證設定檔，並透過 pac auth select 切換目前使用的設定檔。
十、公開命令輸出時需要隱藏的資訊
PAC CLI 的命令輸出可能包含組織和帳號識別資訊。
在博客、GitHub Issue、論壇或公開聊天中貼出結果前，建議隱藏：
Microsoft 帳號
Tenant ID
Entra ID Object ID
PUID
Environment ID
Environment URL
Organization ID
Organization Unique Name
例如不要直接公開：
Tenant Id: 12345678-****
Environment Url: https://org******.crm7.dynamics.com/
可以改寫為：
Tenant Id: ********
Environment Url: https://org******.crm7.dynamics.com/
這些資訊不應直接寫入公開 GitHub Repository，也不應放入會被提交到 Git 的部署腳本。
總結
PAC CLI 是 Microsoft 為 Power Platform 提供的官方命令列工具。
在 Windows 中，完整的安裝和連線流程如下：
下載 Windows MSI
↓
安裝 PAC CLI
↓
pac install latest
↓
pac auth create
↓
登入 Microsoft 帳號
↓
pac auth list
↓
pac auth who
↓
pac env list
↓
成功連接 Power Platform
本次實際測試已成功完成：
PAC CLI 2.9.3
＋
Microsoft 使用者帳號
＋
日本區域 Power Platform 租戶
＋
Dataverse 預設環境
從現在開始，便可以使用 PAC CLI 配合 Codex、Git、GitHub和 Power Apps Studio，進一步進行 Solution 匯出、版本管理、自動部署和 Power App 開發。
This article was last edited at