pac package

Команди для роботи з проектами пакетів Dataverse.

Команди

Command Опис
pac package add-external-package Додає пакет, зовнішній для системи рішень Dataverse, до проекту пакета розгортання пакетів пакетів.
pac package add-reference Додавання посилання на проект рішення Dataverse
pac package add-solution Додає попередньо вбудований файл рішення Dataverse до проекту пакета розгортання пакетів пакетів.
pac package deploy Розгортання пакета в Dataverse
pac package init Ініціалізація каталогу з новим проектом пакета Dataverse
pac package show Докладні відомості про пакет Dataverse

pac package add-external-package

Додає пакет, зовнішній для системи рішень Dataverse, до проекту пакета розгортання пакетів пакетів.

Обов'язкові параметри для package add-external-package

--package-type на -t

Тип пакета, що додається. Наприклад: "xpp" для пакетів FnO.

--path на -p

Шлях до зовнішнього пакета

Необов'язкові параметри для package add-external-package

--import-order

Ціле число, яке вказує порядок вставлення цього елемента в кінцевий ImportConfig.xml файл під час збірки. Від'ємні числа вставляються перед наявними елементами. Додатні числа додаються після наявних елементів.

--skip-validation на -sv

Додає елемент до файлу проекту, навіть якщо файл не існує або він є неприпустимим. Примітка. Використання цієї функції не впливає на перевірку, виконану msBuild.

Для цього параметра не потрібне значення. Це перемикач.

pac package add-reference

Додавання посилання на проект рішення Dataverse

Приклад

pac package add-reference --path c:\Users\Downloads\SampleSolution

Обов'язкові параметри для package add-reference

--path на -p

Шлях до проекту рішення Dataverse, на який посилається посилання

Необов'язкові параметри для package add-reference

--dependency-overrides

Список перевизначень із роздільниками-крапками з комою. Це значення перевизначає всі відомості про залежності, закодовані в метаданих рішення. Кожне перевизначення має бути у форматі: <uniquename>:<minVersion>:<maxVersion>. Де minVersion і maxVersion необов'язкові, але мають бути в синтаксисі формату версії .NET.

Примітка. Використовуйте крапку з комою список залежностей, перевизначення формату <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Явно визначає потрібний режим під час імпорту цього рішення.

Використайте одне з таких значень:

  • sync
  • async

--import-order

Ціле число, яке вказує порядок вставлення цього елемента в кінцевий ImportConfig.xml файл під час збірки. Від'ємні числа вставляються перед наявними елементами. Додатні числа додаються після наявних елементів.

--missing-dependency-behavior

Визначає поведінку під час імпорту, коли відсутня залежність цього рішення від цільового середовища.

Використайте одне з таких значень:

  • skip
  • fault

--overwrite-unmanaged-customizations

Явно вказує, чи слід перезаписувати некеровані настроювання під час імпорту цього рішення.

Використайте одне з таких значень:

  • true
  • false

--publish-workflows-activate-plugins

Явно вказує, чи слід публікувати робочі цикли та активувати компоненти plug-in під час імпорту цього рішення.

Використайте одне з таких значень:

  • true
  • false

pac package add-solution

Додає попередньо вбудований файл рішення Dataverse до проекту пакета розгортання пакетів пакетів.

Обов'язкові параметри для package add-solution

--path на -p

Шлях до файлу рішення Dataverse. Файл має бути стиснутим ZIP-файлом.

Необов'язкові параметри для package add-solution

--dependency-overrides

Список перевизначень із роздільниками-крапками з комою. Це значення перевизначає всі відомості про залежності, закодовані в метаданих рішення. Кожне перевизначення має бути у форматі: <uniquename>:<minVersion>:<maxVersion>. Де minVersion і maxVersion необов'язкові, але мають бути в синтаксисі формату версії .NET.

Примітка. Використовуйте крапку з комою список залежностей, перевизначення формату <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Явно визначає потрібний режим під час імпорту цього рішення.

Використайте одне з таких значень:

  • sync
  • async

--import-order

Ціле число, яке вказує порядок вставлення цього елемента в кінцевий ImportConfig.xml файл під час збірки. Від'ємні числа вставляються перед наявними елементами. Додатні числа додаються після наявних елементів.

--missing-dependency-behavior

Визначає поведінку під час імпорту, коли відсутня залежність цього рішення від цільового середовища.

Використайте одне з таких значень:

  • skip
  • fault

--overwrite-unmanaged-customizations

Явно вказує, чи слід перезаписувати некеровані настроювання під час імпорту цього рішення.

Використайте одне з таких значень:

  • true
  • false

--publish-workflows-activate-plugins

Явно вказує, чи слід публікувати робочі цикли та активувати компоненти plug-in під час імпорту цього рішення.

Використайте одне з таких значень:

  • true
  • false

