Microsoft Power Platform CLI のポータル サポート

Microsoft Power Platform CLI (コマンド ライン インターフェース) はコード コンポーネントを作成するための、シンプルでワンストップな開発者向けコマンド ライン インターフェイスです。

Microsoft Power Platform CLI ツーリングは、エンタープライズ開発者と ISV が拡張機能やカスタマイズを、すばやく効率的に作成、構築、デバッグ、および公開できる、包括的なアプリケーション ライフ サイクル (ALM) ストーリーの最初のステップです。 詳細については、Microsoft Power Platform CLI とは? を参照してください

この機能により、Microsoft Power Apps ポータルは、ポータル構成の CI/CD (継続的統合/継続的配置) を有効にする Microsoft Power Platform CLI をサポートします。 ポータル構成をチェック インしてソース管理を行い、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 をインストール。

サポートするテーブル

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 (ダウンロードのみ)

adx_websitelanguage

adx_webtemplate

注釈

重要

カスタム テーブルおよびポータル テンプレート固有のテーブル (ブログ、コミュニティ、アイデア ポータルなど) は、Microsoft Power Platform CLI を使用したカスタマイズではサポートされていません。

ポータルの 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 環境のすべてのポータル Web サイトを一覧表示します。	pac paportal list
ダウンロード	現在の Dataverse 環境からポータル Web サイトのコンテンツをダウンロードします。 これには次のパラメータが使用されています : - path: Web サイトのコンテンツをダウンロードするパス (エイリアス: -p) - webSiteId: ダウンロードするポータル Web サイト ID (エイリアス: -id) - overwrite: (オプション) 既存のコンテンツを上書きする場合は true、フォルダーにすでに Web サイトのコンテンツがある場合に失敗する場合は false (エイリアス: -o)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
アップロード	現在の Dataverse 環境にポータル Web サイトのコンテンツをアップロードします。 これには次のパラメータが使用されています: - path: Web サイトのコンテンツを保存するパス (エイリアス: -p) -deploymentProfile: deployment-profiles/[profile-name].deployment.yaml の プロファイル変数 を通して定義された環境の詳細を含むポータル データをアップロードします	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

デプロイ プロファイルを使用する

deploymentProfile スイッチを使用すると、環境の変数のセットを YAML 形式で定義できます。 たとえば、プロファイルで定義されたさまざまなスキーマの詳細を持つ、異なるデプロイ プロファイル (dev、test、prod など) を持つことができます。

テスト プロファイルを作成している場合は、デプロイ プロファイル の下で、「test.deployment.yml」 (つまり、<profileTag>.deployment.yml) を使用してファイルを作成できます。 タグ (<profileTag>) でコマンドを実行し、プロファイルを使用します。

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

このファイルでは、deploymentProfile パラメータを使用してポータル構成をアップロードする間、テーブル ID、属性リストおよびオーバーライドしたい値を使用してテーブル (エンティティ) 名を持つことができます。

さらに、OS 変数を使用して、オペレーティング システムの環境変数にアクセスできます。

一意のスキーマ詳細を持つ「test.deployment.yml」プロファイル YAML ファイルの例を次に示します。

adx_sitesetting:
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      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 の一般的なコマンド に移動してください。

Visual Studio Code 拡張機能を使用する (プレビュー)

また、VS Code 拡張機能 Power Platform VS Code 拡張機能 を使用して、IntelliSense の組み込みの Liquid 言語、コード補完支援、ヒント、および VS Code 統合ターミナルを使用した Microsoft Power Platform CLI との対話を行うこともできます。 詳細: Visual Studio Code 拡張機能を使用する (プレビュー)

さらに考慮すべきこと

• ファイル パスがパスの最大長の制限を超えると、エラーが報告されます。 詳細: Windows での最大パス長の制限
• 重複する Web ページ名などの重複するレコードの場合、Microsoft Power Platform CLI は 2 つの異なるフォルダー — を作成します。1 つは Web ページの名前、もう 1 つは同じ名前の戦闘にハッシュ コードが付いたフォルダーです。 たとえば、「マイページ」や「マイページ ハッシュコード」。

次の手順

チュートリアル: ポータルで Microsoft Power Platform CLI を使用する

関連項目

• Microsoft Power Platform CLI
• Visual Studio Code 拡張機能を使用する (プレビュー)