Завдання інструментів створення Microsoft Power Platform

Стаття
03/29/2024

Доступні завдання створення описані в розділах нижче. Після цього ми продемонструємо кілька прикладів Azure Pipelines, які використовують ці завдання. Для отримання відомостей про інструменти збирання та способи їх завантаження перегляньте Microsoft Power Platform статтю Засоби збирання для Azure Pipelines.

Завдання помічника

Далі описані наявні допоміжні завдання.

Інсталятор засобів Power Platform

Це завдання необхідно додати одноразово перед кожним іншим завданням Power Platform Build Tools у процесі реалізації збірки та випуску. У цьому завданні інсталюється набір спеціальних інструментів Power Platform, необхідних агенту, щоб виконати завдання створення Microsoft Power Platform. Це завдання не потребує додаткового налаштування після додавання. Це завдання містить параметри для конкретних версій кожного з інструментів, що встановлюються.

Щоб постійно використовувати найновіші версії, переконайтесь, що ці параметри відповідають версіям засобів, які є необхідними для нормального функціонування воронки продажів.

Фрагмент YAML (інсталятор)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

Параметри (інсталятор)

Параметри	Опис
`DefaultVersion` Використання версій засобу за замовчуванням	Установіть значення true, щоб використовувати стандартні версії усіх засобів, а інакше укажіть false. Обов'язково (і обов'язково false), якщо вказано бодай які-небудь версії засобів.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` Версія засобу	Певна версія засобу, яку слід використовувати.

Power Platform WhoAmI

Перевіряє підключення середовища Power Platform до послуг, виконуючи підключення та запит WhoAmI. Це завдання буде корисним, якщо внести його до початку роботи воронки продажів, де воно перевірятиме підключення перед початком обробки.

Фрагмент YAML (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

Параметри (WhoAmI)

Параметри	Опис
`authenticationType` Тип автентифікації	(Необов'язково) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби для середовища, до якої потрібно підключитися. Визначається в розділі Підключення до служби розділу Настройки проекту. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, до якої потрібно підключитися. Визначається в розділі Підключення до служби розділу Настройки проекту.

Перевірка якості

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

Засіб перевірки Power Platform

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

Фрагмент YAML (Засіб перевірки)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Параметри (Засіб перевірки)

Параметри	Опис
`PowerPlatformSPN` Підключення до служб	(Обов'язково) Необхідне підключення до ліцензійного середовища Microsoft Power Platform, щоб використати засіб перевірки Power Platform. Підключення до служб визначається в Підключеннях до служб у Настройках проекту за допомогою типу з'єднання Power Platform. Додаткові відомості: дивіться `BuildTools.EnvironmentUrl` розділ Power Platform Створення середовища Примітка: Реєстраційний запис служби та методи розпізнавання за іменем користувача і паролем доступні для завдання перевірки. Щоб отримати додаткові відомості про налаштування принципала служби для використання з цим завданням, див. Настроювання підключень принципала служб для середовищ Power Platform.
`UseDefaultPACheckerEndpoint` Використовувати кінцеву точку засобу перевірки Power Platform за замовчуванням	За замовчуванням (true) географічне розташування чекерної служби використовує ту саму географію, що й середовище, до якого ви підключаєтеся.
`CustomPACheckerEndpoint` Користувацька кінцева точка засобу перевірки PAC	Обов'язково, якщо `UseDefaultPACheckerEndpoint` має значення false. Ви можете вказати інше географічне розташування, наприклад `https://japan.api.advisor.powerapps.com.` Список доступних географічних регіонів можна знайти у розділі Використання програмного інтерфейсу Power Platform Checker.
`FileLocation` Розташування файлів для аналізу	Обов’язковий при посиланні на файл з URL-адреси `sasUriFile` спільного підпису доступу (SAS).Примітка: Важливо посилатися на експортований файл рішення, а не на розпаковані вихідні файли у вашому репозиторії. Аналізувати можна керовані та некеровані файли рішень.
`FilesToAnalyzeSasUri` SAS-файли для аналізу	Обов'язково, якщо `FileLocation` має значення `sasUriFile`. Введіть URI-адресу SAS. Можна додати кілька SAS URI розділеним списком через кому (,) або крапку з комою (;).
`FilesToAnalyze` Локальні файли для аналізу	Обов’язковий, якщо файли SAS не аналізуються. Укажіть ім’я ZIP-файлів для аналізу та шлях до них. Можна використовувати символи узагальнення. Наприклад, введіть ** \*.zip для всіх zip-файлів у всіх вкладених папках.
`FilesToExclude` Локальні файли, які потрібно виключити	Укажіть імена файлів, які слід виключити з аналізу. Якщо таких файлів більше одного, вкажіть їх у вигляду списку із роздільником комою (,) або крапкою з комою (;). Цей список може містити повне ім'я файлу або ім'я з символами узагальнення на початку або в кінці, наприклад, *jquery або form.js
`RulesToOverride` Правила, які слід перевизначити	Масив JSON, який містить правила та рівні, що слід перевизначити. OverrideLevel може приймати такі значення: Критичний, Високий, Середній, Низький, Інформація. Приклад: [{ «Id»:«meta-remove-dup-reg», «OverrideLevel»: «Середній», }{ «Id»:«il-avoid-update-ops», «OverrideLevel»: «Середній» }]
`RuleSet` Набір правил	(Обов'язково) Вкажіть, який набір правил слід застосовувати. У програмі передбачено зазначені нижче два набори правил. Засіб перевірки рішень: цей набір правил є тим самим, що запускається з порталу Power Apps виробника. AppSource: розширений набір правил, який використовується для сертифікації застосунку перед його публікацією AppSource.
`ErrorLevel` Рівень помилки	У поєднанні з похибкою, пороговий параметр визначає серйозність помилок і попереджень, які допускаються. Підтримуваними граничними значеннями є <level>IssueCount, де level=Критичний, Високий, Середній, Низький або Інформація.
`ErrorThreshold` Граничне значення помилок	Визначає кількість помилок (>=0) для вказаного рівня, яку може дозволити засіб перевірки при перевірці рішення.
`FailOnPowerAppsCheckerAnalysisError` Припиняти виконання в разі помилки	Якщо це значення — true, виконання припинятиметься, якщо аналіз засобу перевірки Power Apps буде повернуто як Failed («Помилка») або FinishedWithErrors («Завершено із помилками»).
`ArtifactDestinationName` Назва артефакту DevOps	Укажіть ім’я артефактів Azure для файлу .sarif засобу перевірки.

Завдання рішення

Цей набір завдань може автоматизувати дії рішення. Завдання середовища, описані далі в цьому розділі, які створюють, копіюють або відновлюють середовище, перезаписують з’єднання служб із новоствореними середовищами. Ці завдання дозволяють виконувати завдання розв’язання середовищ, які створюються на вимогу.

Імпорт рішення Power Platform

Імпортує рішення до цільового середовища.

Фрагмент YAML (Імпорт)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

Параметри (Імпорт)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, до якої потрібно імпортувати рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, до якої потрібно імпортувати рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`SolutionInputFile` Вхідний файл рішення	(Обов’язково) Шлях та ім’я файлу рішення .zip файл для імпорту в цільове середовище (наприклад, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip). Примітка. Змінні надають зручний спосіб помістити ключові частини даних у різні частини вашого процесу. Повний список див. в розділі Використання попередньо визначених змінних.
`HoldingSolution` Імпорт у якості рішення-контейнера	Параметр прогресу (true\|false) використовується, якщо рішення потребує оновлення до наступної версії. Цей параметр розміщує рішення в Dataverse, але не оновлює його до наступної версії, доки не буде виконано завдання «Застосувати оновлення рішення».
`OverwriteUnmanagedCustomizations` Перезаписати некеровані настроювання	Укажіть, чи слід перезаписати некеровані настроювання (true\|false).
`SkipProductUpdateDependencies` Пропустити залежності при оновленні продукту	Укажіть, чи слід пропустити примусове виконання залежностей, пов’язаних з оновленнями продукту (true\|false).
`ConvertToManaged` Перетворити на кероване	Укажіть, чи слід імпортувати як кероване рішення (true\|false).
`AsyncOperation` Асинхронний імпорт	Якщо вибрано (true), операція імпорту буде виконуватися асинхронно. Це рекомендовано для великих рішень, інакше таке завдання буде автоматично вимкнено після 4 хвилин. При виборі асинхронного режиму виконуватиметься опитування, а потім — очікування, поки не сплине час MaxAsyncWaitTime (true\|false).
`MaxAsyncWaitTime` Максимальний час очікування	Максимальний час очікування у хвилинах для асинхронної операції; за замовчуванням 60 хвилин (1 година), так само як і значення в Azure DevOps для завдань.
`PublishWorkflows` Активувати процеси після імпорту	Укажіть, чи слід активувати якісь процеси (робочі цикли) в рішенні після імпортування (true\|false).
`UseDeploymentSettingsFile` Використовувати файл параметрів розгортання	Посилання на підключення та значення змінних середовища можна вказувати за допомогою файлу параметрів розгортання (true\|false).
`DeploymentSettingsFile` Файл параметрів розгортання	(Обов'язково, якщо `UseDeploymentSettingsFile`=true) Шлях та ім'я файлу із параметрами розгортання.

Power Platform Додати компонент розчину

Додає компонент рішення до некерованого рішення.

YAML фрагмент (Додати)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
  displayName: 'Power Platform Add Solution Component '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SolutionName: 'SampleSolution '
    Component: contact
    ComponentType: 1
    AddRequiredComponents: false

Параметри (додати)

Параметри	Опис
`ComponentId` ID компонента рішення	Ім’я схеми або ідентифікатор компонента, який потрібно додати до цільового рішення.
`ComponentType` URL-адреса середовища Power Platform	Значення, яке представляє компонент рішення, який ви додаєте. Перегляньте статтю Використання попередньо визначених типів компонентів, щоб отримати вичерпний список значень компонентів.
`SolutionUniqueName` Назва рішення	Унікальна назва рішення.
`AddRequiredComponents` Будь-які компоненти, необхідні з іншого розчину, залежать від компонента розчину	(Необов’язково.) Указує, чи слід також додавати інші компоненти рішення, які потрібні компоненту рішення, який ви додаєте, до некерованого рішення.
`Environment` URL-адреса або ідентифікатор середовища	(Необов’язково.) URL-адреса середовища або ідентифікатор цільового середовища.

Застосувати оновлення рішення Power Platform

Оновлює рішення, що було імпортовано в якості рішення-контейнера.

Фрагмент YAML (Оновлення до нової версії)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Параметри (Оновлення до нової версії)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, до якої потрібно оновити рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, до якої потрібно оновити рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`SolutionName` Назва рішення:	(Обов'язково) Ім'я рішення для застосування оновлення. Завжди використовуйте Ім'я рішення, а не його Коротке ім’я.
`AsyncOperation` Асинхронне оновлення	Якщо вибрано (true), операція оновлення буде виконуватися як асинхронне пакетне завдання. При виборі асинхронного режиму виконуватиметься опитування, а потім — очікування, поки не сплине час MaxAsyncWaitTime.
`MaxAsyncWaitTime` Максимальний час очікування	Максимальний час очікування у хвилинах для асинхронної операції; за замовчуванням 60 хвилин (1 година), так само як і значення в Azure DevOps для завдань.

Нотатка

Змінні надають зручний спосіб отримати ключові частини даних в різні частини вашого процесу. Повний список див. в розділі Використання попередньо визначених змінних. Під час імпортування рішення за допомогою файлу параметрів розгортання можна попередньо заповнити посилання на зв’язок та відомості про змінні середовища.

Додаткові відомості: Попереднє заповнення посилань на зв’язок та змінних середовища для автоматичних розгортань

Експорт рішення Power Platform

Експортує рішення з вихідного середовища.

Фрагмент YAML (Експорт)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Параметри (Експорт)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, до якої потрібно оновити рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, до якої потрібно оновити рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`SolutionName` Назва рішення:	(Обов'язково) Назва рішення, яке необхідно експортувати. Завжди використовуйте Ім'я рішення, а не його Коротке ім’я.
`SolutionOutputFile` Вихідний файл рішення	(Обов’язково) Шлях та ім’я файлу solution.zip, до якого слід експортувати вихідне середовище (наприклад, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ). Примітка. Змінні надають зручний спосіб помістити ключові частини даних у різні частини вашого процесу. Повний список див. в розділі Використання попередньо визначених змінних.
`AsyncOperation` Асинхронний експорт	Якщо вибрано (true), операція експорту буде виконуватися як асинхронне пакетне завдання. При виборі асинхронного режиму виконуватиметься опитування, а потім — очікування, поки не сплине час MaxAsyncWaitTime.
`MaxAsyncWaitTime` Максимальний час очікування	Максимальний час очікування у хвилинах для асинхронної операції; за замовчуванням 60 хвилин (1 година), так само як і значення в Azure DevOps для завдань.
`Managed` Експортувати як кероване	Якщо вибрано (true), рішення експортується як кероване рішення; в іншому разі виконується експорт як некерованого рішення.
`ExportAutoNumberingSettings` Експорт параметрів автоматичної нумерації	Експорт параметрів автоматичної нумерації (true\|false).
`ExportCalendarSettings` Експорт параметрів календаря	Експорт параметрів календаря (true\|false).
`ExportCustomizationSettings` Експорт параметрів настроювань	Експорт параметрів настроювань (true\|false).
`ExportEmailTrackingSettings` Експорт параметрів відстеження повідомлень електронної пошти	Експорт параметрів відстеження електронної пошти (true\|false).
`ExportGeneralSettings` Експорт загальних параметрів	Експорт загальних параметрів (true\|false).
`ExportIsvConfig` Експорт конфігурації ISV	Експорт конфігурації ISV (true\|false).
`ExportMarketingSettings` Експорт параметрів маркетингу	Експорт параметрів маркетингу (true\|false).
`ExportOutlookSynchronizationSettings` Експортування параметрів синхронізації Outlook	Експорт параметрів синхронізації Outlook (true\|false).
`ExportRelationshipRoles` Експорт ролей зв'язків	Експорт ролей зв'язків (true\|false).
`ExportSales` Експорт відомостей збуту	Експорт відомостей збуту (true\|false).

Розпакування рішення Power Platform

Розпаковує стиснуте рішення в декілька файлів XML, щоб система керування вхідним кодом могла легше їх зчитувати та керувати ними.

Фрагмент YAML (Розпаковування)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

Параметри (Розпаковування)

Параметри	Опис
`SolutionInputFile` Вхідний файл рішення	(Обов'язково) Ім’я шляху та ZIP-файлу рішення, яке потрібно розпакувати.
`SolutionTargetFolder` Папка призначення для розпакування рішення	(Обов'язково) Шлях і папка призначення, до якої потрібно розпакувати рішення.
`SolutionType` Тип рішення	(Обов'язково) Тип рішення, яке потрібно розпакувати. Параметри включають: Некероване (рекомендовано), Кероване і Обидва.

Пакування рішення Power Platform

Пакує рішення, представлене у системі керування вхідним кодом, у ZIP-файл рішення, який можна імпортувати до іншого середовища.

Фрагмент YAML (Спаковування)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@0
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Параметри (Спаковування)

Параметри	Опис
`SolutionOutputFile` Вихідний файл рішення	(Обов'язково) Шлях та ім’я ZIP-файлу рішення, в яке упаковано рішення.
`SolutionSourceFolder` Вихідна папка рішення для пакування	(Обов'язково) Шлях і вихідна папка рішення для пакування.
`SolutionType` Тип рішення	(Обов'язково) Тип рішення, яке потрібно упакувати. Параметри включають: Кероване (рекомендовано), Некероване і Обидва.

Видалення рішення Power Platform

Видаляє рішення в цільовому середовищі.

Фрагмент YAML (Видалення)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@0
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Параметри (Видалення)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, рішення якої потрібно видалити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, рішення якої потрібно видалити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`SolutionName` Назва рішення:	(Обов'язково) Ім’я рішення, яке потрібно видалити. Завжди використовуйте Ім'я рішення, а не його Коротке ім’я.

Публікація настроювань Power Platform

Публікує всі настроювання в середовищі.

Фрагмент YAML (Публікація)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@0
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Параметри (Публікація)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, на якій потрібно опублікувати настроювання (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, на якій потрібно опублікувати настроювання (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform

Задавання версії рішення Power Platform

Оновлює версії рішення.

Фрагмент YAML (Версія)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@0
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

Параметри (Версія)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, для якої потрібно встановити версію рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, для якої потрібно встановити версію рішення (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`SolutionName` Назва рішення:	(Обов'язково) Ім'я рішення, для якого потрібно встановити версію. Завжди використовуйте Ім'я рішення, а не його Коротке ім’я.
`SolutionVersionNumber` Номер версії рішення	(Обов'язково) Номер версії, який необхідно задати.

Хоча номер версії можна жорстко кодувати у воронці продажів, рекомендується скористатися змінною воронки продажів Azure DevOps, наприклад BuildId. Таким чином можна визначити точну форму номера версії на вкладці «Параметри», наприклад: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Це визначення потім можна використовувати у завданні «Задавання версії рішення», задавши для властивості «Номер версії» $(Build.BuildId) замість жорсткого кодування 20200824.0.0.2.

Крім того, результат сценарію powershell завдання у коді $(Get-Date -Format yyyy.MM.dd.HHmm), що виводиться у пусту змінну SolutionVersion як Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), задає версію рішення як $(SolutionVersion).

Power Platform Встановлення змінних підключення

Встановлює змінні BuildTools.* для надання користувацьким завданням скриптів доступу до використання з’єднання служби як єдиного джерела достовірної інформації.

YAML фрагмент (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Параметри (SetConnectionVariables)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, для якої потрібно встановити змінні підключення. Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`timeoutInMinutes` Час очікування	Визначає максимальний час, у хвилинах, який дозволено виконати завданню, перш ніж його буде скасовано сервером. Нульове значення вказує на нескінченний тайм-аут.
`retryCountOnTaskFailure` Кількість повторних спроб у разі невдачі завдання	Вказує кількість повторних спроб для цього завдання, які відбудуться у разі помилки завдання. Не підтримується для завдань без використання агентів.
`ApplicationId` Ідентифікатор програми для входу	(Обов’язково для імені користувача/пароля) Ідентифікатор програми, який слід використовувати для входу в систему (див. додаткову примітку нижче).
`RedirectUri` Переспрямування URI конкретного додатка	(Обов’язково для імені користувача/пароля) Переспрямуйте URI вказаного додатка. Потрібен, коли вказується ідентифікатор додатка (див. додаткову примітку нижче).

Нотатка

Якщо використовується тип автентифікації за іменем користувача/паролем, потрібно буде вказати ідентифікатор програми та адресу переспрямування. Цей документ автентифікації oauth містить пояснення того, чому вам потрібно створити реєстрацію програми для автентифікації Dataverse. Коли ви встановлюєте з’єднання за допомогою автентифікації за іменем користувача або паролем, з’єднання поводиться як програма, яка підключається від імені користувача Dataverse.

Розгортання пакета Power Platform

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

Фрагмент YAML (Розгортання)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Параметри (Розгортання)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, на якій ви хочете розгорнути пакет (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, на якій ви хочете розгорнути пакет (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform. Додаткові відомості: див. `BuildTools.EnvironmentUrl` у розділі Створення середовища у Power Platform
`PackageFile` Файл пакета	(Обов'язково) Шлях та ім'я файлу для збірки файлу пакета (.dll).
`MaxAsyncWaitTime` Максимальний час очікування	Максимальний час очікування у хвилинах для асинхронної операції; за замовчуванням 60 хвилин (1 година), так само як і значення в Azure DevOps для завдань.

Завдання керування середовищем

Автоматизуйте загальні завдання керування життєвим циклом середовища (ELM).

Створення середовища Power Platform

Створює нове середовище. При створенні нового середовища також автоматично створюється BuildTools.EnvironmentUrl.

Важливо

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

Нове середовище можна підготувати, лише якщо ліцензія або обсяг сховища дозволяє створювати додаткові середовища. Додаткові відомості про перегляд обсягу сховища див. в розділі Відомості сторінки "Обсяг".

Фрагмент YAML (Create-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    DisplayName: 'First Coffee test'
    DomainName: firstcoffee

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@0
  displayName: 'Power Platform Create Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    DisplayName: 'First Coffee prod'
    EnvironmentSku: Production
    AppsTemplate: 'D365_CustomerService,D365_FieldService'
    LocationName: canada
    LanguageName: 1036
    CurrencyName: ALL
    DomainName: firstcoffee

Параметри (Create-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, середовище якої потрібно створити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, середовище якої потрібно створити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`DisplayName` Коротке ім’я	(Обов’язково) Коротке ім’я створеного середовища.
`LocationName` Регіон розгортання	(Обов’язково) Регіон, в якому буде створено середовище.
`EnvironmentSku` Тип середовища	(Обов’язково) Тип інсталяції, яку потрібно розгорнути. Варіанти — Ізольоване, Робоче, Ознайомлювальне та SubscriptionBasedTrial.
`AppsTemplate` Програми	Для не-ознайомлювальних типів середовищ підтримуються такі програми, як D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation і D365_Sales.
`CurrencyName` Грошова одиниця	(Обов’язково) Базова грошова одиниця для створеного середовища. Після створення середовища грошову одиницю не можна оновити.
`LanguageName` Language	(Обов’язково) Основна мова в середовищі.
`DomainName` Ім’я домену	(Обов’язково) Це рядок для конкретного середовища, який формує частину URL-адреси. Наприклад, для середовища з URL-адресою`https://powerappsbuildtasks.crm.dynamics.com/` ім’я домену буде "powerappsbuildtasks". Примітка. Якщо ввести ім’я домену, яке вже використовується, це завдання додає числове значення до імені домену, починаючи з 0. У вищенаведеному прикладі URL-адреса може стати`https://powerappsbuildtasks0.crm.dynamics.com/`.

Видалення середовища Power Platform

Видаляє середовище.

Фрагмент YAML (Delete-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@0
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Параметри (Delete-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, середовище якої потрібно видалити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, середовище якої потрібно видалити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.

Power Platform Призначити користувача

Призначте користувача цільовому середовищу з указаним роль безпеки.

YAML фрагмент (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Параметри (AssignUser-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, якому потрібно призначити користувача (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`User` Power Platform Ім’я користувача	Microsoft Entra ідентифікатор об’єкта або ім’я учасника, яке потрібно призначити цільовому середовищу.
`Role` роль безпеки ім’я або ідентифікатор	роль безпеки ім’я або ідентифікатор, які будуть присвоєні користувачеві.
`ApplicationUser` Power Platform Ім’я користувача програми	Визначає, чи є вхідний користувач користувачем програми (true\|false).

Power Platform Скинути середовище

Скидання середовища.

YAML фрагмент (Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

Параметри (Reset-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, до якої потрібно скинути середовище (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, до якої потрібно скинути середовище (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.

Створення резервної копії середовища Power Platform

Створює резервну копію середовища.

Фрагмент YAML (Backup-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.backup-environment.PowerPlatformBackupEnvironment@0
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Параметри (Backup-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби, для якої потрібно створити резервну копію середовища (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби, для якої потрібно створити резервну копію середовища (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`BackupLabel` Підпис для резервної копії	(Обов'язково) Надпис, який буде призначений резервній копії.

Копіювання середовища Power Platform

Копіює середовище до цільового середовища. Доступні два типи копій: повна та мінімальна. Повна копія містить дані та метадані рішень (настроювання), тоді як Мінімальна копія містить лише метадані рішення, а не фактичні дані.

Фрагмент YAML (Copy-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.copy-environment.PowerPlatformCopyEnvironment@0
  displayName: 'Power Platform Copy Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    CopyType: MinimalCopy
    OverrideFriendlyName: true
    FriendlyName: 'Contoso Test'
    DisableAdminMode: false

Параметри (Copy-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби для вихідного середовища, з якого потрібно скопіювати (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для вихідного середовища, з якого потрібно скопіювати (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`TargetEnvironmentUrl` URL-адреса цільового середовища	(Обов'язково) URL-адреса для цільового середовища, до якого потрібно копіювати.
`CopyType` Тип копії	Тип копії, який потрібно створити: FullCopy або MinimalCopy
`OverrideFriendlyName` Перезаписати зрозуміле ім'я	Змінити зрозуміле ім'я кінцевого середовища на інше ім'я (true\|false).
`FriendlyName` Зрозуміле ім’я	Зрозуміле ім’я цільового середовища.
`DisableAdminMode` Вимкнути режим адміністрування	Чи потрібно вимкнути режим адміністрування (true\|false).

Power Platform Відновити навколишнє середовище

Відновлює середовище до вказаної резервної копії.

YAML фрагмент (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Параметри (Restore-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformEnvironment` URL-адреса середовища Power Platform	Кінцева точка служби для вихідного середовища, з якого потрібно відновити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для вихідного середовища, з якого потрібно відновити (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`RestoreLatestBackup` Остання резервна копія для відновлення	Чи потрібно відновлювати останню резервну копію, чи надавати RestoreTimeStamp (true\|false).
`RestoreTimeStamp` DateTime резервного копіювання	Дата й час створення резервної копії у форматі "dd.mm.yyyy hh:mm" або рядок "latest".
`TargetEnvironmentUrl` URL-адреса цільового середовища	(Обов’язково) URL-адреса цільового середовища, яке потрібно відновити.
`FriendlyName` Ім’я відновленого середовища	(Необов’язково.) Ім’я відновленого середовища.
`DisableAdminMode` Вимкнути режим адміністрування	Чи потрібно вимкнути режим адміністрування (true\|false).

Експорт Dataverse даних

Експорт даних із середовища з наданою схемою.

YAML фрагмент (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

Параметри (exportdata-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, з якого потрібно експортувати дані (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`SchemaFile` Ім’я файлу XML схеми	Ім’я файлу XML схеми. Його можна створити за допомогою інструменту Configuration Migration.
`DataFile` Ім’я файлу даних	Ім’я файлу для експорту даних (zip-файл).
`Overwrite` Перезапис контенту	Power Pages вміст веб-сайту для перезапису (true\|false).

Імпорт Dataverse даних

Імпорт даних у середовище.

YAML фрагмент (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

Параметри (importdata-env)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, в яке потрібно імпортувати дані (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`DataFile` Ім’я файлу даних	Ім’я файлу для стисненого zip) файл даних, який потрібно імпортувати, або папка з data-schema.xml та data.xml, які потрібно імпортувати.

Power Pages Завдання управління

Завдання для роботи з сайтом Power Pages .

PAPortal завантаження Power Platform

Завантажити вміст веб-сайту Power Pages із поточного середовища Dataverse.

YAML фрагмент (завантажити-папортал)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.download-paportal.PowerPlatformDownloadPaportal@2
  displayName: 'Power Platform Download PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DownloadPath: 'C:\portals'
    WebsiteId: 'f88b70cc-580b-4f1a-87c3-41debefeb902'
    Overwrite: true

Параметри (download-paportal)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, з якого потрібно завантажити вміст (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`WebsiteId` Ідентифікатор веб-сайту порталу	Power Pages ідентифікатор веб-сайту для завантаження.
`Overwrite` Перезапис контенту	Power Pages вміст веб-сайту для перезапису (true\|false).
`ModelVersion` Модель даних сайту	Указує, чи використовуватимуться дані сайту, які потрібно завантажити, стандартний (`1`) чи розширений тип даних model (`2`). Типовим значенням є ’1’.

PAPortal завантаження Power Platform

Завантажте Power Pages контент сайту в поточне Dataverse середовище.

YAML фрагмент (upload-paportal)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Параметри (upload-paportal)

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, до якого потрібно завантажувати вміст (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`UploadPath` Шлях до завантаження вмісту	Шлях, звідки буде завантажено Power Pages контент веб-сайту.
`ModelVersion` Модель даних сайту	Указує, чи використовуватимуться дані сайту, які потрібно завантажити, стандартний (`1`) чи розширений тип даних model (`2`). Типовим значенням є ’1’.

Каталог завдань Power Platform (попередній перегляд)

Ці завдання виконують дії з каталогом у Power Platform каталозі та включають наступне.

Нотатка

Наразі завдання каталогу для Power Platform є попереднім переглядом .

Встановити елемент каталогу

Інсталюйте елемент каталогу в цільовому середовищі.

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, до якого потрібно завантажувати вміст (наприклад, `https://powerappsbuildtools.crm.dynamics.com`). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`Environment` URL-адреса цільового середовища	(Обов’язково) URL-адреса середовища, на яку спрямоване це завдання.
`CatalogItemId` Ідентифікатор товару каталогу, який потрібно встановити	(Обов’язково) Елемент каталогу, який буде встановлено в цільовому середовищі.
`TargetEnvironmentUrl` URL-адреса цільового середовища	(Обов’язково) Url-адреса цільового середовища для встановлення елемента каталогу (наприклад, "https://YourOrg.crm.dynamics.com").
`PollStatus` Як перевірити статус опитування	(Необов’язково.) Проведіть опитування, щоб перевірити статус вашого запиту (true\|false).

Параметри (каталог-встановлення)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.install-catalog.PowerPlatformInstallCatalog@2
  displayName: 'Power Platform Install Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogItemId: '00000000-0000-0000-0000-000000000001'
    TargetEnvironmentUrl: 'https://test.crm.dynamics.com/'
    PollStatus: true

Надіслати схвалення каталогу

Надіслати запит на затвердження каталогу.

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, до якого потрібно завантажувати вміст (наприклад, "https://powerappsbuildtools.crm.dynamics.com"). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`Environment` URL-адреса цільового середовища	(Обов’язково) URL-адреса середовища, на яку спрямоване це завдання.
`CatalogSubmissionFile` Файл подання каталогу	(Обов’язково) Укажіть шлях та ім’я файлу подання каталогу.
`UsePackageSolutionZipFile` Тип файлу	Тип файлу: zip-файл пакета або рішення.
`SolutionZipFile` Рішення zip-файлу ім’я	Вкажіть шлях та ім’я файлу zip-файлу рішення.
`PollStatus` Як перевірити статус опитування	(Необов’язково.) Проведіть опитування, щоб перевірити статус вашого запиту (true\|false).

Параметри (catalog-submit)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.submit-catalog.PowerPlatformSubmitCatalog@2
  displayName: 'Power Platform Submit Catalog '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    CatalogSubmissionFile: submission.json
    UsePackageSolutionZipFile: true
    FileType: SolutionZipFile
    SolutionZipFile: solution.zip
    PollStatus: true

Статус запиту в каталозі

Отримайте статус запиту на встановлення/надсилання каталогу.

Параметри	Опис
`authenticationType` Тип автентифікації	(Обов'язково для SPN) Укажіть PowerPlatformEnvironment для підключення із використанням імені користувача та пароля або PowerPlatformSPN для підключення за принципалом служби / секретним ключем клієнта.
`PowerPlatformSPN` Принципал служби Power Platform	Кінцева точка служби для середовища, до якого потрібно завантажувати вміст (наприклад, "https://powerappsbuildtools.crm.dynamics.com"). Визначається в області Підключення до послуг у Параметрах проекту за допомогою типу підключення Power Platform.
`Environment` URL-адреса цільового середовища	(Обов’язково) URL-адреса середовища, на яку спрямоване це завдання.
`TrackingId` Ідентифікатор відстеження запиту	(Обов’язково) Надішліть запит на ідентифікатор відстеження.
`RequestType` Тип запиту	(Обов’язково) Тип рек’юсту. (Значення: Встановити \| Надіслати).

Параметри (статус каталогу)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Процеси створення та випуску

Тепер, коли ми визначили, що можна робити за допомогою інструментів створення, давайте подивимося, як застосовувати ці інструменти до ваших процесів створення та випуску. Нижче наведено концептуальний огляд. Розгляньмо деякі відомості про реалізацію цього процесу за допомогою завдань створення у підрозділах, розміщених нижче.

Щоб дізнатися більше про створення цих процесів і практично виконати створення процесів за допомогою Microsoft Power Platform Build Tools, виконайте лабораторні роботи інструментів створення, які можна завантажити з GitHub.

Додаткові відомості про Azure Pipelines: Використання Azure Pipelines

Створення процесу: експорт рішення з середовища розробки (DEV)

На рисунку нижче зображено завдання інструментів створення, які можна додати до процесу, який експортує рішення із середовища розробки.

Експорт рішення з середовища розробки (DEV).

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

На рисунку нижче зображено завдання інструментів створення, які можна додати до процесу, який створює кероване рішення.

Побудуйте кероване рішення.

Процес випуску: розгортання у виробниче середовище (PROD)

На рисунку нижче зображено завдання інструментів створення, які можна додати до процесу, який виконує розгортання у виробниче середовище.

Розгортання у виробничому середовищі (PROD).

Див. також

Microsoft Power Platform Build Tools для Azure DevOps

Поділитися через

Завдання інструментів створення Microsoft Power Platform

Завдання помічника

Інсталятор засобів Power Platform

Фрагмент YAML (інсталятор)

Параметри (інсталятор)

Power Platform WhoAmI

Фрагмент YAML (WhoAmI)

Параметри (WhoAmI)

Перевірка якості

Засіб перевірки Power Platform

Фрагмент YAML (Засіб перевірки)

Параметри (Засіб перевірки)

Завдання рішення

Імпорт рішення Power Platform

Фрагмент YAML (Імпорт)

Параметри (Імпорт)

Power Platform Додати компонент розчину

YAML фрагмент (Додати)

Параметри (додати)

Застосувати оновлення рішення Power Platform

Фрагмент YAML (Оновлення до нової версії)

Параметри (Оновлення до нової версії)

Експорт рішення Power Platform

Фрагмент YAML (Експорт)

Параметри (Експорт)

Розпакування рішення Power Platform

Фрагмент YAML (Розпаковування)

Параметри (Розпаковування)

Пакування рішення Power Platform

Фрагмент YAML (Спаковування)

Параметри (Спаковування)

Видалення рішення Power Platform

Фрагмент YAML (Видалення)

Параметри (Видалення)

Публікація настроювань Power Platform

Фрагмент YAML (Публікація)

Параметри (Публікація)

Задавання версії рішення Power Platform

Фрагмент YAML (Версія)

Параметри (Версія)

Power Platform Встановлення змінних підключення

YAML фрагмент (SetConnectionVariables)

Параметри (SetConnectionVariables)

Розгортання пакета Power Platform

Фрагмент YAML (Розгортання)

Параметри (Розгортання)

Завдання керування середовищем

Створення середовища Power Platform

Фрагмент YAML (Create-env)

Параметри (Create-env)

Видалення середовища Power Platform

Фрагмент YAML (Delete-env)

Параметри (Delete-env)

Power Platform Призначити користувача

YAML фрагмент (AssignUser-env)

Параметри (AssignUser-env)

Power Platform Скинути середовище

YAML фрагмент (Reset-env)

Параметри (Reset-env)

Створення резервної копії середовища Power Platform

Фрагмент YAML (Backup-env)

Параметри (Backup-env)

Копіювання середовища Power Platform

Фрагмент YAML (Copy-env)

Параметри (Copy-env)

Power Platform Відновити навколишнє середовище

YAML фрагмент (Restore-env)

Параметри (Restore-env)

Експорт Dataverse даних

YAML фрагмент (exportdata-env)

Параметри (exportdata-env)

Імпорт Dataverse даних

YAML фрагмент (importdata-env)

Параметри (importdata-env)

Power Pages Завдання управління

PAPortal завантаження Power Platform

YAML фрагмент (завантажити-папортал)

Параметри (download-paportal)

PAPortal завантаження Power Platform