支援 Microsoft Power Platform CLI 的入口網站

注意

自 2022 年 10 月 12 日起，Power Apps 入口網站為 Power Pages。 其他資訊：Microsoft Power Pages 現在已推出 (部落格)
我們很快就會遷移並將 Power Apps 入口網站文件與 Power Pages 文件併合。

Microsoft Power Platform CLI (命令列介面) 是一種簡單、一站式開發人員命令列介面，可讓開發人員和應用程式製作者建立程式碼元件。

Microsoft Power Platform CLI 工具是綜合應用程式生命週期管理 (ALM) 案例的第一個步驟，讓企業開發人員和 ISV 可以快速有效地建立、組建、偵錯以及發行擴充和自訂。 如需詳細資訊，請參閱什麼是 Microsoft Power Platform CLI？

Microsoft Power Apps 入口網站可透過此功能支援 Microsoft Power Platform CLI，以啟用入口網站設定的 CI/CD (持續整合/持續部署)。 您現在可以使用 Microsoft Power Platform CLI，將入口網站設定簽入至原始檔控制，並將入口網站設定移到任何環境。

注意

從 Power Platform CLI 版本 1.9.8 開始，此功能應可正常使用。 若要瞭解如何安裝最新版本，請參閱安裝 Microsoft Power Platform CLI。

為何要使用 Microsoft Power Platform CLI 進行入口網站開發？

因為入口網站支援 Microsoft Power Platform CLI，您現在可以使用離線功能變更入口網站內容來進行入口網站自訂。 在儲存所有自訂或變更之後，請將它們上傳至入口網站。 當您使用 Microsoft Power Platform CLI 下載入口網站內容時，會將內容建立為 YAML 和 HTML 格式，讓您能輕鬆自訂，開啟專業開發人員體驗。

以下的清單為支援 Microsoft Power Platform CLI 的入口網站所受益的功能：

使用方便

• 支援從本地檔案系統下載/上傳入口網站資料

• 組建在現有的 Microsoft Power Platform CLI 工具。

應用程式生命週期管理 (ALM)

• 追蹤組織內入口網站設定的變更

• 跨組織或租用戶移動設定檔案

專業開發人員和企業支援

• 協助與任何源代碼控制工具無縫整合，例如 "git"

• 輕鬆設定 CI/CD 管線

安裝 Microsoft Power Platform CLI

有關逐步指示，請參閱 安裝 Microsoft Power Platform CLI。

支援的資料表

支援 Microsoft Power Platform CLI 的入口網站僅限於下表所列。

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (only download)

adx_websitelanguage

adx_webtemplate

annotation

重要

• 自訂表格和入口網站範本 - 特定表格 (例如，部落格、社群或想法入口網站) 不支援使用 Microsoft Power Platform CLI 進行自訂。
• 使用 Power Platform CLI 無法下載廣告 (adx_ad) 記錄的影像檔案附件。 替代解決辦法是可使用影像 URL 欄位，或透過將複製欄位中的 HTML 參考新增到包含影像檔案的 web 檔案記錄。

安裝及驗證入口網站的 Microsoft Power Platform CLI

若要了解如何安裝 Microsoft Power Platform CLI，請移至安裝 Microsoft Power Platform CLI。

安裝 Microsoft Power Platform CLI 之後，請打開命令提示字元並執行 pac，確認輸出包含 "paportal" (Power Apps入口網站的命令)。

入口網站的 Microsoft Power Platform CLI 命令

入口網站的 Microsoft Power Platform CLI 命令為 "paportal"。

以下章節提供有關 "paportal" 命令之不同屬性的更多詳細資料。

參數

屬性名稱	名描述	範例
清單	列出目前 Dataverse 環境中的所有入口網站。	pac paportal list
下載	從目前的 Dataverse 環境中下載入口網站內容。 它有下列參數︰ - 路徑：即將下載網站內容的路徑 (別名：-p) - webSiteId：入口網站識別碼以下載 (別名：-id) - 覆寫：(可選) true - 覆寫現有內容；false - 如果資料夾已有網站內容則失敗 (別名：-o)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
上傳	上傳入口網站內容到目前的 Dataverse 環境中。 它有下列參數︰ - path：網站內容的儲存路徑 (別名： -p) -deploymentProfile：上傳入口網站資料，其中環境詳細資料透過 deployment-profiles/[profile-name].deployment.yaml 檔案中的設定檔變數定義	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

