pac package

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

Commands

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

Example

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

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

Используйте одно из следующих значений:

• 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

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

Используйте одно из следующих значений:

• true
• false

--skip-validation -sv

Добавляет элемент в файл проекта, даже если файл не существует или недействителен. Примечание. Использование этого параметра не влияет на проверку, выполняемую MSBuild.

Этот параметр не требует значения. Это переключатель.

pac package deploy

Развертывание пакета в Dataverse

Example

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

Необязательные параметры для package deploy

--argument-file -af

Путь к JSON-файлу, соответствующий контракту IncrementalSyncParameters (или ModuleSyncParameters). Требуется для добавочного инкрементного --db-sync.

--build-type -bt

Как применяется пакет. Допустимые значения: Full, Incremental, Delete. Значение по умолчанию: full. Используется с типом --package-type erp.

--db-sync -ds

Режим синхронизации базы данных для запуска после развертывания. Допустимые значения: None, Full, Module, Incremental. Значение по умолчанию: нет. Используется с типом --package-type erp.

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--logConsole -c

Выходной журнал в консоль

Этот параметр не требует значения. Это переключатель.

--logFile -lf

Путь к файлу журнала

--modules -m

Разделенный запятыми список имен модулей для синхронизации. Требуется, когда —-db-sync — Module.

--outputDirectory -o

Только в режиме решения: корневая папка, содержащая .erp/xpp.json. По умолчанию отображается текущий каталог. Если пакет --package опущен в формате erp типа --package, все модели, перечисленные в .erp/xpp.json, развертываются в порядке зависимостей.

--package -p

Путь к dll-файлу пакета или ZIP-файлу с пакетом.

--package-type -pt

Целевая платформа для развертывания. Допустимые значения: dataverse, erp. Значение по умолчанию: dataverse.

--release-type -rt

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

--settings -s

Параметры пакета среды выполнения, передаваемые в развернутый пакет. Формат строки должен быть key=value|key=value.

Примечание. Формат строки должен быть key=value|key=value.

--solution -sz

Путь к файлу решения Dataverse. Файл должен быть сжатым ZIP-файлом или CAB-файлом.

--solution-root -sr

Только в режиме решения: корневая папка, содержащая .erp/xpp.json. По умолчанию отображается текущий каталог. Если пакет --package опущен в формате erp типа --package, все модели, перечисленные в .erp/xpp.json, развертываются в порядке зависимостей.

--verbose -vdbg

Вывод подробных журналов в выходные данные журнала.

Этот параметр не требует значения. Это переключатель.

Замечания

Вы можете использовать оба logFile параметра и logConsole параметры вместе, либо использовать один или другой параметр.

pac package init

Инициализирует каталог с помощью нового проекта пакета Dataverse

Example

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-is 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

Example

pac package show c:\samplepackage.dll

Обязательные параметры для package show

--package -p

Путь к dll-файлу пакета или ZIP-файлу с пакетом.

Необязательные параметры для package show

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--logFile -lf

Путь к файлу журнала

--verbose -vdbg

Вывод подробных журналов в выходные данные журнала.

Этот параметр не требует значения. Это переключатель.

См. также

Группы команд Командной строки Microsoft Power Platform
Обзор интерфейса командной строки Microsoft Power Platform