다음을 통해 공유

pac model

(미리 보기) 모델 기반 앱 작업을 위한 명령입니다.

명령어

Command Description
pac model create (미리 보기) 새 모델 기반 앱을 만듭니다.
pac model genpage download (미리 보기) 모델 기반 앱에서 생성된 페이지를 끌어오기.
pac model genpage generate-types (미리 보기) 데이터 원본에 대한 TypeScript 스키마 정의를 생성합니다.
pac model genpage list (미리 보기) 지정된 모델 기반 앱에서 생성된 모든 페이지를 나열합니다.
pac model genpage transpile (미리 보기) 테스트 및 디버깅을 위한 런타임 형식을 사용하여 TypeScript 파일 트랜스파일
pac model genpage upload (미리 보기) 생성된 페이지를 모델 기반 앱에 업로드하고 게시합니다.
pac model list (미리 보기) 환경의 모든 모델 기반 앱을 나열합니다.
pac model list-languages (미리 보기) Dataverse 환경에서 사용하도록 설정된 언어를 나열합니다.

pac model create

(미리 보기) 새 모델 기반 앱을 만듭니다.

에 대한 필수 매개 변수 model create

--name -n

새 모델 기반 앱의 표시 이름입니다.

에 대한 선택적 매개 변수 model create

--description -d

새 모델 기반 앱에 대한 설명입니다.

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--publish

만든 후 앱을 게시합니다.

이 매개 변수에는 값이 필요하지 않습니다. 그것은 스위치입니다.

--solution

앱을 추가할 솔루션 고유 이름입니다. 기본값은 활성 솔루션입니다.

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

팁 (조언)

앱이 만들어졌는지 확인하고 같은 다른 명령에 사용할 앱 ID를 검색하는 pac model genpage upload데 사용합니다pac model list.

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로 단일 생성 페이지를 로컬 폴더에 다운로드합니다.

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

사용되는 데이터 원본의 쉼표로 구분된 목록입니다(예: 'account,lead,contact').

에 대한 선택적 매개 변수 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 테이블에 대한 TypeScript 형식을 contact 생성하고 다음을 작성합니다./src/RuntimeTypes.ts.

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

특정 출력 디렉터리에 단일 테이블에 대한 형식 생성

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

메모

Dataverse 테이블을 쿼리하는 페이지 코드를 작성하기 전에 항상 실행 generate-types 합니다. 생성된 파일에는 강력한 형식의 열 이름, 외래 키 필드 및 각 테이블에 대한 열거형 값이 포함됩니다. 생성된 형식을 사용하면 철자가 틀렸거나 존재하지 않는 열 이름으로 인한 런타임 오류를 방지할 수 있습니다.

pac model genpage list

(미리 보기) 지정된 모델 기반 앱에서 생성된 모든 페이지를 나열합니다.

에 대한 필수 매개 변수 model genpage list

--app-id

모델 기반 앱의 ID입니다.

에 대한 선택적 매개 변수 model genpage list

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

pac model genpage list 예제

다음 예제에서는 명령을 사용하는 일반적인 방법을 보여 줍니다 pac model genpage list .

앱 ID를 사용하여 페이지 나열

앱 ID를 사용하여 Contoso Sales Hub 앱의 모든 생성 페이지를 나열합니다.

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 transpile

(미리 보기) 테스트 및 디버깅을 위한 런타임 형식을 사용하여 TypeScript 파일 트랜스파일

에 대한 필수 매개 변수 model genpage transpile

--code-file

페이지 코드를 포함하는 파일의 경로입니다.

에 대한 선택적 매개 변수 model genpage transpile

--data-sources

사용되는 데이터 원본의 쉼표로 구분된 목록입니다(예: 'account,lead,contact').

--environment -env

대상 Dataverse를 지정합니다. 값은 Guid 또는 절대 https URL일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

--output-file

변환된 JavaScript 출력을 저장하는 경로(기본값은 [code-file].compiled.js)

pac model genpage upload

(미리 보기) 생성된 페이지를 모델 기반 앱에 업로드하고 게시합니다.

에 대한 필수 매개 변수 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

사용되는 데이터 원본의 쉼표로 구분된 목록입니다(예: 'account,lead,contact').

--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일 수 있습니다. 지정하지 않으면 현재 인증 프로필에 대해 선택된 활성 조직이 사용됩니다.

참고하십시오

Microsoft Power Platform CLI 명령 그룹
Microsoft Power Platform CLI 개요

  • Last updated on