pac solution

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

Команди

Команда	Опис
pac solution add-license	Додайте відомості про ліцензію та план до рішення.
pac solution add-reference	Додавання посилання з проекту в поточному каталозі до проекту за адресою "шлях"
pac solution add-solution-component	Додайте один або кілька компонентів рішення до цільового некерованого рішення в Dataverse.
pac solution check	Завантажте проект рішення Dataverse, щоб запустити його зі службою перевірки Power Apps.
pac solution clone	Створення проекту рішення на основі наявного рішення в організації.
pac solution create-settings	Створіть файл настройок із zip-файлу рішення або папки рішення.
pac solution delete	Видалення рішення з Dataverse в поточному середовищі.
pac solution export	Експорт рішення з Dataverse.
pac solution import	Імпорт рішення до Dataverse.
pac solution init	Ініціалізація каталогу за допомогою нового проекту рішення Dataverse
pac solution list	Список усіх рішень від поточної організації Dataverse
pac solution online-version	Отримує або встановлює версію рішення, завантаженого в Dataverse.
pac solution pack	Упакувати компоненти рішення локальної файлової системи до solution.zip (SolutionPackager).
pac solution publish	Публікація всіх настройок
pac solution sync	Синхронізуйте поточний проект рішення Dataverse із поточним станом рішення в організації.
pac solution unpack	Видобути компоненти рішення з solution.zip на локальну файлову систему (SolutionPackager).
pac solution upgrade	Застосувати solution upgrade
pac solution version	Оновлення збірки або версії редакції рішення.

pac solution add-license

Додайте відомості про ліцензію та план до рішення.

Приклад

У цьому прикладі показано, як додати відомості про ліцензування до рішення.

pac solution add-license --planDefinitionFile ../ISV_Plan_Definition.csv --planMappingFile ../ISV_Plan_Mapping.csv

Файл визначення плану

Нижче наведено приклад файлу визначення плану:

ServiceID,Display name,More info URL
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,Fabrikam Bronze Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,Fabrikam Silver Plan,http://www.microsoft.com
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,Fabrikam Gold Plan,http://www.microsoft.com

Файл зіставлення плану

Нижче наведено приклад файлу зіставлення плану:

Service ID,Component name
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.bronzeplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.silverplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_BronzeApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_SilverApp
test_isvconnect1599092224747.d365_isvconnect_prod_licensable.goldplan,crf36_GoldApp

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

--planDefinitionFile на -pd

Файл визначення плану ліцензії у форматі CSV; очікувані стовпці: ідентифікатор служби, коротке ім'я, URL-адреса додаткових відомостей.

--planMappingFile на -pm

Файл зіставлення плану ліцензій у форматі CSV; очікувані стовпці: ідентифікатор служби, ім'я компонента

pac solution add-reference

Додавання посилання з проекту в поточному каталозі до проекту за адресою "шлях"

Приклад

pac solution add-reference --path c:\Users\Downloads\SampleComponent

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

--path на -p

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

pac solution add-solution-component

Додайте один або кілька компонентів рішення до цільового некерованого рішення в Dataverse.

Приклад

У цьому прикладі показано, як додати компонент рішення до рішення. У цьому випадку ми додаємо таблицю контактів до рішення SampleSolution. Таблиця – це тип компонента 1.

pac solution add-solution-component --solutionUniqueName SampleSolution --component contact --componentType 1

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

--component на -c

Ім’я схеми або ідентифікатор компонента, який потрібно додати до цільового рішення.

--componentType на -ct

Значення, яке позначає компонент рішення, який ви додаєте.

--solutionUniqueName на -sn

Ім'я рішення.

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

--AddRequiredComponents на -arc

Указує, чи слід додавати до некерованого рішення інші компоненти рішення, необхідні для компонента рішення, який ви додаєте.

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

--async на -a

Імпортує рішення асинхронно.

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

--environment на -env

URL-адреса середовища або ідентифікатор цільового середовища.

pac solution check

Завантажте проект рішення Dataverse, щоб запустити його зі службою перевірки Power Apps.

Приклад

pac solution check --path c:\Users\Documents\Solution.zip --outputDirectory c:\samplepackage --geo UnitedStates

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

--clearCache на -cc

Очищує кеш примусового solution checkвиконання для клієнта всіх записів, які стосуються минулих результатів для ваших рішень.

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

--customEndpoint на -ce

