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

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

  • Стаття

Доступні завдання створення описані в розділах нижче. Після цього ми наведемо кілька прикладів 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@2
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  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@2
  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@2
  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@2
  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@2
  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 API 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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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'
    SkipAuditData: true

Параметри (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
Зрозуміле ім’я		 Зрозуміле ім’я цільового середовища.
SkipAuditData
SkipAuditData		 Чи потрібно пропускати дані аудиту під час операції копіювання. (істина|брехня).

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
Ім'я файлу Schema XML		 Ім'я файлу Schema 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 (download-paportal)

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) або розширену модель даних(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) або розширену модель даних(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).

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

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 Інструменти для збірки Azure DevOps