移轉入口網站設定

文章
03/16/2023

注意

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

入口網站開發必須考量數個設定和自訂，才能達到入口網站使用者所要的體驗。

完成入口網站執行個體的開發或設定後，您可能需要將最新的入口網站設定從開發或測試環境移轉到生產環境。

移轉作業牽涉到從來源 Microsoft Dataverse 環境匯出現有的組態設定，然後再將其匯入目標 Dataverse 環境。

準備目標環境

注意

準備目標環境是一次性程序。您必須提供新的入口網站，才能在 Dataverse 上安裝受管理的入口網站解決方案，和設定入口網站 Web 應用程式。此程序也會安裝預設的入口網站中繼資料，並由來源環境中的入口網站中繼資料取代。
請確定目標環境的最大附件大小已設定為與來源環境相同或更大的大小。
最大檔案大小由環境系統設定對話方塊系統捨釘電子郵件索引標籤中的最大檔案大小設定決定。

在目標環境中提供新的入口網站。請使用您在來源環境中佈建的相同入口網站範本。例如，如果您在來源環境中佈建了 Dynamics 365 客戶自助服務入口網站，請在目標環境中佈建 Dynamics 365 客戶自助服務入口網站。
在目標環境中使用入口網站管理應用程式，刪除新建立的網站記錄。這會移除目標環境中的預設入口網站設定資料。
在目標環境中刪除該入口網站應用程式。這會移除目前設定為呈現預設入口網站的入口網站應用程式。

注意

請勿刪除入口網站管理應用程式！
使用 Power Platform CLI 或設定移轉工具從來源環境傳輸入口網站中繼資料。
在目標環境中，使用現有的入口網站選項來佈建新的入口網站。此程序會使用您從來源環境傳輸的入口網站設定來設定入口網站。
來源環境中的入口網站更新應反映在這個新的目標環境中。接下來，您應該能透過傳輸入口網站設定資料，將設定從來源環境傳輸到目標環境。

注意

使用 Power Platform CLI 傳輸入口網站設定

Microsoft Power Platform CLI 提供許多專用於入口網站的功能。這些命令可讓您從來源環境下載入口網站設定，並將其傳輸至目標環境。這些命令也可以合併至您的 ALM 程序中。

建立 Power Platform CLI 驗證設定檔，以連接至來源和目標環境。您可以為其命名，以輕鬆識別目標和來源環境。
```
pac auth create --name [name] --url [environment url]
```
範例
```
pac auth create --name PORTALDEV --url https://contoso-org.crm.dynamics.com
```
在建立驗證設定檔後，它們將具有可使用清單命令確定的相關索引。
```
pac auth list
```

選取已連接至來源環境的 Power Platform CLI 驗證設定檔。

pac auth select --index [source environment index]

範例

pac auth select --index 1

確定來源入口網站的網站識別碼。
```
pac paportal list
```
將入口網站設定資料下載至您的本機工作站。如果您之前已將入口網站設定下載到同一路徑，請使用設為 True 的 --overwrite 選項。
```
pac paportal download --path [path] --webSiteId [website id]
```
範例
```
pac paportal download --path c:\paportals\ --webSiteId db9db518-ea5c-ec11-8f8f-00224804e6cd
```

選取已連接至目標環境的 Power Platform CLI 驗證設定檔。

pac auth select --index [target environment index]

範例

pac auth select --index 2

將入口網站設定資料上傳至目標環境。

pac paportal upload --path [path]

範例

pac paportal upload --path "C:\paportals\portaldev"

注意

Power Platform CLI 工具並不會移轉資料表或資料表結構描述。當設定資料與所選結構描述不符時，移轉可能會因缺少元素 (例如資料表和欄位) 而失敗。匯入期間，請確認目標環境包含的其他自訂 (如資料表、欄位、表單或檢視) 已安裝相同的入口網站。

注意

使用設定移轉工具，傳輸入口網站設定

注意

較好的方式是使用 Power Platform CLI 來傳輸入口網站中繼資料。

若要匯出設定資料，您必須使用設定移轉工具和入口網站專屬設定結構描述檔。如需此工具的詳細資訊，請參閱管理您的設定資料。

注意

我們建議您使用最新版本的設定移轉工具。您可以從 NuGet 下載設定移轉工具。其他有關下載工具的資訊：從 NuGet 下載工具。
設定移轉結構描述檔案所支援的入口網站最低解決方案版本是 8.4.0.275。不過，建議您使用解決方案的最新版本。
來源和目的地組織必須具有相同的預設語言，移轉才能順利運作。

結構描述檔案適用於下列入口網站類型：

在環境中使用 Dataverse 建立的入口網站
- 自訂入口網站 (空白入口網站)
- 自訂入口網站 (空白入口網站)(適用版本 9.2.2103.x)
- 自訂入口網站 (空白入口網站)(適用版本 9.3.2201.x 或更新版本)
在包含 Customer Engagement 應用程式 (例如 Dynamics 365 Sales 和 Dynamics 365 Customer Service) 的環境中建立的入口網站
- 自訂入口網站 (空白入口網站)
- 自訂入口網站 (空白入口網站)(適用版本 9.2.2103.x)
- 自訂入口網站 (空白入口網站)(適用版本 9.3.2201.x 或更新版本)
- 社群入口網站
- 客戶自助入口網站
- 合作夥伴入口網站
- 員工自助入口網站