Укажіть настроювану URL-адресу як кінцеву точку перевірки Power Apps.

--environment на -env

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

--excludedFiles на -ef

Виключити файли з аналізу. Передати як значення, розділені комами

--geo на -g

Який географічний екземпляр служби перевірки Power Apps використовувати.

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

• PreviewUnitedStates
• UnitedStates
• Europe
• Asia
• Australia
• Japan
• India
• Canada
• SouthAmerica
• UnitedKingdom
• France
• SouthAfrica
• Germany
• UnitedArabEmirates
• Switzerland
• Norway
• Singapore
• Korea
• Sweden
• Italy
• Poland
• NewZealand
• USGovernment
• USGovernmentL4
• USGovernmentL5DoD
• China

--outputDirectory на -o

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

--path на -p

Шлях, у якому існує один або кілька файлів рішень для перевірки. Шлях може містити символи glob/узагальнення.

--ruleLevelOverride на -rl

Шлях до файлу з правилами масиву JSON і рівнями, які потрібно перевизначити. OverrideLevel може приймати такі значення: Критичний, Високий, Середній, Низький, Інформація. Приклад: [{ «Id»:«meta-remove-dup-reg», «OverrideLevel»: «Середній», }{ «Id»:«il-avoid-update-ops», «OverrideLevel»: «Середній» }]

--ruleSet на -rs

Виберіть набір правил, який виконується як частина цієї збірки. Значення: припустимий ідентифікатор GUID, "Сертифікація appSource", "Засіб перевірки рішень" (за замовчуванням).

--saveResults на -sav

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

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

--solutionUrl на -u

SAS Uri, що вказує на solution.zip, які потрібно проаналізувати

pac solution clone

Створення проекту рішення на основі наявного рішення в організації.

Приклади

У наведених нижче прикладах показано використання pac solution clone команди.

• Простий клон
• Клон із загальними та автоматичними параметрами нумерації

Простий клон

У цьому прикладі рішення sampleSolution клонує поточний каталог.

pac solution clone --name sampleSolution

Клон із загальними та автоматичними параметрами нумерації

У цьому прикладі рішення sampleSolution клонує поточний каталог із загальними параметрами та параметрами автоматичної нумерації.

pac solution clone --name sampleSolution --include general,autonumbering

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

--name на -n

Ім'я рішення, що експортується.

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

--async на -a

Експортує рішення асинхронно.

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

--environment на -env

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

--include на -i

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

Використовуйте одне або кілька з цих значень, розділених крапкою з комою:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize на -loc

Розпакуйте або об'єднайте всі рядкові ресурси у файли .resx.

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

--map на -m

Повний шлях до картографічного XML-файлу, з якого потрібно прочитати папки компонентів для пакування.

--max-async-wait-time на -wt

Максимальний асинхронний час очікування в хвилинах. Стандартне значення – 60 хвилин.

--outputDirectory на -o

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

--packagetype на -p

Визначає тип видобування рішення. Може бути: "Unmanaged", "Managed" або "Both". Значення за замовчуванням: "Обидва".

--targetversion на -v

Застаріло: цей параметр ігнорується.

pac solution create-settings

Створіть файл настройок із zip-файлу рішення або папки рішення.

Приклад

pac solution create-settings --solution-zip C:\SampleSolution.zip --settings-file .\SampleDeploymentSettingsDev.json

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

--settings-file на -s

Файл .json з параметрами розгортання для посилань на підключення та змінних середовища.

--solution-folder на -f

Шлях до локальної папки розпакованого рішення: корінь файлу "Other/Solution.xml" або папка з файлом CDSPROJ.

--solution-zip на -z

Шлях до ZIP-файлу рішення.

pac solution delete

Видалення рішення з Dataverse в поточному середовищі.

Приклад

pac solution delete --solution-name Samplesolution

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

--solution-name на -sn

Ім'я рішення.

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

--environment на -env

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

pac solution export

Експорт рішення з Dataverse.

Приклад

pac solution export --path c:\Users\Documents\Solution.zip --name SampleComponentSolution --managed true --include general

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

--name на -n

Ім'я рішення, що експортується.

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

--async на -a

Експортує рішення асинхронно.

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

--environment на -env

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

--include на -i

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

Використовуйте одне або кілька з цих значень, розділених крапкою з комою:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--managed на -m

Чи слід експортувати рішення як кероване рішення.

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

--max-async-wait-time на -wt

