pac model

モデル駆動型アプリを扱うためのコマンド。

Commands

命令 Description
pac model create 新しいモデル駆動型アプリを作成しました。
pac model genpage add モデル駆動型アプリのサイトマップに 1 つ以上の既存の生成ページをアタッチします (再アップロードなし)。 'pac model genpage upload' を使用してページ自体を作成または更新します。この動詞を使用して、既にアップロードされているページを別のアプリに表示します。
pac model genpage download モデル駆動型アプリから生成されたページを引き出します。
pac model genpage generate-types データソースのTypeScriptスキーマ定義を生成する
pac model genpage list 生成されたページを一覧表示します。既定では env-wide、または --app-id が指定されている場合は 1 つのアプリ用です。 --include-unpublished を渡して、下書きページも一覧表示します。
pac model genpage remove モデル駆動型アプリのサイトマップから既存の生成 AI ページをデタッチします。 Dataverse のページ行は保持されます (他のアプリから引き続き参照できます)。
pac model genpage transpile テストやデバッグのためにランタイム型を持つTypeScriptファイルをトランスパイルします
pac model genpage upload 生成されたページを Dataverse にアップロードして発行します。 --page-id を省略すると、新しいページを作成します。は、--page-id が指定されたときに既存のページを更新します。 環境内に既に存在するページを再アップロードせずに別のアプリのサイトマップにアタッチするには、代わりに 'pac model genpage add' を使用します。
pac model list 環境内のすべてのモデル駆動アプリを一覧にしています。
pac model list-languages リストはDataverse環境内の言語を可能にしました。
pac model list-tables 接続環境にDataverseテーブルをリストします。

pac model create

新しいモデル駆動型アプリを作成しました。

に必要なパラメーター model create

--name -n

新しいモデル駆動型アプリの表示名。

の省略可能なパラメーター model create

--description -d

新しいモデル駆動型アプリの説明。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--publish

作成後にアプリを発行します。

このパラメーターには値が必要ありません。 それはスイッチです。

--solution

アプリを追加するソリューションの一意の名前。 指定しない場合、既定値は 'Default' になります。

pac model create の例

次の例は、 pac model create コマンドを使用する一般的な方法を示しています。

アクティブな環境で新しいモデル駆動型アプリを作成する

pac model create --name "Contoso Sales Hub"

説明を含むアプリを作成してソリューションに追加した後、すぐに発行する

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

環境 URL を指定して特定の環境にアプリを作成する

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --environment "https://contoso.crm.dynamics.com" \
  --solution "ContosoSales" \
  --publish

ヒント

pac model listを使用して、アプリが作成されたことを確認し、pac model genpage uploadなどの他のコマンドで使用するアプリ ID を取得します。

pac model genpage add

モデル駆動型アプリのサイトマップに 1 つ以上の既存の生成ページをアタッチします (再アップロードなし)。 'pac model genpage upload' を使用してページ自体を作成または更新します。この動詞を使用して、既にアップロードされているページを別のアプリに表示します。

に必要なパラメーター model genpage add

--page-id

アプリに追加するコンマ区切りの生成ページ ID (GUID)。

の省略可能なパラメーター model genpage add

--app-id

モデル駆動型アプリの ID (GUID)。 --app-name と相互に排他的です。

--app-name

モデル駆動型アプリの一意の名前。 --app-id と相互に排他的です。

--area

ページを配置するサイトマップのオプションのエリア ID。 既定値は最初の領域です。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--group

ページを配置するサイトマップの省略可能なグループ ID。 既定値は、選択した領域の最初のグループです。

--language-code

SubArea タイトルの言語コード (LCID)。 既定値は 1033 (en-US)。

--publish

ページを追加した後、モデル駆動型アプリを発行します。

このパラメーターには値が必要ありません。 それはスイッチです。

--solution

サイトマップ更新の Dataverse ソリューション コンテキストの一意の名前。 デフォルトは 'Default' です。

pac model genpage download

モデル駆動型アプリから生成されたページを引き出します。

に必要なパラメーター model genpage download

--app-id

モデル駆動型アプリの ID。

の省略可能なパラメーター model genpage download

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--output-directory -o

プルされたページを保存するディレクトリ。 既定値は現在のディレクトリです。

--page-id

プルするページ ID のコンマ区切りの一覧。

pac model genpage download の例

次の例は、 pac model genpage download コマンドを使用する一般的な方法を示しています。

ページ ID で 1 つの生成ページを編集用のローカル フォルダーにダウンロードする

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

アプリ内のすべての生成ページを一度にダウンロードする

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

ページ ID にちなんだサブディレクトリを作成し、次のファイルを書き込みます。

