Споделяне чрез

Задачи на Microsoft Power Platform Build Tools

  • Статия

Наличните задачи за изграждане са описани в следващите раздели. След това показваме някои примерни Azure Pipelines, които използват тези задачи. За информация относно инструментите за изграждане и как да ги изтеглите, вижте Microsoft Power Platform Инструменти за изграждане за 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
Използвайте версиите на инструмента по подразбиране		 Задайте на вярно, за да използвате версията по подразбиране на всички инструменти, в противен случай невярно. Задължително (и невярно), когато са посочени версии на инструмента.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Версия на инструмента		 Конкретната версия на инструмента за използване.

Power Platform WhoAmI

Потвърждава връзка с обслужване на среда на Power Platform чрез свързване и отправяне на заявка на WhoAmI. Тази задача може да бъде полезна за включване в началото на тръбопровода, за да се провери свързаността, преди да започне обработката.

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

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

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

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

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

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

Параметри Описание
authenticationType
Тип удостоверяване		 (По избор) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент. За повече информация вижте BuildTools.EnvironmentUrl под Създаване на среда на Power Platform
PowerPlatformEnvironment
URL адрес на среда на Power Platform		 Крайната точка за средата за свързване. Определя се в Сервизни връзки в Настройки на проекта. За повече информация вижте BuildTools.EnvironmentUrl под Създаване на среда на Power Platform
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка за средата за свързване. Определя се в Сервизни връзки в Настройки на проекта.

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

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

Инструмент за проверка на Power Platform

Тази задача изпълнява проверка на статичен анализ на вашите решения спрямо набор от правила за най-добри практики, за да идентифицира всички проблемни модели, които може да сте въвели по невнимание при изграждането на вашето решение.

YAML фрагмент (Проверка)

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

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

Параметри (Проверка)

Параметри Описание
PowerPlatformSPN
Сервизна връзка		 (Задължително) Връзка с лицензирана среда на Microsoft Power Platform е необходима за използване на инструмента за проверка на Power Platform. Връзките за услуга са дефинирани в Сервизни връзки под Настройки на проекта с помощта на тип на връзка Power Platform. Повече информация: вижте BuildTools.EnvironmentUrl под Power Platform Създаване на среда

Забележка: Принципал на услугата и методите за удостоверяване с потребителско име/парола са налични за задачата за проверка. За повече информация как да конфигурирате принципите на обслужване, които да се използват с тази задача вижте Конфигурирайте основните връзки на услугата за среди на Power Platform.
UseDefaultPACheckerEndpoint
Използвай първоначалната крайна точка на Power Platform		 По подразбиране (вярно) географското местоположение на услугата за проверка използва същото географско местоположение като средата, към която се свързвате.
CustomPACheckerEndpoint
Персонализирана крайна точка за проверка на PAC		 Задължително, когато UseDefaultPACheckerEndpoint е невярно. Можете да посочите друго географско местоположение, което да използвате, например https://japan.api.advisor.powerapps.com. За списък с налични географски райони вижте Използване на Power Platform API за проверка.
FileLocation
Местоположение на файловете за анализ		 Задължително при препращане към файл от URL адрес sasUriFile на подпис за споделен достъп (SAS).

