Завдання Microsoft Power Platform Build Tools

У наведених нижче розділах описано доступні завдання збірки. Після цього ми продемонструємо кілька прикладів Azure Pipelines, які використовують ці завдання. Для інформації про інструменти збірки та як їх завантажити дивіться Microsoft Power Platform Build Tools for 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

# 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. Обов'язковий (і хибний), коли ви вказуєте будь-які версії інструментів.
AddToolsToPath
Додайте інструменти до контуру		 Додає pac CLI до змінної PATH середовища. Ви можете використовувати pac CLI із завдань сценаріїв, не налаштовуючи шлях вручну.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Версія засобу		 Певна версія засобу, яку слід використовувати.

Силова платформа 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 Create Environment
PowerPlatformEnvironment
URL-адреса середовища Power Platform		 Кінцева точка служби для середовища, до якої потрібно підключитися. Визначається в розділі Підключення до служби розділу Настройки проекту. Докладні відомості див BuildTools.EnvironmentUrl . в розділі Power Platform Create Environment
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
Підключення до служб		 (Обов'язково) Щоб використовувати засіб перевірки Power Platform, потрібне підключення до ліцензованого середовища Microsoft Power Platform. Визначення підключень служб у розділіProject Настройки за допомогою типу підключення Power Platform. Докладні відомості див BuildTools.EnvironmentUrl . в розділі Створення середовища платформи Power Platform.

Примітка. Завдання перевірки підтримує принципал служби, а також методи автентифікації імені користувача та пароля. Докладні відомості про настроювання принципалів служби для цього завдання див. в статті Настроювання основних підключень служби для середовищ Power Platform.
UseDefaultPACheckerEndpoint
Використовувати кінцеву точку засобу перевірки Power Platform за замовчуванням		 За замовчуванням (true) географічне розташування служби перевірки використовує ту саму географію, що й середовище, до якого ви підключаєтеся.
CustomPACheckerEndpoint
Користувацька кінцева точка засобу перевірки PAC		 Обов'язково, якщо UseDefaultPACheckerEndpoint має значення false. Укажіть інше географічне розташування, наприклад https://japan.api.advisor.powerapps.com. Список доступних географічних даних див. в статті Використання API перевірки платформи Power Platform.
FileLocation
Розташування файлів для аналізу		 Обов'язково під час посилання на файл із URL-адреси sasUriFileпідпису спільного доступу (SAS).

Примітка. Посилання на експортований файл рішення, а не розпаковані вихідні файли у сховищі. Ви можете аналізувати як керовані, так і некеровані файли рішень.
FilesToAnalyzeSasUri
SAS-файли для аналізу		 Обов'язково, якщо FileLocation має значення sasUriFile. Введіть URI-адресу SAS. Ви можете додати кілька URI SAS через кому (,) або крапку з комою (;) розділений список.
FilesToAnalyze
Локальні файли для аналізу		 Обов’язковий, якщо файли SAS не аналізуються. Укажіть ім’я ZIP-файлів для аналізу та шлях до них. Можна використовувати символи узагальнення. Наприклад, введіть ** \*.zip для всіх zip-файлів у всіх вкладених папках.
FilesToExclude
Локальні файли, які потрібно виключити		 Укажіть імена файлів, які потрібно вилучити з аналізу. Якщо вказано кілька файлів, використовуйте кому (,) або крапку з комою (;) розділений список. Цей список може містити повне ім'я файлу або ім'я з символами узагальнення на початку або в кінці, наприклад *jquery або form.js.
RulesToOverride
Правила, які слід перевизначити		 Масив JSON, який містить правила та рівні, що слід перевизначити. Допустимі значення: OverrideLevel Критичні, Високі, Середні, Низькі, Інформаційні. Приклад: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Набір правил		 (Обов'язково) Вкажіть, який набір правил слід застосовувати. У програмі передбачено зазначені нижче два набори правил.
  • Засіб перевірки розв'язання. Цей набір правил працює на порталі Power Apps maker.
  • Marketplace: розширений набір правил, який використовується для сертифікації додатку перед її публікацією на Marketplace.
ErrorLevel
Рівень помилки		 У поєднанні з параметром граничного значення помилки це значення визначає серйозність дозволених помилок і попереджень. Підтримуваними граничними значеннями є <level>IssueCount, де level=Критичний, Високий, Середній, Низький або Інформація.
ErrorThreshold
Граничне значення помилок		 Визначає кількість помилок (>=0) для вказаного рівня, яку може дозволити засіб перевірки при перевірці рішення.
FailOnPowerAppsCheckerAnalysisError
Припиняти виконання в разі помилки		 Якщо значення true, помилка виникає, якщо аналіз перевірки Power Apps повертається як Failed або FinishedWithErrors.
ArtifactDestinationName
Назва артефакту DevOps		 Specify name Azure Artifacts for the checker .sarif file.

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

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

Імпорт рішення 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

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
Перетворити на кероване		 Застарілих. Система перетворить некеровані компоненти рішення на керовані під час імпорту керованого рішення.
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 Встановлення змінних підключення

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

Встановлюються такі змінні:

  • PowerPlatformSetConnectionVariables.BuildTools.TenantId
  • PowerPlatformSetConnectionVariables.BuildTools.ApplicationId
  • PowerPlatformSetConnectionVariables.BuildTools.ClientSecret
  • PowerPlatformSetConnectionVariables.BuildTools.DataverseConnectionString

Фрагмент 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.

Important

Якщо задано, 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
    MaxAsyncWaitTime: 60

Параметри (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		 Чи потрібно пропускати дані аудиту під час операції копіювання. (істина|брехня).
MaxAsyncWaitTime
Максимальний час очікування		 Максимальний час очікування в кількості хвилин для асинхронної роботи; За замовчуванням — 60 хвилин (1 година), як і Azure DevOps за замовчуванням для завдань.

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
Ідентифікатор веб-сайту порталу		 ID сайту 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, завершіть лабораторії інструментів build tools, які можна завантажити з GitHub.

Більше інформації про Azure Pipelines: Використовуйте Azure Pipelines

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

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

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

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

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

Створіть кероване рішення.

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

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

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

Статті за темою

Microsoft Power Platform Інструменти для збірки для Azure DevOps

  • Last updated on