./pages/account-dashboard/
  e5f6a7b8-abcd-ef01-2345-000000000010/
    page.tsx          ← TypeScript source code
    page.js           ← Transpiled JavaScript
    RuntimeTypes.ts   ← Dataverse type definitions
    config.json       ← Page metadata
    prompt.txt        ← Original generation prompt

pac model genpage generate-types

データソースのTypeScriptスキーマ定義を生成する

に必要なパラメーター model genpage generate-types

--data-sources

使用されるデータ ソースのコンマ区切りの一覧 (例: "アカウント、潜在顧客、連絡先")。

の省略可能なパラメーター model genpage generate-types

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--output-file -o

生成された TypeScript スキーマ ファイルを保存するパス (既定値は RuntimeTypes.ts)

pac model genpage generate-types の例

次の例は、 pac model genpage generate-types コマンドを使用する一般的な方法を示しています。

TypeScript 型を生成する

accountテーブルとcontact テーブルの TypeScript 型を生成し、./src/RuntimeTypes.tsに書き込みます。

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

1 つのテーブルの型を特定の出力ディレクトリに生成する

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Note

Dataverse テーブルにクエリを実行するページ コードを記述する前に、常に generate-types 実行してください。 生成されたファイルには、厳密に型指定された列名、外部キー フィールド、および各テーブルの列挙値が含まれています。 生成された型に依存すると、スペルミスまたは存在しない列名が原因で発生するランタイム エラーを防ぐことができます。

pac model genpage list

生成されたページを一覧表示します。既定では env-wide、または --app-id が指定されている場合は 1 つのアプリ用です。 --include-unpublished を渡して、下書きページも一覧表示します。

の省略可能なパラメーター model genpage list

--app-id

モデル駆動型アプリの ID。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--include-unpublished

発行されていない生成ページを一覧に含めます (既定: 発行済みのみ)。

このパラメーターには値が必要ありません。 それはスイッチです。

pac model genpage list の例

次の例は、 pac model genpage list コマンドを使用する一般的な方法を示しています。

アプリ ID を使用してページを一覧表示する

Contoso Sales Hub アプリ内のすべての生成ページを、そのアプリ ID を使用して一覧表示します。

pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"

アプリ名を使用してページを一覧表示する

生成ページをアプリ名で一覧表示します (CLI はアプリ ID を自動的に検索します)。

pac model genpage list --app-id "Contoso Sales Hub"

pac model genpage サンプル出力

Found 2 generated page(s):

  Account Dashboard
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000010
    Description: Created: 2026-01-15T10:22:00Z

  Opportunity Tracker
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000011
    Description: Created: 2026-02-03T14:05:00Z

pac model genpage remove

モデル駆動型アプリのサイトマップから既存の生成 AI ページをデタッチします。 Dataverse のページ行は保持されます (他のアプリから引き続き参照できます)。

に必要なパラメーター model genpage remove

--page-id

削除する 1 つ以上の uxagentproject ID (コンマ区切り)。

の省略可能なパラメーター model genpage remove

--app-id

ページを削除するモデル駆動型アプリ ID (uniqueid)。 --app-name と相互に排他的です。

--app-name

ページを削除するモデル駆動型アプリの一意の名前。 --app-id と相互に排他的です。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--publish

サイトマップの編集後にモデル駆動型アプリを発行して、変更がすぐに反映されるようにします。

このパラメーターには値が必要ありません。 それはスイッチです。

--solution

サイトマップ更新のデータバース ソリューションの一意の名前。 デフォルトは 'Default' です。

pac model genpage transpile

テストやデバッグのためにランタイム型を持つTypeScriptファイルをトランスパイルします

に必要なパラメーター model genpage transpile

--code-file

ページ コードを含むファイルへのパス。

の省略可能なパラメーター model genpage transpile

--data-sources

使用されるデータ ソースのコンマ区切りの一覧 (例: "アカウント、潜在顧客、連絡先")。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--output-file

トランスパイルされた JavaScript 出力を保存するパス (既定値は [code-file].compiled.js)

pac model genpage upload

生成されたページを Dataverse にアップロードして発行します。 --page-id を省略すると、新しいページを作成します。は、--page-id が指定されたときに既存のページを更新します。 環境内に既に存在するページを再アップロードせずに別のアプリのサイトマップにアタッチするには、代わりに 'pac model genpage add' を使用します。

に必要なパラメーター model genpage upload

--app-id

モデル駆動型アプリの ID。

--code-file

ページ コードを含むファイルへのパス。

の省略可能なパラメーター model genpage upload

--add-to-sitemap

アプリのサイトマップ ナビゲーションにページを追加します。

このパラメーターには値が必要ありません。 それはスイッチです。

--agent-message

エージェントの応答メッセージ。