Максимальний асинхронний час очікування в хвилинах. Стандартне значення – 60 хвилин.

--overwrite на -ow

Експортований файл рішення може перезаписати zip-файл рішення в локальній файловій системі.

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

--path на -p

Шлях, у якому записується zip-файл експортованого рішення.

--targetversion на -v

Застаріло: цей параметр ігнорується.

pac solution import

Імпорт рішення до Dataverse.

Приклад

pac solution import --path c:\Users\Documents\Solution.zip

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

--activate-plugins на -ap

Активація компонентів plug-in і робочих циклів у рішенні.

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

--async на -a

Імпортує рішення асинхронно.

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

--environment на -env

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

--force-overwrite на -f

Примусове перезаписування некерованих настройок

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

--import-as-holding на -h

Імпортуйте рішення як рішення для утримання.

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

--max-async-wait-time на -wt

Максимальний асинхронний час очікування в хвилинах. Стандартне значення – 60 хвилин.

--path на -p

Шлях до ZIP-файлу рішення. Якщо не вказано, припускається, що поточна папка – це проект cdsproj.

--publish-changes на -pc

Опублікуйте зміни під час успішного імпорту.

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

--settings-file

Файл .json з параметрами розгортання для посилань на підключення та змінних середовища.

--skip-dependency-check на -s

Пропустити перевірку залежностей від залежностей, позначених як оновлення продукту

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

--skip-lower-version на -slv

Пропустити solution import , якщо в поточному середовищі наявна та сама або пізніша версія.

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

--stage-and-upgrade на -up

Імпорт і оновлення рішення.

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

Примітки

Ви підключені до середовища за допомогою команди автентифікаціїpac для використання pac solution import.

pac solution import

Якщо Path параметр не вказано, припускається, що поточна папка – це проект cdsproj. Якщо властивість SolutionPackageType у файлі cdsproj має значення Both, кероване рішення використовується за замовчуванням.

pac solution init

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

Приклад

pac solution init --publisher-name developer --publisher-prefix dev

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

--publisher-name на -pn

Ім'я dataverse solution publisher

Примітка. Дозволено використовувати лише символи в діапазонах [A – Z], [a – z], [0 – 9] або _. Перший символ може бути лише в діапазонах [A – Z], [a – z] або _.

--publisher-prefix на -pp

Значення префікса настроювання для dataverse solution publisher

Примітка. Префікс має містити від 2 до 8 символів, може складатися лише з букв і цифр, має починатися з букви та не може починатися з "mscrm".

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

--outputDirectory на -o

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

pac solution list

Список усіх рішень від поточної організації Dataverse

Приклад

pac solution list

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

--environment на -env

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

--includeSystemSolutions

Включення системних рішень, наприклад опублікованих Microsoft

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

--json

Повертає результат команди як відформатований рядок JSON.

pac solution online-version

Отримує або встановлює версію рішення, завантаженого в Dataverse.

Приклад

pac solution online-version --solution-name Samplesolution --solution-version 1.0.0.2

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

--solution-name на -sn

Ім'я рішення.

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

--environment на -env

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

--solution-version на -sv

Укажіть solution version число. Якщо не вказано, повертається поточне підключення solution version .

pac solution pack

Упакувати компоненти рішення локальної файлової системи до solution.zip (SolutionPackager).

Приклад

pac solution pack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

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

--zipfile на -z

Повний шлях до ZIP-файлу рішення

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

--allowDelete на -ad

Диктує, чи можуть відбуватися операції видалення. Значення за промовчанням – "хибність".

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

--allowWrite на -aw

Диктує, чи можуть відбуватися операції записування. Значення за промовчанням – "хибність".

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

--clobber на -c

Вмикає видалення або перезаписування файлів, позначених лише для читання. Значення за промовчанням – "хибність".

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

--disablePluginRemap на -dpm

Вимкнуто повторне змінення імені повністю кваліфікованого типу компонента plug-in. Значення за промовчанням – "хибність".

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

--errorlevel на -e

Мінімальний рівень журналювання для виводу журналу [Детально|Відомості|Попередження|Помилка|Вимкнуто]. Значення за замовчуванням – "Відомості".

--folder на -f

Шлях до кореневої папки в локальній файловій системі. Коли розпаковується або видобувається, це написано. Під час пакування це прочитано.

--localize на -loc

Розпакуйте або об'єднайте всі рядкові ресурси у файли .resx.

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

--log на -l

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

