pac model

모델 기반 앱 작업을 위한 명령어들.

Commands

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 list-tables	연결된 환경에서 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 .

• 활성 환경에서 새 모델 기반 앱 만들기
• 설명이 포함된 앱을 만들고 솔루션에 추가한 다음 즉시 게시
• 환경 URL을 제공하여 특정 환경에서 앱 만들기

활성 환경에서 새 모델 기반 앱 만들기

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

Tip

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

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로 단일 생성 페이지를 로컬 폴더에 다운로드합니다.
• 한 번에 앱의 모든 생성 페이지 다운로드
• 페이지 ID의 이름을 따서 명명된 하위 디렉터리를 만들고 다음 파일을 씁니다.

편집을 위해 페이지 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 형식 생성
• 특정 출력 디렉터리에 단일 테이블에 대한 형식 생성

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

Note

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를 사용하여 페이지 나열

앱 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

Tip

매개 변수는 --app-id 앱의 GUID 또는 표시 이름을 허용합니다. 여러 앱이 동일한 표시 이름을 공유하는 경우 GUID를 사용하여 모호성을 방지합니다. 실행 pac model list 하여 앱 ID를 조회합니다.

pac model genpage upload 매개 변수 빠른 참조

Parameter	Required	Description
--app-id	Yes	앱 GUID 또는 표시 이름입니다. 실행 pac model list 하여 찾습니다.
--code-file	Yes	배포할 원본 파일의 .tsx 경로입니다.
--name	새 페이지만	앱 사이트맵에 표시된 표시 이름입니다.
--page-id	Updates only	바꿀 기존 페이지의 GUID입니다.
--data-sources	Dataverse pages	Dataverse 테이블 논리 이름(예 "account,contact": )의 쉼표로 구분된 목록입니다.
--prompt	Recommended	페이지가 수행하는 작업의 자연어 요약입니다. 다시 생성 컨텍스트를 위해 저장됩니다.
--model	Recommended	페이지를 생성하는 데 사용되는 모델 ID(예: claude-sonnet-4-6)입니다.
--agent-message	Recommended	빌드되거나 변경된 내용에 대한 설명입니다. 변경 기록으로 저장됩니다.
--add-to-sitemap	새 페이지만	자동으로 앱 탐색에 페이지를 추가합니다. 업데이트할 때 생략합니다.

pac model list

환경 내 모든 모델 기반 앱을 나열합니다.

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

--environment -env

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

pac model list 예제

현재 활성 환경에서 모든 모델 기반 앱을 나열합니다.

pac model list

Sample output:

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).

See also

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