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

Задачи Microsoft Power Platform Build Tools

  • Статья

Доступные задачи сборки описаны в следующих разделах. После этого мы продемонстрируем некоторые примеры конвейеров Azure Pipelines, использующие эти задачи. Информацию о Build Tools и о том, как их загрузить, смотрите в разделе Microsoft Power Platform Build Tools для Azure Pipelines.

Вспомогательная задача

Доступные вспомогательные задачи описаны далее.

Установщик инструментов Power Platform

Эту задачу необходимо добавить один раз перед любыми другими задачами инструментов сборки Power Platform в конвейерах сборки и выпуска. Эта задача устанавливает набор особых средств 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 Checker

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

Фрагмент кода 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. Список доступных географических регионов см. в разделе Использование API средства проверки Power Platform.
FileLocation
Расположение файлов для анализа		 Требуется при ссылке на файл с подписанного (SAS) URL-адреса sasUriFile.

Примечание. Важно ссылаться на экспортированный файл решения, а не на распакованные исходные файлы в вашем репозитории. Как файлы управляемого, так и неуправляемого решения могут быть проанализированы.
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":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Набор правил		 (Обязательно) Укажите, какой набор правил применять. Доступны следующие два набора правил:
  • Средство проверки решений: это тот же набор правил, который запускается из Power Apps Maker Portal.
  • AppSource: расширенный набор правил, который используется для сертификации приложения до его публикации в AppSource.
ErrorLevel
Уровень ошибки		 В сочетании с параметром порога ошибки определяет серьезность допустимых ошибок и предупреждений. Поддерживаемые пороговые значения: <уровень>IssueCount, где уровень = Critical, High, Medium, Low и Informational.
ErrorThreshold
Порог ошибки		 Определяет количество ошибок (> = 0) указанного уровня, которое разрешено программе проверки для передачи проверяемых решений.
FailOnPowerAppsCheckerAnalysisError
Останавливать при ошибке		 Когда true, будет ошибка, если средство проверки Power Apps возвращается как Failed или FinishedWithErrors.
ArtifactDestinationName
Имя артефакта DevOps		 Укажите имя Azure Artifacts для файла 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
Входной файл решения		 (Обязательно) Путь и имя файла solution.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
ИД компонента решения		 Имя схемы или ИД компонента для добавления в целевое решение.
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
Входной файл решения		 (Обязательно) Путь и имя файла solution.zip для распаковки.
SolutionTargetFolder
Целевая папка для распаковки решения		 (Обязательно) Путь и целевая папка, в которую вы хотите распаковать решение.
SolutionType
Тип решения		 (Обязательно) Тип решения, которое вы хотите распаковать. Варианты включают в себя: Неуправляемое (рекомендуется), Управляемое и Оба.

Упаковка решения Power Platform

Упаковывает решение, представленное в управлении исходным кодом версиями, в файл solution.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
Выходной файл решения		 (Обязательно) Путь и имя файла solution.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. Это предоставляет параметры для определения точной формы номера версии на вкладке «Параметры», например: $(Год:yyyy)-$(Месяц:MM)-$(День:dd)-$(версия: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 перенаправления указанного приложения. Требуется при указании идентификатора приложения. (См. дополнительное примечание ниже).

Заметка

При использовании типа аутентификации по имени пользователя и паролю потребуются идентификатор приложения и 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'
    DisableAdminMode: false

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

Параметры Описание
authenticationType
Тип проверки подлинности.		 (Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
PowerPlatformEnvironment
URL-адрес среды Power Platform		 Конечная точка службы для исходной среды, из которой вы хотите копировать (например, https://powerappsbuildtools.crm.dynamics.com). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
PowerPlatformSPN
Субъект-служба Power Platform		 Конечная точка службы для исходной среды, из которой вы хотите копировать (например, https://powerappsbuildtools.crm.dynamics.com). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
TargetEnvironmentUrl
URL-адрес целевой среды		 (Обязательно) URL-адрес целевой среды, в которую вы хотите выполнить копирование.
CopyType
Тип копирования		 Тип выполняемого копирования: FullCopy или MinimalCopy
OverrideFriendlyName
Переопределение понятного имени		 Измените понятное имя целевой среды на другое имя (true|false).
FriendlyName
Понятное имя		 Понятное имя целевой среды.
DisableAdminMode
Отключение режима администрирования		 Следует ли отключить режим администрирования (true|false).

Восстановление среды Power Platform

Восстанавливает среду из заданной резервной копии.

Фрагмент кода YAML (Restore-env)

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

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

Параметры Описание:
authenticationType
Тип проверки подлинности.		 (Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
PowerPlatformEnvironment
URL-адрес среды Power Platform		 Конечная точка службы для исходной среды, из которой вы хотите выполнить восстановление (например, https://powerappsbuildtools.crm.dynamics.com). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
PowerPlatformSPN
Субъект-служба Power Platform		 Конечная точка службы для исходной среды, из которой вы хотите выполнить восстановление (например, https://powerappsbuildtools.crm.dynamics.com). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
RestoreLatestBackup
Последняя резервная копия для восстановления		 Нужно ли восстанавливать последнюю резервную копию или предоставлять RestoreTimeStamp (true/false).
RestoreTimeStamp
Дата и время резервного копирования		 Дата и время резервной копии в формате "мм/дд/гггг чч:мм" или строка "latest".
TargetEnvironmentUrl
URL-адрес целевой среды		 (Обязательно) URL-адрес целевой среды, которую вы хотите восстановить.
FriendlyName
Имя восстановленной среды		 (Необязательно) Имя восстановленной среды.
DisableAdminMode
Отключение режима администрирования		 Следует ли отключить режим администрирования (true|false).

Экспорт данных Dataverse

Экспорт данных из среды с предоставленной схемой.

Фрагмент кода YAML (exportdata-env)

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

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

Параметры Описание:
authenticationType
Тип проверки подлинности.		 (Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
PowerPlatformSPN
Субъект-служба Power Platform		 Конечная точка службы для исходной среды, из которой вы хотите экспортировать данные (например, https://powerappsbuildtools.crm.dynamics.com). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
SchemaFile
Имя файла XML схемы		 Имя файла XML схемы. Его можно создать с помощью средства миграции конфигурации.
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.

Power Platform - загрузить PAPortal

Загрузка содержимого веб-сайта 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.

Power Platform - отправить PAPortal

Отправка содержимого веб-сайта 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 доступны в предварительной версии.

Установка элемента каталога

Установка элемента catalog в целевую среду.

Параметры Описание:
authenticationType
Тип проверки подлинности.		 (Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
PowerPlatformSPN
Субъект-служба Power Platform		 Конечная точка службы для исходной среды, в которую вы хотите отправить содержимое (например, https://powerappsbuildtools.crm.dynamics.com). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
Environment
URL-адрес целевой среды		 (Обязательно) URL-адрес среды, на которую нацелена эта задача.
CatalogItemId
Идентификатор элемента каталога, который необходимо установить		 (Обязательно) Элемент каталога должен быть установлен в целевой среде.
TargetEnvironmentUrl
URL-адрес целевой среды		 (Обязательно) URL-адрес целевой среды для установки элемента каталога (например, "https://YourOrg.crm.dynamics.com").
PollStatus
Проверка состояния опроса		 (Необязательно) Проведите опрос, чтобы проверить статус вашего запроса (true|false).

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

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

Отправка утверждения каталога

Отправить запрос на утверждение catalog.

Параметры Описание:
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).

Параметры (каталог-отправка)

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