--map на -m

Повний шлях до картографічного XML-файлу, з якого потрібно прочитати папки компонентів для пакування.

--packagetype на -p

Під час розпакування або видобування використовується для визначення подвійної керованої та некерованої операції. Під час пакування використовуйте, щоб указати керовані або некеровані з попереднього розпакування "Обидва". Може бути: "Unmanaged", "Managed" або "Both". Значення за промовчанням – "Некеровано".

--singleComponent на -sc

Виконання дії лише для одного типу компонента [WebResource|Компонент plug-in|Робочий цикл|Немає]. Стандартне значення: "Немає".

--sourceLoc на -src

Створює файл ресурсу шаблону. Припустимий лише під час видобування. Можливі значення : "автоматично" або мовний код мови, яку потрібно експортувати. Можна використовувати ідентифікатор мовного коду (LCID) або формати коду міжнародної організації зі стандартизації (ISO). Під час презентації буде видобуто рядкові ресурси з указаної мови як нейтральний .resx. Якщо вказано "auto" або лише довгу або коротку форму перемикача, використовується базова локалізація рішення.

--useLcid на -lcid

Використовуйте значення ідентифікатора коду мови (LCID) (1033), а не коди ISO Міжнародної організації зі стандартизації (ISO) (en-US) для мовних файлів.

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

--useUnmanagedFileForMissingManaged на -same

Використовуйте той самий вихідний файл XML, коли знайдено пакування для керованого та некерованого XML-файлу; застосовується до appModuleSiteMap, AppModuleMap, FormXml files.

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

solution pack Зауваження

pac solution pack підтримує два макети вихідних папок під час читання файлів компонентів: формат XML (застарілий) і вихідний формат елемента керування YAML.

Important

Підтримка формату вихідного елемента керування YAML потребує Microsoft. PowerApps.CLI версії 2.4.1 або пізнішої. Завантажте з NuGet або оновіть його за допомогою pac install latest.

Формат виявляється автоматично на основі вмісту папки:

• Якщо папка solutions/ містить підкаталог із файлами *solution.yml , → використовується формат YAML .
• Якщо не solutions/ знайдено підкаталогу → використовується формат XML (застаріла версія), для чого потрібні Other\Solution.xml та Other\Customizations.xml.

Приклад формату YAML:

pac solution pack --zipfile C:\output\MySolution.zip --folder C:\repos\myrepo

Робота зі сховищем для кількох рішень:

