Бөлісу құралы:


Microsoft Power Platform Build Tools тапсырмалары

Қолжетімді құрастыру тапсырмалары келесі бөлімдерде сипатталған. Содан кейін біз осы тапсырмаларды пайдаланатын Azure құбырларының кейбір мысалын көрсетеміз. Құрастыру құралдары және оларды жүктеп алу жолы туралы ақпаратты Microsoft Power Platform Azure Pipelines үшін құрастыру құралдары бөлімінен қараңыз.

Көмекші тапсырма

Қол жетімді көмекші тапсырмалар келесіде сипатталады.

Power Platform құрал орнатушысы

Бұл тапсырманы құрастырылым мен шығарылым арналарындағы басқа кез келген Power Platform құрастыру құралдарының тапсырмаларының алдында қосу қажет. Бұл тапсырма агент Microsoft Power Platform құрастыру тапсырмаларын іске қосу үшін қажет 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
Әдепкі құрал нұсқаларын пайдалану
Барлық құралдардың әдепкі нұсқасын пайдалану үшін шын мәніне орнатыңыз, болмаса жалған. Кез келген құрал нұсқалары көрсетілгенде міндетті (және жалған).
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Құрал нұсқасы
Қолданылатын құралдың арнайы нұсқасы.

Power Platform WhoAmI

WhoAmI сұранысын қосу және жасау арқылы Power Platform орта қызметінің қосылымын растайды. Бұл тапсырма үдерістер тізбегін ертерек қосып, өңдеу басталғанға дейін қосылымды тексеру үшін тиімді болуы мүмкін.

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
Power Platform ортасының URL мекенжайы
Ортаға қосылатын қызметтің соңғы нүктесі. Жоба параметрлері ішіндегі Қызмет қосылымдары тармағында анықталған. Қосымша ақпарат: 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
Қызмет қосылымы
(Міндетті) Power Platform тексергіш құралын пайдалану үшін лицензияланған Microsoft Power Platform ортасына қосылым қажет. Қызметтік қосылымдар Power Platform қосылым түрін пайдаланатын Проект параметрлері тармағындағы Қызмет қосылымдары бөлімінде анықталады. Қосымша ақпарат: BuildTools.EnvironmentUrl астындағы Power Platform Ортаны жасау

бөлімінен қараңыз.Ескертпе: Қызметтің негізгі және пайдаланушы аты/құпия сөздің аутентификация әдістері тексеруші тапсырмасы үшін қолжетімді. Осы тапсырмада пайдаланылатын субъект-қызметін конфигурациялау жолы туралы қосымша ақпаратты Power Platform орталары үшін субъект-қызмет қосылымдарын конфигурациялау бөлімінен қараңыз.

UseDefaultPACheckerEndpoint
Әдепкі Power Platform тексеру құралының соңғы нүктесін пайдалану
Әдепкі бойынша (шын), тексеру қызметінің географиялық орны сіз қосылатын орта сияқты географияны пайдаланады.
CustomPACheckerEndpoint
Реттелетін PAC тексеру құралының соңғы нүктесі
UseDefaultPACheckerEndpoint параметрі жалған болған кезде қажет. Қолдану үшін басқа географияны көрсетуге болады, мысалы https://japan.api.advisor.powerapps.com. Қол жетімді географиялар тізімін Power Platform Checker API пайдалану бөлімін қараңыз. .
FileLocation
Талдау үшін файлдардың орны
Ортақ қатынас қолтаңбасының (SAS) URL мекенжайынан файлға сілтеме жасау кезінде талап етіледі sasUriFile.

Ескертпе: репозиторийдегі қаптамадан шығарылған бастапқы файлдарға емес, экспортталған шешім файлына сілтеме жасау маңызды. Басқарылатын және басқарылмайтын шешім файлдарын талдауға болады.

FilesToAnalyzeSasUri
Талдау керек SAS файлдары
FileLocation параметрі sasUriFile орнатылған кезде қажет. SAS URI мекенжайын енгізіңіз. Үтір (,) немесе нүктелі үтір (;) арқылы тізімге бірнеше 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 жасаушы порталынан іске қосылғанмен бірдей.
  • AppSource: Қолданбаны AppSource ішіне жарияламас бұрын куәландыру үшін пайдаланылатын кеңейтілген ережелер жинағы.