--skip-validation на -sv

Додає елемент до файлу проекту, навіть якщо файл не існує або він є неприпустимим. Примітка. Використання цієї функції не впливає на перевірку, виконану msBuild.

Для цього параметра не потрібне значення. Це перемикач.

pac package deploy

Розгортання пакета в Dataverse

Нотатка

Ця команда доступна лише для .NET Full Framework версії PAC CLI.

Приклад

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

Необов'язкові параметри для package deploy

--argument-file на -af

Шлях до файлу JSON, який відповідає контракту IncrementalSyncParameters (або ModuleSyncParameters). Обов'язково для інкрементної синхронізації --db-sync.

--build-type на -bt

Спосіб застосування пакета. Припустимі значення: Повний, Інкрементний, Видалити. За замовчуванням: заповнено. Використовується з ерпом типу --package.

--db-sync на -ds

Режим синхронізації бази даних для запуску після розгортання. Дозволені значення: None, Full, Module, Incremental. За промовчанням: немає. Використовується з ерпом типу --package.

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--logConsole на -c

Журнал виводу на консоль

Для цього параметра не потрібне значення. Це перемикач.

--logFile на -lf

Шлях до файлу журналу

--modules на -m

Список імен модулів, розділених комами, які потрібно синхронізувати. Обов'язково, коли --db-sync має модуль.

--outputDirectory на -o

Лише режим рішення: коренева папка, що містить .erp/xpp.json. За замовчуванням для поточного каталогу. Якщо аргумент --package не вказано в розділі --package-type erp, усі моделі, перелічені в .erp/xpp.json, розгортаються в порядку залежності.

--package на -p

Шлях до пакета dll або zip-файлу з пакетом.

--package-type на -pt

Цільова платформа для розгортання. Дозволені значення: dataverse, erp. За замовчуванням: dataverse.

--release-type на -rt

Класифікація пакетів. Дозволені значення: Dev, Release. За промовчанням: Dev. Пакети випусків примусово синхронізуються з повною базою даних на сервері. Використовується з ерпом типу --package.

--settings на -s

Параметри пакета середовища виконання, які передаються до пакета, який розгортається. Формат рядка має бути key=value|key=value.

Примітка. Формат рядка має бути key=value|key=value.

--solution на -sz

Шлях до файлу рішення Dataverse. Файл має бути стиснутим ZIP-файлом або CAB-файлом.

--solution-root на -sr

Лише режим рішення: коренева папка, що містить .erp/xpp.json. За замовчуванням для поточного каталогу. Якщо аргумент --package не вказано в розділі --package-type erp, усі моделі, перелічені в .erp/xpp.json, розгортаються в порядку залежності.

--verbose на -vdbg

Випромінювати детальні журнали до результатів журналу.

Для цього параметра не потрібне значення. Це перемикач.

Зауваження

Ви можете використовувати обидва logFile параметри та logConsole параметри разом або використовувати один параметр або інший.

pac package init

Ініціалізація каталогу з новим проектом пакета Dataverse

Приклад

pac package init --outputdirectory c:\samplepackage

Необов'язкові параметри для package init

--layer на -l

Шар X++. Дозволені значення: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. За замовчуванням: ISV.

--model на -m

Імена моделей X++ для риштування. Приймає одне ім'я або список, розділений комами (наприклад, ModelA,ModelB). Обов'язково, якщо тип --package-erp.

--outputDirectory на -o

Каталог виводу

--package-name

Задає стандартне ім'я пакета. Застосовується до покоління ImportExtension.GetNameOfImport.

--package-type на -pt

Тип проекту пакета для риштування. Дозволені значення: dataverse, erp. За замовчуванням: dataverse.

--publisher на -pub

Publisher ім'я, записане в дескриптор моделі. За промовчанням: Microsoft.

--source-root на -sr

Вихідний кореневий шлях (відносно каталогу виводу), де будуть жити моделі. За замовчуванням: ./src.

pac package show

Докладні відомості про пакет Dataverse

Нотатка

Ця команда доступна лише для .NET Full Framework версії PAC CLI.

Приклад

pac package show c:\samplepackage.dll

Обов'язкові параметри для package show

--package на -p

Шлях до пакета dll або zip-файлу з пакетом.

Необов'язкові параметри для package show

--environment на -env

Указує цільовий аргумент Dataverse. Значення може бути URL-адресою GUID або абсолютним https. Якщо не вказано, використовуватиметься активна організація, вибрана для поточного профілю автентифікації.

--logFile на -lf

Шлях до файлу журналу

--verbose на -vdbg

Випромінювати детальні журнали до результатів журналу.

Для цього параметра не потрібне значення. Це перемикач.

Дивись також

Групи команд CLI платформи Microsoft Power Platform
Огляд CLI платформи Microsoft Power Platform