Якщо папка містить кілька рішень у розділі solutions/*/solution.yml, використовуйте SolutionPackager.exe безпосередньо з /SolutionName:

SolutionPackager.exe /action:Pack /zipfile:SolutionA.zip /folder:C:\repos\myrepo /SolutionName:SolutionA

Нотатка

Формат елемента керування джерелом YAML – це формат, написаний вбудованою інтеграцією Dataverse Git під час створення рішень із Power Apps. Якщо ви вручну пакуєте папку з інтегрованого репозиторію Git, використовуйте pac solution pack її з --folder указує на корінь сховища.

Докладні відомості про структуру папок YAML і компоненти, які підтримуються, див. в статті Засіб SolutionPackager – формати файлів елемента керування джерелом.

pac solution publish

Публікація всіх настройок

Приклад

pac solution publish

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

--async на -a

Асинхронно публікує всі настроювання

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

--environment на -env

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

--max-async-wait-time на -wt

Максимальний асинхронний час очікування в хвилинах. Стандартне значення – 60 хвилин.

pac solution sync

Синхронізуйте поточний проект рішення Dataverse із поточним станом рішення в організації.

Приклади

У наведених нижче прикладах показано використання pac solution sync команди.

Проста синхронізація

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

pac solution sync

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

--async на -a

Експортує рішення асинхронно.

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

--environment на -env

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

--include на -i

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

Використовуйте одне або кілька з цих значень, розділених крапкою з комою:

• autonumbering
• calendar
• customization
• emailtracking
• externalapplications
• general
• isvconfig
• marketing
• outlooksynchronization
• relationshiproles
• sales

--localize на -loc

Розпакуйте або об'єднайте всі рядкові ресурси у файли .resx.

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

--map на -m

Повний шлях до картографічного XML-файлу, з якого потрібно прочитати папки компонентів для пакування.

--max-async-wait-time на -wt

Максимальний асинхронний час очікування в хвилинах. Стандартне значення – 60 хвилин.

--packagetype на -p

Під час розпакування або видобування використовується для визначення подвійної керованої та некерованої операції. Під час пакування використовуйте, щоб указати керовані або некеровані з попереднього розпакування "Обидва". Може бути: "Unmanaged", "Managed" або "Both". Значення за замовчуванням: "Обидва".

--solution-folder на -f

Шлях до локальної папки розпакованого рішення: корінь файлу "Other/Solution.xml" або папка з файлом CDSPROJ.

pac solution unpack

Видобути компоненти рішення з solution.zip на локальну файлову систему (SolutionPackager).

Приклад

pac solution unpack --zipfile C:\SampleSolution.zip --folder .\SampleSolutionUnpacked\.

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

--zipfile на -z

Повний шлях до ZIP-файлу рішення

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

--allowDelete на -ad

Диктує, чи можуть відбуватися операції видалення. Значення за промовчанням – "хибність".

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

--allowWrite на -aw

Диктує, чи можуть відбуватися операції записування. Значення за промовчанням – "хибність".

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

--clobber на -c

Вмикає видалення або перезаписування файлів, позначених лише для читання. Значення за промовчанням – "хибність".

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

--disablePluginRemap на -dpm

Вимкнуто повторне змінення імені повністю кваліфікованого типу компонента plug-in. Значення за промовчанням – "хибність".

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

--errorlevel на -e

Мінімальний рівень журналювання для виводу журналу [Детально|Відомості|Попередження|Помилка|Вимкнуто]. Значення за замовчуванням – "Відомості".

--folder на -f

Шлях до кореневої папки в локальній файловій системі. Коли розпаковується або видобувається, це написано. Під час пакування це прочитано.

--localize на -loc

Розпакуйте або об'єднайте всі рядкові ресурси у файли .resx.

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

--log на -l

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

--map на -m

Повний шлях до картографічного XML-файлу, з якого потрібно прочитати папки компонентів для пакування.

--packagetype на -p

Під час розпакування або видобування використовується для визначення подвійної керованої та некерованої операції. Під час пакування використовуйте, щоб указати керовані або некеровані з попереднього розпакування "Обидва". Може бути: "Unmanaged", "Managed" або "Both". Значення за промовчанням – "Некеровано".

--singleComponent на -sc

Виконання дії лише для одного типу компонента [WebResource|Компонент plug-in|Робочий цикл|Немає]. Стандартне значення: "Немає".

--sourceLoc на -src

Створює файл ресурсу шаблону. Припустимий лише під час видобування. Можливі значення : "автоматично" або мовний код мови, яку потрібно експортувати. Можна використовувати ідентифікатор мовного коду (LCID) або формати коду міжнародної організації зі стандартизації (ISO). Під час презентації буде видобуто рядкові ресурси з указаної мови як нейтральний .resx. Якщо вказано "auto" або лише довгу або коротку форму перемикача, використовується базова локалізація рішення.

--useLcid на -lcid

Використовуйте значення ідентифікатора коду мови (LCID) (1033), а не коди ISO Міжнародної організації зі стандартизації (ISO) (en-US) для мовних файлів.

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

--useUnmanagedFileForMissingManaged на -same

Використовуйте той самий вихідний файл XML, коли знайдено пакування для керованого та некерованого XML-файлу; застосовується до appModuleSiteMap, AppModuleMap, FormXml files.

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

solution unpack Зауваження

За замовчуванням pac solution unpack видобуває компоненти рішення з .zip файлу у формат XML, створюючи ієрархію Other\Solution.xml .

Important

Підтримка формату вихідного елемента керування YAML потребує Microsoft. PowerApps.CLI версії 2.4.1 або пізнішої. Завантажте з NuGet або оновіть його за допомогою pac install latest.

Якщо ви працюєте з рішеннями, керованими вбудованою інтеграцією з Dataverse Git або видобутими за допомогою pac solution clone, отримана папка використовує натомість формат елемента керування джерелом YAML :

<folder>/
├── solutions/
│   └── <SolutionUniqueName>/
│       ├── solution.yml
│       ├── solutioncomponents.yml
│       ├── rootcomponents.yml
│       └── missingdependencies.yml
├── publishers/
│   └── <PublisherUniqueName>/
│       └── publisher.yml
└── [component folders — entities/, workflows/, canvasapps/, ...]

Щоб повторно розпакувати папку в цьому макеті YAML, скористайтеся .pac solution pack --folder <rootFolder> Наявність solutions/ підкаталогу автоматично сигналізує про формат YAML.

Important

Якщо ви перерахуєте компонент, але не включите його вихідні файли до папки (наприклад, файл програми rootcomponents.yml полотна в .msapp розділі canvasapps/<name>/), операцію пакета все одно буде виконано, але компонент не буде видалено з результату .zip. Щоб переконатися, що всі файли компонентів присутні, повторно експортуйте та розпакуйте повне рішення з Dataverse.

Докладні відомості про структуру папок і підтримку компонентів YAML див. в статті Засіб SolutionPackager – формати файлів вихідного елемента керування.

pac solution upgrade

Застосувати solution upgrade

Приклад

pac solution upgrade --solution-name SampleSolution --async --max-async-wait-time 60

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

--solution-name на -sn

Ім'я рішення.

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

--async на -a

Асинхронно оновлює рішення

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

--environment на -env

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

--max-async-wait-time на -wt

Максимальний асинхронний час очікування в хвилинах. Стандартне значення – 60 хвилин.

pac solution version

Оновлення збірки або версії редакції рішення.

Приклад

pac solution version --patchversion 2

pac solution version --strategy gittags

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

--buildversion на -bv

Збірка версії рішення.

Примітка. Значення має бути цілим числом із мінімальним значенням 0.

--filename на -fn

Ім'я CSV-файлу засобу відстеження, яке використовуватиметься під час використання функції filetracking як стратегії. Значення за замовчуванням – "ControlsStateVersionInfo.csv".

--patchversion на -pv

Застаріло: цей параметр ігнорується.

--revisionversion на -rv

Версія виправлення для рішення.

Примітка. Значення має бути цілим числом із мінімальним значенням 0.

--solutionPath на -sp

Шлях до каталогу рішень Dataverse або Solution.xml файлу.

--strategy на -s

Оновлено версію збірки для файлу "Solution.xml" за допомогою вказаної стратегії. Якщо ви використовуєте gittags, установіть маркер особистого доступу в такій змінної середовища "PacCli.PAT"

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

• None
• GitTags
• FileTracking
• Solution

Відмінності між pac solution clone експортом і експортом

Існують ситуації, коли ви не впевнені, коли слід використовувати pac solution clone або pac solution export командувати. Ви можете використовувати одну з команд у таких сценаріях:

• Використовуйте pac solution clone , коли потрібно додати нові компоненти до рішення.
• Використовується pac solution export , якщо потрібно змінити наявний вміст у файлі рішення, але не додати до рішення нові компоненти.

pac solution clone

Експортовано рішення виглядає як проект Visual Studio під час експорту рішення за допомогою команди pac solution clone. Замість .csproj (як у Visual Studio) відобразиться файл cdsproj. Файл cdsproj містить усі відомості про компоненти, необхідні для створення проекту. Вивід збірки – це zip-файл рішення, який можна імпортувати в різні середовища.

Розробнику не потрібно розпаковувати клоноване рішення, тому що воно відтворюється в розпакованій папці в папці src (source).

Тепер, якщо ви хочете пов'язати новостворений компонент plug-in із цим рішенням, з solution unpackед, ви можете скористатися pac solution add-reference командою, щоб оновити .cdsproj файл, щоб додати новий компонент plug-in. Потім ви можете побудувати проект за допомогою або dotnet buildmsbuild.

Перш ніж створювати проект, радимо спочатку виконати відновлення збірки. Відновлення збірки (збірка dotnet автоматично відновлюється автоматично) відновить необхідні .NET бібліотек для створення упакованого рішення.

pac solution export

Експортуючи рішення за допомогою pac solution export , ви вважаєте, що експортуєте рішення за допомогою порталу виробника, а отриманий результат – zip-файл рішення.

Коли ви розпаковуєте zip-файл рішення (не радимо відкривати zip за допомогою стандартних інструментів і використовувати відповідну команду з CLI). Отримана структура каталогу схожа на структуру в pac solution clone. Єдина відмінність полягає в тому, що не можна додавати посилання на це розпаковане рішення, оскільки в ньому немає .cdsproj файлу проекту.

Ви можете змінити відповідний набір файлів, які потрібно оновити, а потім перейти solution packдо zip-файлу рішення , щоб полегшити імпорт рішення до цільового середовища. Результатом дії є zip-файл рішення з оновленим вмістом і оновленою позначкою часу.

Див. також

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