Забележка: Важно е да се позовавате на експортиран файл на решение, а не на разопакованите изходни файлове във вашето хранилище. Могат да бъдат анализирани както управлявани, така и управлявани файлове с решения.
FilesToAnalyzeSasUri
SAS файлове за анализиране		 Задължително, когато FileLocation е зададено на sasUriFile. Въведете URI на SAS. Можете да добавите повече от един SAS URI чрез списък, разделен със запетая (,) или с двоеточие (;).
FilesToAnalyze
Локални файлове за анализиране		 Задължително, когато SAS файловете не се анализират. Посочете пътя и името на файла на zip файловете за анализ. Могат да се използват заместващи символи. Например enter **\*.zip за всички zip файлове във всички подпапки.
FilesToExclude
Локални файлове за изключване		 Посочете имената на файловете, които да бъдат изключени от анализа. Ако са повече от един, посочете чрез разделен списък със запетая (,) или точка и запетая (;). Този списък може да включва пълно име на файл или име с начални или крайни заместващи знаци, като *jquery или form.js
RulesToOverride
Правила за отмяна		 JSON масив, съдържащ правила и нива за отмяна. Приетите стойности за OverrideLevel са: Critical, High, Medium, Low, Informational. Пример: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Набор от правила		 (Задължително) Посочете кое правило да се приложи. Налични са следните два набора от правила:
  • Проверка на решението: Този набор от правила е същият, който се изпълнява от портала Power Apps на създателя.
  • AppSource: Разширеният набор от правила, който се използва за сертифициране на приложение, преди да може да бъде публикувано AppSource.
ErrorLevel
Ниво на грешка		 В комбинация с грешката, параметърът threshold определя сериозността на грешките и предупрежденията, които са разрешени. Поддържаните прагови стойности са <level>IssueCount, където ниво=Critical, High, Medium, Low и Informational.
ErrorThreshold
Праг на грешка		 Дефинира броя на грешките (>=0) от определено ниво, които са разрешени на проверяващия да премине проверяваните решения.
FailOnPowerAppsCheckerAnalysisError
Неуспех при грешка		 Когато е вярно, неуспешно, ако Power Apps Анализът на проверката се връща като Failed или FinishedWithErrors.
ArtifactDestinationName
Име на артефакт на DevOps		 Задайте името на артефактите на Azure за файла .sarif на проверката.

Задачи на решение

Този набор от задачи може да автоматизира действията на решение. Задачите на средата, описани по-долу в този раздел, които създават, копират или възстановяват среда, презаписват връзките на услугата с новосъздадените среди. Тези задачи правят възможно изпълнението на задачи за решение в среди, които се създават при поискване.

Импортиране на решение на Power Platform

Импортира решение в целева среда.

