Задачи Microsoft Power Platform Build Tools

Статья
03/29/2024

Доступные задачи сборки описаны в следующих разделах. После этого мы продемонстрируем некоторые примеры конвейеров 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@0
  displayName: 'Power Platform Tool Installer'

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

Параметры (установщик)

Параметры	Описание
`DefaultVersion` Использовать версии инструментов по умолчанию	Установлено как true, чтобы использовать версию всех инструментов по умолчанию; в противном случае — false. Обязательно (и false) при указании любых версий инструмента.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` Версия инструмента	Конкретная версия используемого инструмента.

Power Platform WhoAmI

Проверяет подключение службы среды Power Platform путем подключения и отправки запроса WhoAmI. Эту задачу может быть полезно включить на раннем этапе конвейера для проверки возможности подключения до начала обработки.

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

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

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

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

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

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

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

Проверка качества

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

Power Platform Checker

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

Фрагмент кода YAML (средство проверки)

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

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

Параметры (средство проверки)

Параметры	Описание
`PowerPlatformSPN` Подключение службы	(Обязательно) Подключение к лицензированной среде Microsoft Power Platform должно использовать средство проверки Power Platform. Подключения к службе определены в Подключения к службе в Параметры проекта с использованием типа соединения Power Platform. Дополнительная информация: см. `BuildTools.EnvironmentUrl` в разделе Создание платформы Power Platform Примечание. Методы аутентификации "Субъект-служба" и "имя пользователя/пароль"— единственные методы аутентификации, доступные для задачи средства проверки. Для получения дополнительной информации о том, как настроить субъекты-службы для использования с этой задачей, см. Настройка соединения субъекта-службы для сред Power Platform.
`UseDefaultPACheckerEndpoint` Использовать конечную точку средства проверки Power Platform по умолчанию	По умолчанию (true) географическое расположение службы средства проверки использует тот же регион, что и среда, к которой вы подключаетесь.
`CustomPACheckerEndpoint` Пользовательская проверка конечной точки средства проверки PAC	Требуется, когда `UseDefaultPACheckerEndpoint` указано как false. Вы можете указать другое географическое местоположение, например `https://japan.api.advisor.powerapps.com.` Список доступных географических регионов см. в разделе Использование 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@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

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

Параметры (Импорт)