ErrorLevel
Қате деңгейі
Қатемен біріктірілген шекті параметр рұқсат етілген қателер мен ескертулердің ауырлығын анықтайды. Қолдау көрсетілетін шекті мәндер <level>IssueCount, мұнда level=критикалық, жоғары, орташа, төмен және ақпараттық.
ErrorThreshold
Қатенің шекті мәні
Тексеру құралына тексерілетін шешімдерден өтуге рұқсат етілген көрсетілген деңгейдегі қателер санын (>=0) анықтайды.
FailOnPowerAppsCheckerAnalysisError
Қатемен сәтсіздік
Шын болған кезде, Power Apps тексеру талдауы Failed немесе FinishedWithErrors ретінде қайтарылады.
ArtifactDestinationName
DevOps артефакт атауы
Checker .sarif файлы үшін Azure Artifacts атауын көрсетіңіз.

Шешім тапсырмалары

Бұл тапсырмалар жиынтығы шешім әрекеттерін автоматтандыруы мүмкін. Осы бөлімде кейінірек сипатталған ортаны жасайтын, көшіретін немесе қалпына келтіретін орта тапсырмалары жаңадан жасалған орталармен қызмет қосылымдарын қайта жазады. Бұл тапсырмалар сұраныс бойынша жасалған орталарға қарсы шешім тапсырмаларын орындауға мүмкіндік береді.

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
Power Platform ортасының URL мекенжайы
Шешімді импорттағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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
Холдингтік шешім ретінде импорттау
Шешімді жаңарту қажет болған кезде пайдаланылатын жетілдіру параметрі (шын|жалған). Бұл параметр шешімді Dataverse бағдарламасында орналастырады, бірақ шешімді жаңартуды қолдану тапсырмасы орындалмайынша оны жаңартпайды.
OverwriteUnmanagedCustomizations
Басқарылмайтын теңшеулерді қайта жазу
Басқарылмайтын теңшеулерді қайта жазу керектігін көрсетіңіз (шын|жалған).
SkipProductUpdateDependencies
Өнімді жаңарту тәуелділіктерін өткізіп жіберу
Өнім жаңартуларына қатысты тәуелділіктерді орындауды өткізіп жіберу керектігін көрсетіңіз (шын|жалған).
ConvertToManaged
Басқарылатынға түрлендіру
Басқарылатын шешім ретінде импорттау керектігін не керек еместігін көрсетіңіз (шын|жалған).
AsyncOperation
Үндестірілмеген импорттау
Егер таңдалған болса (шын), импорттау операциясы үндестірілмеген түрде орындалады. Бұл үлкен шешім үшін ұсынылады, себебі бұл тапсырма басқаша түрде 4 минуттан кейін автоматты түрде тоқтайды. Үндестірілмеген таңдау сауалнама жүргізеді және MaxAsyncWaitTime уақыты жеткенше күтеді (шын|жалған).
MaxAsyncWaitTime
Максималды күту уақыты
Үндестірілмеген операция үшін минут бірлігіндегі максималды күту уақыты; әдепкі — 60 мин (1 сағ), сол сияқты Azure DevOps тапсырмалары үшін әдепкі.
PublishWorkflows
Импорттаудан кейін процестерді белсендіру
Шешімдегі қандай да бір процестерді (жұмыс ағындарын) импорттаудан кейін белсендіру керектігін не керек еместігін көрсетіңіз (шын|жалған).
UseDeploymentSettingsFile
Орналастыру параметрлерінің файлын пайдалану
Қосылым сілтемелерін және ортаның айнымалы мәндерін орналастыру параметрлерінің файлы (шын|жалған) арқылы орнатуға болады.
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
Power Platform ортасының URL мекенжайы
Қосып жатқан шешім құрамдасын көрсететін мән. Құрамдас мәндердің толық тізімі үшін Алдын ала анықталған құрамдас түрлерін пайдалану бөлімін қараңыз.
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
Power Platform ортасының URL мекенжайы
Шешімді жаңартқыңыз келетін қызметтің соңғы нүктесі (мысалы, 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@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
Power Platform ортасының URL мекенжайы
Шешімді жаңартқыңыз келетін қызметтің соңғы нүктесі (мысалы, 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
Автоматты нөмірлеу параметрлерін экспорттау
Автоматты нөмірлеу параметрлерін экспорттаңыз (шын|жалған).
ExportCalendarSettings
Күнтізбе параметрлерін экспорттау
Күнтізбе параметрлерін экспорттаңыз (шын|жалған).
ExportCustomizationSettings
Теңшеу параметрлерін экспорттау
Теңшеу параметрлерін экспорттаңыз (шын|жалған).
ExportEmailTrackingSettings
Электрондық поштаны бақылау параметрлерін экспорттау
Электрондық поштаны бақылау параметрлерін экспорттаңыз (шын|жалған).
ExportGeneralSettings
Жалпы параметрлерді экспорттау
Жалпы параметрлерді экспорттаңыз (шын|жалған).
ExportIsvConfig
ISV конфигурациясын экспорттау
ISV конфигурациясын экспорттаңыз (шын|жалған).
ExportMarketingSettings
Маркетинг параметрлерін экспортта
Маркетинг параметрлерін экспорттаңыз (шын|жалған).
ExportOutlookSynchronizationSettings
Outlook синхрондау параметрлерін экспорттау
Outlook синхрондау параметрлерін экспорттаңыз (шын|жалған).
ExportRelationshipRoles
Қарым-қатынас рөлдерін экспорттау
Қарым-қатынас рөлдерін экспорттаңыз (шын|жалған).
ExportSales
Сатылымды экспорттайды
Сатылымды экспорттайды (шын|жалған).

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
Power Platform ортасының URL мекенжайы
Шешімді жойғыңыз келетін қызметтің соңғы нүктесі (мысалы, 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
Power Platform ортасының URL мекенжайы
Теңшеулерді жариялағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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
Power Platform ортасының URL мекенжайы
Шешім нұсқасын орнатқыңыз келетін қызметтің соңғы нүктесі (мысалы, 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
Шешім нұсқасының нөмірі
(Міндетті) Орнатқыңыз келетін нұсқа нөмірі.

Үдерістер тізбегінде нұсқа нөмірін қатаң кодтау мүмкін болса да, алайда BuildId сияқты Azure DevOps үдерістер тізбегі айнымалысын пайдалану ұсынылады. Бұл "Параметрлер" қойындысының астында нұсқа нөмірінің нақты пішінін анықтауға мүмкіндік береді, мысалы: $ (жыл: жжжж)-$ (ай: АА)-$ (күн: кк)-$ (айналым: аа)-3

Осы анықтама шешім нұсқасын орнату тапсырмасында 20200824.0.0.2 кіріктірудің орнына нұсқа нөмірінің сипатын келесідей етіп орнату арқылы пайдаланылады: $(Build.BuildId).

Немесе Powershell кірістірілген тапсырма сценарийі $(Get-Date -Format yyyy.MM.dd.HHmm) шығысы Write-Host ретінде SolutionVersion деп аталатын бос айнымалыға орнатылады ("##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
Power Platform ортасының URL мекенжайы
Буманы орналастырғыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 үзіндісі (орта жасау)

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

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

Параметрлер Сипаттамасы
authenticationType
Аутентификация түрі
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз.
PowerPlatformEnvironment
Power Platform ортасының URL мекенжайы
Ортаны жасағыңыз келетін қызметтің соңғы нүктесі (мысалы, 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 үзіндісі (ортаны жою)

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

Параметрлер (ортаны жою)

Параметрлер Сипаттамасы
authenticationType
Аутентификация түрі
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз.
PowerPlatformEnvironment
Power Platform ортасының URL мекенжайы
Ортаны жойғыңыз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
PowerPlatformSPN
Power Platform қызмет‑субъектісі
Ортаны жойғыңыз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.

Power Platform Пайдаланушыны тағайындау

Пайдаланушыны қауіпсіздік рөлі көрсетілген мақсатты ортаға тағайындаңыз.

YAML үзінді (User-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 қолданбаның пайдаланушы аты
Енгізу пайдаланушысы қолданба пайдаланушысы екенін анықтайды (шын|жалған).

Power Platform Ортаны қалпына келтіру

Ортаны қалпына келтіреді.

YAML үзінді (Қалпына келтіру-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
Power Platform ортасының URL мекенжайы
Ортаны қалпына келтіргіңіз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
PowerPlatformSPN
Power Platform қызмет‑субъектісі
Ортаны қалпына келтіргіңіз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.

Power Platform сақтық көшірмесін жасау ортасы

Ортаның сақтық көшірмесін жасайды.

YAML үзіндісі (ортаның сақтық көшірмесін жасау)

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)'

Параметрлер (ортаның сақтық көшірмесін жасау)

Параметрлер Сипаттамасы
authenticationType
Аутентификация түрі
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз.
PowerPlatformEnvironment
Power Platform ортасының URL мекенжайы
Ортаның сақтық көшірмесін жасағыңыз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
PowerPlatformSPN
Power Platform қызмет‑субъектісі
Ортаның сақтық көшірмесін жасағыңыз келетін қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
BackupLabel
Сақтық көшірмелеу белгісі
(Міндетті) Сақтық көшірмеге тағайындалатын белгі.

Power Platform ортаны көшіру

Мақсатты ортаға ортаны көшіреді. Көшірменің екі түрі бар: толық және минималды. Толық көшірме деректер мен шешімдердің метадеректерін (теңшеулер) де қамтиды, ал минималды көшірме нақты деректерді емес, шешім метадеректерін ғана қамтиды.

YAML үзіндісі (ортаны көшіру)

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

Параметрлер (ортаны көшіру)

Параметрлер Сипаттамасы
authenticationType
Аутентификация түрі
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз.
PowerPlatformEnvironment
Power Platform ортасының URL мекенжайы
Көшіретін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
PowerPlatformSPN
Power Platform қызмет‑субъектісі
Көшіретін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
TargetEnvironmentUrl
Мақсатты орта URL
(Міндетті) Көшіру керек мақсатты ортаның URL мекенжайы.
CopyType
Көшіру түрі
Орындалатын көшірме түрі: FullCopy немесе MinimalCopy
OverrideFriendlyName
Түсінікті атауды алдын ала анықтау
Мақсатты ортаның түсінікті атауын басқа атауға өзгертіңіз (шын|жалған).
FriendlyName
Түсінікті атау
Мақсатты ортаның түсінікті атауы.
DisableAdminMode
Басқару режимін өшіру
Басқару режимін өшіру керек не керек емес (шын|жалған).

Power Platform Қоршаған ортаны қалпына келтіру

Ортаны берілген сақтық көшірмеге қалпына келтіреді.

YAML үзінді (қалпына келтіру)

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'

Параметрлер (қалпына келтіру-env)

Параметрлер Сипаттама
authenticationType
Аутентификация түрі
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз.
PowerPlatformEnvironment
Power Platform ортасының URL мекенжайы
Қалпына келтіргіңіз келетін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
PowerPlatformSPN
Power Platform қызмет‑субъектісі
Қалпына келтіргіңіз келетін бастапқы ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
RestoreLatestBackup
Қалпына келтіру үшін соңғы сақтық көшірме
Соңғы сақтық көшірмені қалпына келтіру немесе RestoreTimeStamp (шын|жалған) беру керек пе.
RestoreTimeStamp
Сақтық көшірменің DateTime
"аа.кк.жжжж сс:мм" пішіміндегі сақтық көшірменің жасалған уақыты НЕМЕСЕ "ең соңғы" жолы.
TargetEnvironmentUrl
Мақсатты орта URL
(Міндетті) Қалпына келтіргіңіз келетін мақсатты ортаның URL мекенжайы.
FriendlyName
Қалпына келтірілген ортаның атауы
(Қосымша) Қалпына келтірілген ортаның атауы.
DisableAdminMode
Басқару режимін өшіру
Басқару режимін өшіру керек не керек емес (шын|жалған).

Dataverse Деректерді экспорттау

Берілген схемасы бар ортадан деректерді экспорттау.

YAML үзінді (экспорттау деректері)

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 үзінді (импорттау деректері)

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 үзінді (жүктеу-папортал)

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

Параметрлер (жүктеу-папортал)

Параметрлер Сипаттама
authenticationType
Аутентификация түрі
(SPN үшін міндетті) Пайдаланушы аты/құпиясөз қосылымы үшін PowerPlatformEnvironment немесе қызмет‑субъектісі/клиент құпиясы қосылым үшін PowerPlatformSPN параметрін көрсетіңіз.
PowerPlatformSPN
Power Platform қызмет‑субъектісі
Мазмұнды жүктеп алғыңыз келетін ортаға арналған қызметтің соңғы нүктесі (мысалы, https://powerappsbuildtools.crm.dynamics.com). Power Platform қосылым түрін пайдалану арқылы Жоба параметрлері бөліміндегі Қызмет қосылымдары арқылы анықталады.
WebsiteId
Портал веб-сайтының идентификаторы
Power Pages жүктеп алу үшін веб-сайт идентификаторы.
Overwrite
Мазмұнды қайта жазу
Power Pages қайта жазу үшін веб-сайт мазмұны (шын|жалған).
ModelVersion
Сайт деректерінің үлгісі
Жүктеп салынатын сайт деректері стандартты (1) немесе жақсартылған деректер үлгісін (2) пайдаланатынын көрсетеді. Әдепкі мән - "1".

Power Platform — PAPortal жүктеп салу

Ағымдағы Power Pages ортаға Dataverse веб-сайт мазмұнын жүктеп салыңыз.

YAML үзінді (жүктеп салу-папортал)

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'

Параметрлер (жүктеп салу-папорталдық)

Параметрлер Сипаттама
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
Сұрау түрі
(Міндетті) Сұраныс түрі. (Мәндер: Орнату | Жіберу).

Параметрлер (каталог-күй)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Үрдістер тізбегін құру және шығару

Енді құрастыру құралдарын қолдану арқылы не істеуге болатындығын анықтап алғаннан кейін, осы құралдарды үрдістер тізбегін құру және шығару үшін қалай қолдануға болатындығын көрейік. Концептуалды шолу төменде көрсетілген. Келесі бөлімдерде құрастыру құралын қолдану арқылы үрдістер тізбегін іске асырудың кейбір мәліметтерін қарастырайық.

Бұл үрдістер тізбегін жасау туралы көбірек ақпарат алу және іс жүзінде Microsoft Power Platform Build Tools арқылы үрдістер тізбегін жасау үшін, құрастыру құралдарының зертханаларын құру керек, оны GitHub хабынан жүктеуге болады.

Azure құбыр желілері туралы қосымша ақпарат: Azure құбыр желілерін пайдаланыңыз

Үрдістер тізбегін құру: шешімді әзірлеу ортасынан (DEV) экспорттаңыз

Төмендегі суретте әзірлеу ортасынан шешімді экспорттайтын үрдістер тізбегін қосуға болатын құрастыру құралдарының тапсырмалары көрсетілген.

Шешімді әзірлеу ортасынан (DEV) экспорттау.

Үдерістер тізбегін құру: басқарылатын шешімді құрыңыз

Төмендегі суретте басқарылатын шешімді құрастыратын үрдістер тізбегін қосуға болатын құрастыру құралдарының тапсырмалары көрсетілген.

Басқарылатын шешім құрастырыңыз.

Үдерістер тізбегін шығару: өндірістік ортаға (PROD) орналастырыңыз

Өндіріс ортасына орналастыратын үрдістер тізбегін қосуға болатын құрастыру құралдарының тапсырмалары көрсетілген.

Өндірістік ортаға (PROD) орналастыру.

Сонымен қатар қараңыз

Azure DevOps жүйесіне арналған Microsoft Power Platform құрастыру құралдары