預設結構描述檔包含有關入口網站資料表、關聯以及每個實體唯一性定義的資訊。其他資訊：匯出入口網站設定資料

匯出設定資料之後，您必須將其匯入至目標環境。其他資訊：匯入入口網站設定資料

注意

設定移轉工具會使用結構描述來匯出和匯入設定資料。此工具並不會移轉資料表或資料表結構描述。當設定資料與所選結構描述不符時，移轉可能會失敗，並出現缺失的專案 (如資料表和欄位)。

在匯出期間，請確認來源環境包含了在設定移轉工具結構描述檔案中指定的入口網站資料表。您仍然可以修改結構，新增、移除和修改資料表、屬性等項目，然後移轉設定資料的子集。

匯入期間，請確認目標環境包含的其他自訂 (如資料表、欄位、表單或檢視) 已安裝相同的入口網站。

匯出網站設定資料

您可以使用網站轉屬設定結構描述檔，從來源系統匯出網站設定資料。

下載設定移轉工具，再將其解壓縮至所需的資料夾。
使用以上針對您的入口網站類型所提供的連結，下載入口網站設定結構描述檔。
按兩下 <your_folder>\Tools\ConfigurationMigration 資料夾中的 DataMigrationUtility.exe 檔案，執行設定移轉工具、選擇主畫面中的匯出資料，然後選取繼續。
在登入畫面中，提供驗證詳細資料，連線到您要從中匯出資料的 Dataverse 環境。如果 Dataverse 環境上有多個要從中匯出資料的組織，請選取顯示可用組織清單核取方塊，然後選取登入。
如果您有多個組織，而您已在前一個步驟選取顯示可用組織清單核取方塊時，下一個畫面可讓您選擇您想要連接到的組織。選取要連線到的 Dataverse 環境。

注意

如果您沒有多個組織，就不會顯示此畫面。
在結構描述檔案中，瀏覽並選取要用於進行資料匯出的入口網站專屬設定結構描述檔。
在儲存到資料檔中，指定要匯出的資料檔案位置與名稱。
選取匯出資料。畫面會顯示匯出進度狀態，並在完成匯出時於螢幕底部顯示匯出檔案的位置。
選取結束以關閉工具。

匯入網站設定資料

執行設定移轉工具並選擇主畫面中的匯入資料，然後選取繼續。
在登入畫面中，提供驗證詳細資料，連線到您要從中匯出資料的 Dataverse 環境。如果 Dataverse 環境上有多個要從中匯出資料的組織，請選取顯示可用組織清單核取方塊，然後選取登入。
如果您有多個組織，而您已在前一個步驟選取顯示可用組織清單核取方塊時，下一個畫面可讓您選擇您想要連接到的組織。選取要連線到的 Dataverse 環境。
注意
- 如果您沒有多個組織，就不會顯示此畫面。
- 確認您打算匯入設定的組織已經安裝入口網站解決方案。
下一個畫面會提示您提供要匯入的資料檔 (.zip)。瀏覽至資料檔，選取檔案，然後選取匯入資料。
下一個畫面會顯示記錄的匯入狀態。資料匯入分多個階段完成，先匯入基礎資料，同時將相依資料排入佇列，然後在後續階段中匯入相依資料以處理任何資料相依性或連結。此動作可確保全新且一致的資料匯入。
選取結束以關閉工具。

使用移轉的資料建立新入口網站

如果移轉程序正在更新現有入口網站，則現在目標環境中應該會顯示更新。如果是針對新入口網站進行遷移，您現在就可以使用使用現有網站記錄中的資料選項，為匯入的網站記錄建立新的入口網站。其他資訊：建立入口網站

租用戶至租用戶移轉

Power Apps 入口網站不支援租用戶至租用戶移轉。若要將入口網站從一個租用戶移轉至另一個租用戶，您必須依照下列步驟進行：

重設您在來源用戶中入口網站。
在具有 Dataverse或包含 Customer Engagement 應用程式的環境中佈建新的入口網站。
請使用上文所述的步驟來移轉入口網站設定和自訂。

請參閱

追蹤 Power Apps 入口網站設定的變更。
支援 Microsoft Power Platform CLI 的入口網站。
Power Platform 環境的租用戶至租用戶移轉。
Dynamics 365 中的模型導向應用程式 (例如 Sales、Customer Service、Marketing、Field Service 和 Project Service Automation) 的租用戶至租用戶移轉。

注意

是否能請您告知您偏好的慣用文件語言？請填寫問卷。 (請注意，本問卷為英文版)

完成問卷大約需要七分鐘。本問卷將不會收集個人資料 (隱私權聲明)。

分享方式：