Параметры	Описание
`authenticationType` Тип проверки подлинности.	(Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
`PowerPlatformEnvironment` URL-адрес среды Power Platform	Конечная точка службы, в которую вы хотите импортировать решение (например, `https://powerappsbuildtools.crm.dynamics.com`). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform. Дополнительные сведения см. по `BuildTools.EnvironmentUrl` в разделе Создание среды Power Platform
`PowerPlatformSPN` Субъект-служба Power Platform	Конечная точка службы, в которую вы хотите импортировать решение (например, `https://powerappsbuildtools.crm.dynamics.com`). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform. Дополнительные сведения см. по `BuildTools.EnvironmentUrl` в разделе Создание среды Power Platform
`SolutionInputFile` Входной файл решения	(Обязательно) Путь и имя файла 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@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

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

Параметры (Обновление)

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

Заметка

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

Дополнительная информация: Предварительное заполнение ссылок на подключение и переменных среды для автоматизированных развертываний

Экспорт решения Power Platform

Экспорт решения из исходной среды.

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

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

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

Параметры (Экспорт)

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

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

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

Фрагмент кода YAML (распаковать)

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

Параметры (распаковать)

Параметры	Описание
`SolutionInputFile` Входной файл решения	(Обязательно) Путь и имя файла solution.zip для распаковки.
`SolutionTargetFolder` Целевая папка для распаковки решения	(Обязательно) Путь и целевая папка, в которую вы хотите распаковать решение.
`SolutionType` Тип решения	(Обязательно) Тип решения, которое вы хотите распаковать. Варианты включают в себя: Неуправляемое (рекомендуется), Управляемое и Оба.

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

Упаковывает решение, представленное в управлении исходным кодом версиями, в файл solution.zip, который можно импортировать в другую среду.

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

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

Параметры (упаковать)

Параметры	Описание
`SolutionOutputFile` Выходной файл решения	(Обязательно) Путь и имя файла solution.zip для упаковки решения.
`SolutionSourceFolder` Исходная папка решения для упаковки	(Обязательно) Путь и исходная папка решения для упаковки.
`SolutionType` Тип решения	(Обязательно) Тип решения, которое вы хотите упаковать. Варианты включают: Управляемое (рекомендуется), Неуправляемое и Оба.

Удаление решения Power Platform

Удаление решения в целевой среде.

Фрагмент кода YAML (Удалить)

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

Параметры (Удалить)

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

Публикация настроек Power Platform

Публикует все настройки в среде.

Фрагмент кода YAML (опубликовать)

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

Параметры (Опубликовать)

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

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

Обновляет версию решения.

Фрагмент кода YAML (Версия)

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

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

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

Хотя номер версии можно жестко запрограммировать в конвейере, рекомендуется использовать переменную конвейера Azure DevOps, такую как BuildId. Это предоставляет параметры для определения точной формы номера версии на вкладке «Параметры», например: $(Год: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@0
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Параметры (Развернуть)

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

Задачи управления средой

Автоматизируйте общие задачи управления жизненным циклом среды (ELM).

Создание среды Power Platform

Создает новую среду. Создание новой среды также автоматически создает BuildTools.EnvironmentUrl.

Внимание

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

Новая среда может быть подготовлена только в том случае, если ваша лицензия или емкость позволяют создавать дополнительные среды. Для получения дополнительной информации о том, как посмотреть емкость, см. раздел Сведения страницы емкости.

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

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

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

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

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

Удаление среды Power Platform

Удаление среды.

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

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

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

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

Назначить пользователя в Power Platform

Назначение пользователя целевой среде с указанной ролью безопасности.

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

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

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

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

Выполнить сброс среды Power Platform

Сбрасывает среду.

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

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

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

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

Создание резервной копии среды Power Platform

Создание резервной копии среды.

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

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

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

Параметры	Описание
`authenticationType` Тип проверки подлинности.	(Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
`PowerPlatformEnvironment` URL-адрес среды Power Platform	Конечная точка службы, в которой вы хотите резервировать среду (например, `https://powerappsbuildtools.crm.dynamics.com`). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
`PowerPlatformSPN` Субъект-служба Power Platform	Конечная точка службы, в которой вы хотите резервировать среду (например, `https://powerappsbuildtools.crm.dynamics.com`). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
`BackupLabel` Метка резервной копии	(Обязательно) Метка, которая будет назначена резервной копии.

Копирование среды Power Platform

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

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

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

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

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

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

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

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

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

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

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

Параметры	Описание:
`authenticationType` Тип проверки подлинности.	(Обязательно для SPN) Укажите либо PowerPlatformEnvironment для подключения имени пользователя/пароля или PowerPlatformSPN для подключения субъекта-службы/секрета клиента.
`PowerPlatformEnvironment` URL-адрес среды Power Platform	Конечная точка службы для исходной среды, из которой вы хотите выполнить восстановление (например, `https://powerappsbuildtools.crm.dynamics.com`). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
`PowerPlatformSPN` Субъект-служба Power Platform	Конечная точка службы для исходной среды, из которой вы хотите выполнить восстановление (например, `https://powerappsbuildtools.crm.dynamics.com`). Определено в Подключения к службе в Параметры проекта с помощью типа соединения Power Platform.
`RestoreLatestBackup` Последняя резервная копия для восстановления	Нужно ли восстанавливать последнюю резервную копию или предоставлять RestoreTimeStamp (true/false).
`RestoreTimeStamp` Дата и время резервного копирования	Дата и время резервной копии в формате "мм/дд/гггг чч:мм" или строка "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 Build Tools для Azure DevOps