YAML фрагмент (Импорт)

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

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

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

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformEnvironment
URL адрес на среда на Power Platform		 Крайната точка на услугата, в която искате да импортирате решението (например, https://powerappsbuildtools.crm.dynamics.com). Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката. За повече информация вижте BuildTools.EnvironmentUrl под Създаване на среда на Power Platform
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата, в която искате да импортирате решението (например, https://powerappsbuildtools.crm.dynamics.com). Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката. За повече информация вижте BuildTools.EnvironmentUrl под Създаване на среда на Power Platform
SolutionInputFile
Входен файл на решение		 (Задължително) Пътят и името на файла на решението .zip файл за импортиране в целевата среда (например $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

Забележка: Променливите ви дават удобен начин да получите ключови битове данни в различни части на вашия тръбопровод. Вижте Използвайте предварително зададени променливи за изчерпателен списък.
HoldingSolution
Импортирайте като решение за задържане		 Предварителен параметър (true|false), използван, когато решението трябва да бъде надстроено. Този параметър е домакин на решението в Dataverse но не надгражда решението, докато не се изпълни задачата Прилагане на надграждане на решение.
OverwriteUnmanagedCustomizations
Презаписване на неуправлявани персонализирания		 Посочете дали да се презаписват неуправлявани персонализации (true|false).
SkipProductUpdateDependencies
Пропуснете зависимостите за актуализация на продукта		 Посочете дали прилагането на зависимости, свързани с актуализации на продукти, трябва да се пропусне (true|false).
ConvertToManaged
Преобразувай в управлявано		 Посочете дали да импортирате като завършено решение (true|false).
AsyncOperation
Асинхронно импортиране		 Ако е избрано (вярно), операцията по импортиране ще се извърши асинхронно. Това се препоръчва за по-големи решения, тъй като в противен случай тази задача автоматично ще изтече след 4 минути. Изборът на асинхронен ще анкетира и ще изчака, докато се достигне MaxAsyncWaitTime (true|false).
MaxAsyncWaitTime
Максимално време за изчакване		 Максимално време за изчакване в минути за асинхронната операция; по подразбиране е 60 минути (1 час), същото като Azure DevOps по подразбиране за задачи.
PublishWorkflows
Активирайте процесите след импортиране		 Посочете дали някои процеси (работни потоци) в решението трябва да бъдат активирани след импортиране (true|false).
UseDeploymentSettingsFile
Използване на файл с настройки за внедряване		 Препратки за връзка и стойности на променлива на среда могат да се зададат чрез файл с настройките за внедряване (true|false).
DeploymentSettingsFile
Файл с настройки за внедряване		 (Задължително, когато UseDeploymentSettingsFile=вярно) Пътят и името на файла с настройките за внедряване.

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
Асинхронно надграждане		 Ако е избрано (вярно), операцията по надстройване ще се извърши като асинхронна групова задача. Изборът на асинхронен ще анкетира и ще изчака, докато се достигне 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
Асинхронно експортиране		 Ако е избрано (вярно), операцията по експортиране ще се извърши като асинхронна групова задача. Изборът на асинхронен ще анкетира и ще изчака, докато се достигне MaxAsyncWaitTime.
MaxAsyncWaitTime
Максимално време за изчакване		 Максимално време за изчакване в минути за асинхронната операция; по подразбиране е 60 минути (1 час), същото като Azure DevOps по подразбиране за задачи.
Managed
Експортиране като управлявано		 Ако е избрано (вярно), експортирайте решението като завършено решение; в противен случай експортирайте като неуправляемо решение.
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. Това предоставя опции за определяне на точната форма на номера на версията в раздела „Опции“, например: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

След това тази дефиниция може да се използва в задачата „Задаване на версия на решението“ чрез задаване на свойството „Номер на версията“ с: $(Build.BuildId) вместо твърдо кодиране 20200824.0.0.2.

Алтернативно, вграден скрипт за задача на Powershell $(Get-Date -Format yyyy.MM.dd.HHmm) изход, зададен на празна променлива с име SolutionVersion като Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), задайте версия на решение като $(SolutionVersion).

Power Platform Задаване на променливи на връзката

Задава променливи BuildTools.*, за да предостави достъп до персонализирани скриптови задачи, за да използва връзката на услугата като единен източник на истина.

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

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

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

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата, за която искате да зададете променливи на връзката. Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката. За повече информация вижте BuildTools.EnvironmentUrl под Създаване на среда на Power Platform
timeoutInMinutes
Време на изчакване		 Указва максималното време, в минути, което дадена задача може да се изпълни, преди да бъде отменена от сървъра. Нулевата стойност показва безкраен изчак.
retryCountOnTaskFailure
Брой повторни опити, ако задачата е неуспешна		 Указва броя на повторните опити за тази задача, които ще се случат в случай на неуспех на задачата. Не се поддържа за задачи без агент.
ApplicationId
ИД на приложението за вход		 (Изисква се за потребителско име/парола) ИД на приложението, който да се използва за влизане (вижте допълнителната бележка по-долу).
RedirectUri
Пренасочване на URI на конкретното приложение		 (Изисква се за потребителско име/парола) Пренасочване на URI на посоченото приложение. Необходим при посочване на идентификатор на приложение (вижте допълнителната бележка по-долу).

Бележка

Когато използвате типа удостоверяване с потребителско име/парола, ще са необходими ИД на приложението и URI адрес за пренасочване. Този документ за удостоверяване има обяснение защо трябва да създадете регистрация на приложение, с която да се удостоверите 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
Език		 (Задължително) Основният език в средата.
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
ДатаЧас на архивното копие		 Дата и час на резервното копие във формат „mm/dd/yyyy hh:mm“ ИЛИ низ „най-ново“.
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 Съдържанието на уебсайта за презаписване (вярно|невярно).

Импортиране Dataverse на данни

Импортиране на данни в среда.

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

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

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

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата за средата, в която искате да импортирате данни (например, https://powerappsbuildtools.crm.dynamics.com). Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката.
DataFile
Име на файла с данни		 Име на файла за компресиран zip) файл с данни за импортиране или папката с data-schema.xml и data.xml за импортиране.

Power Pages Управленски задачи

Задачи за работа с Power Pages уебсайт.

PAPortal за изтегляне на Power Platform

Изтегляне на съдържанието на уеб сайта на Power Pages от текущата среда на Dataverse.

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

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

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

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата за средата, от която искате да изтеглите съдържание (например). https://powerappsbuildtools.crm.dynamics.com Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката.
WebsiteId
ID на уебсайта на портала		 Power Pages идентификатор на уебсайт за изтегляне.
Overwrite
Презаписване на съдържание		 Power Pages Съдържанието на уебсайта за презаписване (вярно|невярно).
ModelVersion
Модел на данни на сайта		 Показва дали данните от сайта, които ще бъдат качени, ще използват стандартния (1) или подобрения модел на данни(2). Стойността по подразбиране е "1".

PAPortal за качване на Power Platform

Качване Power Pages на съдържание на уебсайта в текущата Dataverse среда.

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

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

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

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата за средата, в която искате да качвате съдържание (например, https://powerappsbuildtools.crm.dynamics.com). Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката.
UploadPath
Път за качване на съдържанието		 Път, откъдето ще бъде качено съдържанието на Power Pages уебсайта.
ModelVersion
Модел на данни на сайта		 Показва дали данните от сайта, които ще бъдат качени, ще използват стандартния (1) или подобрения модел на данни(2). Стойността по подразбиране е "1".

Каталог за Power Platform задачи (преглед)

Тези задачи извършват действия спрямо каталога и Power Platform включват следното.

Бележка

В момента каталожните задачи за Power Platform са предварителен преглед.

Инсталиране на елемент от каталога

Инсталиране на елемент от каталога в целевата среда.

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата за средата, в която искате да качвате съдържание (например, https://powerappsbuildtools.crm.dynamics.com). Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката.
Environment
URL адрес на целева среда		 (Задължително) URL адрес на средата, към който е насочена тази задача.
CatalogItemId
Каталожен ИД на артикул, който трябва да бъде инсталиран		 (Задължително) Елемент от каталога, който трябва да бъде инсталиран в целевата среда.
TargetEnvironmentUrl
URL адрес на целева среда		 (Задължително) URL адресът на целевата среда за инсталиране на елемент от каталога в (например "https://YourOrg.crm.dynamics.com").
PollStatus
Проверете състоянието на анкетата		 (По избор) Анкета, за да проверите състоянието на заявката си (вярно|невярно).

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

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

Изпращане на одобрение на каталога

Изпращане на заявка за одобрение за каталога.

Параметри Описание
authenticationType
Тип удостоверяване		 (Изисква се за SPN) Посочете едно от двете PowerPlatformEnvironment за връзка с потребителско име/парола или PowerPlatformSPN за секретна връзка между принципал на услугата/клиент.
PowerPlatformSPN
Принципал на услуга на Power Platform		 Крайната точка на услугата за средата, в която искате да качите съдържание (например "https://powerappsbuildtools.crm.dynamics.com"). Дефинирано под Сервизни връзки в Настройки на проекта използвайки Power Platform вид на връзката.
Environment
URL адрес на целева среда		 (Задължително) URL адрес на средата, към който е насочена тази задача.
CatalogSubmissionFile
Файл за подаване на каталог		 (Задължително) Задайте пътя и името на файла за подаване на каталога.
UsePackageSolutionZipFile
Файлов тип		 Тип файл: zip файл на пакет или решение.
SolutionZipFile
Име на zip файла на решението		 Задайте пътя и името на файла на zip файла на решението.
PollStatus
Проверете състоянието на анкетата		 (По избор) Анкета, за да проверите състоянието на заявката си (вярно|невярно).

Параметри (каталог-изпращане)

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
Тип заявка		 (Задължително) Тип Reqeust. (Стойности: Инсталиране | Изпращане).

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

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