--agent-message-file

エージェントの応答メッセージを含むファイルへのパス。

--compiled-code-file

コンパイル済みの JavaScript コードを含むファイルへのパス。 指定しない場合、TypeScript は自動的に JavaScript にトランスパイルされます。

--data-sources

使用されるデータ ソースのコンマ区切りの一覧 (例: "アカウント、潜在顧客、連絡先")。

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--model

ページの生成に使用される AI モデル (例: 'claude-3-5-sonnet-20241022')。

--name -n

ページの名前です。

--page-id

更新するページの ID。 指定しない場合は、新しいページが作成されます。

--prompt

このページを生成したユーザー プロンプト。

--prompt-file

このページを生成したユーザー プロンプトを含むファイルへのパス。

pac model genpage upload の例

次の例は、 pac model genpage upload コマンドを使用する一般的な方法を示しています。

新しい生成ページを発行する

Contoso Sales Hub アプリに新しい生成ページを発行し、アプリサイトマップに追加します。

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --code-file ./pages/account-dashboard.tsx \
  --name "Account Dashboard" \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Created account dashboard with card grid, revenue chart, and contact list. Uses account and contact tables." \
  --add-to-sitemap

既存の生成ページを更新する

ページ ID を指定して既存の生成ページを更新します (サイトマップ エントリが重複しないように --add-to-sitemap を省略します)。

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --code-file ./pages/account-dashboard.tsx \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Updated card layout to use a two-column grid; added revenue sparkline chart."

モック データを使用するページを発行する

モック データを使用するページを発行します (Dataverse テーブルは使用しません。 --data-sourcesは省略します)。

pac model genpage upload \
  --app-id "Contoso Sales Hub" \
  --code-file ./pages/welcome-screen.tsx \
  --name "Welcome" \
  --prompt "A branded welcome screen with Contoso logo, quick-action tiles, and a news feed placeholder." \
  --model "claude-sonnet-4-6" \
  --agent-message "Welcome page with static mock data. No Dataverse queries." \
  --add-to-sitemap

ヒント

--app-id パラメーターは、アプリの GUID またはその表示名を受け取ります。 複数のアプリが同じ表示名を共有する場合は、あいまいさを避けるために GUID を使用します。 pac model listを実行してアプリ ID を検索します。

pac model genpage upload パラメーターのクイック リファレンス

パラメーター 必須 Description
--app-id はい アプリ GUID または表示名。 pac model listを実行して検索します。
--code-file はい デプロイする .tsx ソース ファイルへのパス。
--name 新しいページのみ アプリサイトマップに表示される表示名。
--page-id 更新のみ 置き換える既存のページの GUID。
--data-sources Dataverse ページ Dataverse テーブルの論理名のコンマ区切りのリスト (たとえば、 "account,contact")。
--prompt 推奨 ページの動作の自然言語の概要。 再生成コンテキスト用に格納されます。
--model 推奨 ページの生成に使用されるモデル ID (たとえば、 claude-sonnet-4-6)。
--agent-message 推奨 ビルドまたは変更された内容の説明。 変更履歴として格納されます。
--add-to-sitemap 新しいページのみ ページをアプリのナビゲーションに自動的に追加します。 更新時に省略します。

pac model list

環境内のすべてのモデル駆動アプリを一覧にしています。

の省略可能なパラメーター model list

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

pac model list の例

現在アクティブな環境内のすべてのモデル駆動型アプリを一覧表示します。

pac model list

サンプル出力:

Found 3 model-driven app(s):

  Contoso Sales Hub
    App ID: a1b2c3d4-1234-5678-abcd-000000000001
    Unique Name: contoso_SalesHub

  Contoso Field Service
    App ID: a1b2c3d4-1234-5678-abcd-000000000002
    Unique Name: contoso_FieldService

  Contoso Customer Portal
    App ID: a1b2c3d4-1234-5678-abcd-000000000003
    Unique Name: contoso_CustomerPortal

pac model list-languages

リストはDataverse環境内の言語を可能にしました。

の省略可能なパラメーター model list-languages

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

pac model list-tables

接続環境にDataverseテーブルをリストします。

の省略可能なパラメーター model list-tables

--environment -env

ターゲット Dataverse を指定します。 値は、Guid または絶対 https URL にすることができます。 指定しない場合、現在の認証プロファイルに選択されているアクティブな組織が使用されます。

--search -s

検索名のカンマ区切りリスト(論理名、スキーマ名、表示名と一致するもの)。

--type -t

テーブルタイプ別フィルター:『custom』『standard』『all』(デフォルト:all)。

こちらも参照ください

Microsoft Power Platform CLI コマンド グループ
Microsoft Power Platform CLIの概要

  • Last updated on