使用部署設定檔

deploymentProfile 切換可讓您以 YAML 格式為環境定義一組變數。 例如，您可以擁有不同的部署設定檔 (例如 dev、test、prod)，其在設定檔中定義了不同的結構描述詳細資料。

如果您正在建立測試設定檔，您可以在 deployment-profiles 下建立名為 "test.deployment.yml" 的檔案 (即 <profileTag>.deployment.yml)。 您可以執行具有標籤 (<profileTag>) 的命令來使用此設定檔：

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

在此檔案中，您可以擁有資料表 (實體) 名稱和資料表識別碼、屬性清單以及在使用 deploymentProfile 參數上傳入口網站設定時要覆寫的值。

此外，您可以使用 OS 變數來存取作業系統的環境變數。

以下是具有唯一結構描述詳細資料的 "test.deployment.yml" 設定檔 YAML 檔案的範例：

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

注意

若要了解 CLI 中所使用的所有命令以及入口網站，請移至 Microsoft Power Platform CLI 中的一般命令。

資訊清單

當您使用 pac paportal download CLI 命令下載網站內容時，除了下載網站內容，還會產生兩個資訊清單檔;

• 環境資訊清單檔 (org-url-manifest yml)
• 刪除追蹤資訊清單檔 (manifest. yml)

環境資訊清單檔 (org-url-manifest yml)

每次執行 pac paportal download 命令時，都會產生環境資訊清單檔。

每次下載後，PAC CLI 工具都會讀取現有的環境資訊清單檔，並更新環境中已刪除的項目，如果環境資訊清單檔不存在則建立此檔案。

當您執行 pac paportal upload 命令來上傳入口網站內容。 它會讀取環境資訊清單檔，並找出上次下載後所做的變更，並僅上傳更新的內容。 這可協助最佳化上傳流程，因為這只會上傳更新的網站內容，而不是在每個上傳命令上上傳所有內容。

環境資訊清單檔在連接到相同環境時，將會是唯讀的 (環境 URL 與檔案名稱相符)，以避免意外變更。

刪除追蹤資訊清單檔 (manifest. yml)

此檔案用於追蹤環境中已刪除的記錄。

當使用 pac paportal download 命令下載網站內容時，這會將已刪除的記錄從環境資訊清單檔 (org-url-manifest.yml)新增至 manifest.yml 檔案。 因此，當您使用 pac paportal upload 命令上傳網站內容時，會將檔案從環境中刪除 (即使是不同的環境)。 不會將此檔案刪除，無論您連接到哪個環境，都會用到該檔案。

注意

為使用 PAC CLI 刪除一個環境中的網站內容記錄並同時刪除另一個環境中的相同內容記錄，您需要在刪除網站記錄內容之前和之後執行 pac paportal download 命令。 manifest.yml 將追蹤這些變更，並在執行 pac paportal upload 命令時移除目標環境中的相應記錄。

將 Visual Studio Code 延伸模組

您也可以使用 VS Code 延伸模組 Power Platform VS Code 延伸模組，使內建 Liquid 語言從 IntelliSense、程式碼完成協助、提示等方面獲得增益，並透過 VS Code 整合終端來與 Microsoft Power Platform CLI 互動。 更多資訊：Visual Studio Code 延伸模組 (預覽版)

其他考量

• 如果您的檔案路徑超過最大路徑長度限制，就會出現錯誤報告。 其他資訊：Windows 中的最大路徑長度限制
• 如果是重複的記錄 (例如重複的網頁名稱)，則 Microsoft Power Platform CLI 會建立兩個不同資料夾—一個是用網頁名稱，而另一個名稱則是同名加上雜湊碼。 例如，"My-page" 和 "My-page-雜湊碼"。

後續步驟

教學課程：在入口網站使用 Microsoft Power Platform CLI

請參閱

• Microsoft Power Platform CLI
• 使用 Visual Studio Code 延伸模組 (預覽版)