Dalintis per

Gaukite „Microsoft Power Platform“ kūrimo įrankių užduotis

Galimos kūrimo užduotys aprašytos tolesniuose skyriuose. Vėliau pademonstruosime keletą pavyzdžių, kaip "Azure Pipelines" naudoja šias užduotis. Informacijos apie kūrimo įrankius ir kaip juos Microsoft Power Platform atsisiųsti rasite skyriuje "Azure Pipelines" kūrimo įrankiai.

Pagalbinės priemonės užduotis

Toliau aprašomos galimos pagalbinės užduotys.

„Power Platform” įrankio diegimo programa

Šią užduotį reikia įtraukti kartą prieš bet kurią kitą „Power Platform” kūrimo įrankių užduotį srautų kūrime ir išleidime. Ši užduotis įdiegia „Power Platform” rinkinį – specialius įrankius, reikalingus agentui, kad galėtų vykdyti „Microsoft Power Platform” kūrimo užduotis. Įtraukus šią užduotį nereikia daugiau konfigūracijos. Šioje užduotyje yra kiekvieno diegiamo įrankio konkrečių versijų parametrai.

Kad įrankių versijos būtų nuolat atnaujinamos, įsitikinkite, kad šie parametrai atitinka įrankių, reikalingų tinkamam srauto vykdymui, versijas.

YAML fragmentas (Diegimo priemonė)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'

# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

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

Parametrai (Diegimo priemonė)

Parametrai Aprašymas
DefaultVersion
Naudokite numatytąsias įrankių versijas		 Nustatykite kaip teisinga, jei norite naudoti numatytąją visų įrankių versiją, o kitu atveju klaidinga. Būtina (ir klaidinga), kai nurodytos bet kurios įrankių versijos.
AddToolsToPath
Įtraukti įrankius į kelią		 Įtraukia pac cli į PATH aplinkos kintamąjį. Leidžia naudoti pac cli iš scenarijaus užduočių nenustatant kelio rankiniu būdu.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Įrankių versija		 Konkreti naudotina įrankio versija.

„Power Platform” „WhoAmI”

Patikrina „Power Platform” aplinkos aptarnavimo ryšį prijungdama ir sukurdama „WhoAmI” užklausą. Ši užduotis gali būti naudinga įtraukiant anksti į srautą, kad būtų patikrintas ryšys prieš pradedant apdorojimą.

YAML fragmentas („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'

Parametrai („WhoAmI”)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Pasirinktinai) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Aplinkos, į kurią prisijungiama, tarnybos galinis punktas. Konfigūruojamas Paslaugos ryšiai, srityje Projekto parametrai. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Aplinkos, į kurią prisijungiama, tarnybos galinis punktas. Konfigūruojamas Paslaugos ryšiai, srityje Projekto parametrai.

Kokybės patikra

Kitame skyriuje pateikiamos galimos užduotys sprendimo kokybei patikrinti.

„Power Platform” tikrintuvas

Ši užduotis atlieka statinę sprendimų analizę pagal geriausios praktikos taisyklių rinkinį, kad nustatytų probleminius modelius, kuriuos galite netyčia įvesti kurdami sprendimą.

YAML fragmentas (Tikrintojas)

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

Parametrai (Tikrintojas)

Parametrai Aprašymas
PowerPlatformSPN
Paslaugos ryšys		 (Būtinas) A ryšys su licencijuota „Microsoft Power Platform“ aplinka yra būtinas tam, kad būtų galima naudoti „Power Platform“ tikrintuvą. Paslaugos jungtys yra aprašytos Paslaugos jungtys įėjus į Projekto nustatymus ir naudojant „Power Platform“ ryšio tipą. Daugiau informacijos: žiūrėkite BuildTools.EnvironmentUrl dalyje Power Platform Kurti aplinką

Pastaba: Paslaugos vykdytojas ir vartotojo vardo / slaptažodžio autentifikavimo metodai galimi tikrintuvo užduočiai atlikti. Dėl išsamesnės informacijos, kaip sukonfigūruoti kartu su šia užduotimi naudojamus paslaugos principus, žr. Konfigūruoti paslaugos principą jungtims su „Power Platform“ aplinkomis.
UseDefaultPACheckerEndpoint
Naudoti numatytąją „Power Platform” Tikrintojo galinį punktą		 Pagal numatytuosius nustatymus (tiesa) tikrintuvo tarnybos geografinė vieta naudoja tą pačią geografiją kaip ir aplinka, prie kurios jungiatės.
CustomPACheckerEndpoint
Pasirinktinis PAC tikrintojo galinis punktas		 Būtina, kai „UseDefaultPACheckerEndpoint” yra klaidinga. Galite nurodyti kitą geografinę vietovę, kurią norite naudoti, pvz., https://japan.api.advisor.powerapps.com. Galimų geografinių vietovių sąrašo ieškokite Tikrintuvo API Power Platform naudojimas.
FileLocation
Analizuojamų failų vieta		 Būtina nurodant failą iš bendrinamos prieigos parašo (SAS) URL sasUriFile.

Pastaba: svarbu nurodyti eksportuotą sprendimo failą, o ne neišpakuotus šaltinio failus saugykloje. Gali būti analizuojami tiek sutvarkyti, tiek ir nesutvarkyti sprendimų failai.
FilesToAnalyzeSasUri
Analizuotini SAS failai		 Būtina, kai FileLocation nustatyta į sasUriFile. Įveskite SAS URI. Galite pridėti daugiau nei vieną atskirą SAS URI sąrašą panaudoję kablelį (,), arba kabliataškį (;).
FilesToAnalyze
Analizuotini vietiniai failai		 Būtina, kai SAS failai neanalizuojami. Nurodykite tikrintinų .zip failų kelią ir failo pavadinimą. Galima naudoti pakaitos simbolius. Pavyzdžiui, įveskite **\*.zip visiems zip failams visuose poaplankiuose.
FilesToExclude
Nepaisomi vietiniai failai		 Nurodykite failų, kurie nebus įtraukti į analizę, pavadinimus. Jei daugiau nei vienas, pateikite kableliu (,) arba kabliataškiu (;) atskirtu sąrašu. Šiame sąraše gali būti visas failo pavadinimas arba pavadinimas su pakaitos simboliais, esančiais pavadinimo pradžioje arba pabaigoje, pavyzdžiui, *jquery arba form.js
RulesToOverride
Perrašytinos taisyklės		 JSON masyve yra taisyklių ir lygių, kuriuos reikia perrašyti. Priimamos „OverrideLevel” reikšmės yra: Kritinė, Aukšta, Vidutinė, Žema ir Informacinė. Pavyzdys: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"ID":"iv-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Taisyklių rinkinys		 (Būtinas) Nurodykite, kurią nustatytą taisyklę taikyti. Galimi tokie dveji taisyklių rinkiniai:
  • Sprendimų tikrintuvas: šis taisyklių rinkinys yra tas pats, kuris vykdomas iš kūrėjo portalo Power Apps.
  • "Marketplace": išplėstinis taisyklių rinkinys, naudojamas programai sertifikuoti prieš ją publikuojant "Marketplace".
ErrorLevel
Klaidos lygis		 Kartu su klaida slenksčio parametras apibrėžia leidžiamų klaidų ir įspėjimų sunkumą. Palaikomos slenkstinės reikšmės yra <level>IssueCount, kurių lygis = Kritinis, Didelis, Vidutinis, Žemas ir Informacinis.
ErrorThreshold
Klaidų ribinė reikšmė		 Pateikia nurodyto lygio klaidų skaičių (>=0), kurias tikrintojas gali perduoti tikrinamiems sprendimams.
FailOnPowerAppsCheckerAnalysisError
Klaidos nutraukimas		 Kai teisinga, nepavyksta, jei „Power Apps” Tikrintojo analizė grąžinama kaip Nepavyko arba „FinishedWithErrors”.
ArtifactDestinationName
„DevOps” artefaktų pavadinimas		 Nurodykite tikrintuvo .sarif failo "Azure" artefaktų pavadinimą.

Sprendimo užduotys

Šis užduočių rinkinys gali automatizuoti sprendimo veiksmus. Toliau šiame skyriuje aprašytos aplinkos užduotys, kurios kuria, kopijuoja arba atkuria aplinką, perrašo aptarnavimo ryšius su naujai sukurtomis aplinkomis. Šios užduotys leidžia atlikti sprendimo užduotis pagal aplinką, kuri sukuriama pagal poreikį.

„Power Platform” sprendimo importavimas

Importuoja sprendimą į pasirinktą aplinką.

YAML fragmentas (Importavimas)

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

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

Parametrai (Importavimas)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, į kurį norite importuoti sprendimą (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, į kurį norite importuoti sprendimą (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
SolutionInputFile
Sprendimo įvesties failas		 (Būtina) Sprendimo kelias ir failo vardas .zip failą, $(Build.ArtifactStagingDirectory)$(SolutionName) kurį norite importuoti į paskirties aplinką (pvz., .zip).

Pastaba: kintamieji suteikia patogų būdą gauti pagrindinius duomenų bitus į įvairias srauto dalis. Išsamų sąrašą žr. Iš anksto sukonfigūruotų kintamųjų naudojimas.
HoldingSolution
Importuoti kaip įrašymo sprendimą		 Iš anksto nustatytas parametras (tiesa|netiesa) yra naudojamas, kai reikia atnaujinti sprendimą. Šis parametras nuomoja sprendimą „Dataverse”, tačiau neatnaujina sprendimo iki tol, kol nepaleidžiama Taikyti sprendimo atnaujinimą užduotis.
OverwriteUnmanagedCustomizations
Nevaldomųjų tinkinimų perrašymas		 Nurodykite, ar perrašyti nevaldomuosius tinkinimus (tiesa|netiesa).
SkipProductUpdateDependencies
Praleiskite produkto naujinimo priklausomybes		 Nurodykite, ar reikia praleisti priklausomybių, susijusių su produktų naujinimais, vykdymą (tiesa|netiesa).
ConvertToManaged
Konvertuoti į valdomąjį		 Pasenę. Sistema konvertuos nevaldomojo sprendimo komponentus į valdomuosius, kai importuosite valdomąjį sprendimą.
AsyncOperation
Asinchroninis importavimas		 Jei pažymėta ( teisinga), importavimo operacija bus atlikta asinchroniškai. Taip rekomenduojama elgtis su didesniais sprendimai, nes kitu atveju, užduotis automatiškai sustos po 4 minučių. Pažymėjus asinchroninį, bus atliekama apklausa ir laukiama, kol bus pasiekta „MaxAsyncWaitTime” (tiesa|netiesa).
MaxAsyncWaitTime
Maksimali laukimo trukmė		 Maksimali asinchroninės operacijos laukimo trukmė minutėmis; numatytoji reikšmė yra 60 minučių (1 valanda), tokia pati kaip „Azure DevOps” numatyta užduotims.
PublishWorkflows
Suaktyvinkite procesus po importavimo		 Nurodykite, ar po importavimo turi būti suaktyvinti kokie nors sprendimo procesai (darbo eigos) (tiesa|netiesa).
UseDeploymentSettingsFile
Visuotinio diegimo parametrų failo naudojimas		 Ryšio nuorodos ir aplinkos kintamojo reikšmės gali būti nustatytos naudojant visuotinio diegimo parametrų failą (tiesa|netiesa).
DeploymentSettingsFile
Sukurtas visuotinio diegimo parametrų failas		 (Būtina, kai UseDeploymentSettingsFile=teisinga Visuotinio diegimo parametrų failo kelias ir failo vardas).

Power Platform Pridėti tirpalo komponentą

Įtraukia sprendimo komponentą į nevaldomąjį sprendimą.

YAML fragmentas (pridėti)

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

Parametrai (pridėti)

Parametrai Aprašymas
ComponentId
Sprendimo komponento ID		 Komponento, kurį reikia įtraukti į paskirties sprendimą, schemos pavadinimas arba ID.
ComponentType
„Power Platform“ aplinkos URL		 Reikšmė, kuri yra įtraukiamo sprendimo komponentas. Žiūrėkite Naudoti iš anksto nustatytus komponentų tipus , kad gautumėte išsamų komponentų reikšmių sąrašą.
SolutionUniqueName
Sprendimo pavadinimas		 Unikalus sprendimo pavadinimas.
AddRequiredComponents
Visi komponentai, reikalingi iš kito tirpalo, priklausantys nuo tirpalo komponento		 (Pasirinktinai) Nurodo, ar kiti sprendimo komponentai, kurių reikia įtraukiamam sprendimo komponentui, taip pat turėtų būti įtraukti į nevaldomąjį sprendimą.
Environment
Aplinkos URL arba ID		 (Pasirinktinai) Tikslinės aplinkos URL arba ID.

„Power Platform” Taikyti sprendimo naujinimą

Atnaujina sprendimą, importuotą kaip įrašymo sprendimą.

YAML fragmentas (Atnaujinimas)

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

Parametrai (Atnaujinimas)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, į kurį norite atnaujinti sprendimą (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, į kurį norite atnaujinti sprendimą (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
SolutionName
Sprendimo pavadinimas		 (Būtina) Sprendimo, kuriam reikia taikyti atnaujinimą, pavadinimas. Visada naudokite sprendimo Pavadinimą, o ne jo Rodomą pavadinimą.
AsyncOperation
Asinchroninis atnaujinimas		 Jei pažymėta ( teisinga), atnaujinimo operacija bus atlikta kaip asinchroninė paketinė užduotis. Pažymėjus asinchroninį, bus atliekama apklausa ir laukiama, kol bus pasiekta „MaxAsyncWaitTime”.
MaxAsyncWaitTime
Maksimali laukimo trukmė		 Maksimali asinchroninės operacijos laukimo trukmė minutėmis; numatytoji reikšmė yra 60 minučių (1 valanda), tokia pati kaip „Azure DevOps” numatyta užduotims.

Pastaba.

Kintamieji suteikia patogią galimybę gauti pagrindinius duomenų bitus į įvairias jūsų srauto dalis. Išsamų sąrašą žr. Iš anksto sukonfigūruotų kintamųjų naudojimas. Importuodami sprendimą naudodami visuotinio diegimo parametrų failą galite iš anksto įvesti ryšio nuorodos ir aplinkos kintamųjų informaciją, kad būtų naudojama tikslinė aplinka.

Daugiau informacijos: Iš anksto užpildykite prisijungimo nuorodas ir aplinkos kintamuosius automatiniam visuotiniam diegimui

„Power Platform” sprendimo eksportavimas

Eksportuoja sprendimą iš šaltinio aplinkos.

YAML fragmentas (Eksportavimas)

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

Parametrai (Eksportavimas)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, į kurį norite atnaujinti sprendimą (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, į kurį norite atnaujinti sprendimą (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
SolutionName
Sprendimo pavadinimas		 (Privaloma) Eksportuojamo sprendimo pavadinimas. Visada naudokite sprendimo Pavadinimą, o ne jo Rodomą pavadinimą.
SolutionOutputFile
Sprendimo išvesties failas		 (Būtina) solution.zip failo, į kurį eksportuojama šaltinio aplinka, $(Build.ArtifactStagingDirectory)$(SolutionName) kelias ir failo vardas (pvz., .zip ).

Pastaba: kintamieji suteikia patogų būdą gauti pagrindinius duomenų bitus į įvairias srauto dalis. Išsamų sąrašą žr. Iš anksto sukonfigūruotų kintamųjų naudojimas.
AsyncOperation
Asinchroninis eksportavimas		 Jei pažymėta ( teisinga), eksportavimo operacija bus atlikta kaip asinchroninė paketinė užduotis. Pažymėjus asinchroninį, bus atliekama apklausa ir laukiama, kol bus pasiekta „MaxAsyncWaitTime”.
MaxAsyncWaitTime
Maksimali laukimo trukmė		 Maksimali asinchroninės operacijos laukimo trukmė minutėmis; numatytoji reikšmė yra 60 minučių (1 valanda), tokia pati kaip „Azure DevOps” numatyta užduotims.
Managed
Eksportuoti kaip valdomąjį		 Jei pasirinkta ( teisinga), sprendimą eksportuokite kaip valdomąjį sprendimą; kitu atveju jį eksportuokite kaip nevaldomąjį sprendimą.
ExportAutoNumberingSettings
Eksportuoti automatinio numeravimo parametrus		 Eksportuoti automatinio numeravimo parametrus (tiesa|netiesa).
ExportCalendarSettings
Eksportuoti kalendoriaus parametrus		 Eksportuoti kalendoriaus parametrus (tiesa|netiesa).
ExportCustomizationSettings
Eksportuoti tinkinimo parametrus		 Eksportuoti tinkinimo parametrus (tiesa|netiesa).
ExportEmailTrackingSettings
Eksportuoti el. laiškų sekimo parametrus		 Eksportuoti el. pašto sekimo parametrus (tiesa|netiesa).
ExportGeneralSettings
Eksportuoti bendruosius parametrus		 Eksportuoti bendruosius parametrus (tiesa|netiesa).
ExportIsvConfig
Eksportuoti ISV konfigūraciją		 Eksportuoti ISV konfigūraciją (tiesa|netiesa).
ExportMarketingSettings
Eksportuoti rinkodaros parametrus		 Eksportuoti rinkodaros parametrus (tiesa|netiesa).
ExportOutlookSynchronizationSettings
Eksportuoti „Outlook” sinchronizavimo parametrus		 Eksportuoti „Outlook“ sinchronizavimo parametrus (tiesa|netiesa).
ExportRelationshipRoles
Eksportuoti ryšių vaidmenis		 Eksportuoti ryšių vaidmenis (tiesa|netiesa).
ExportSales
Eksportuoti pardavimus		 Eksportuoti pardavimus (tiesa|netiesa).

„Power Platform“ sprendimo išpakavimas

Paima suspaustą sprendimo failą ir išspaudžia jį į daugelį XML failų taip, kad šie failai gali būti paprastai perskaitomi ir valdomi šaltinio kontrolės sistemos.

YAML fragmentas (Išpakuoti)

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

Parametrai (Išpakuoti)

Parametrai Aprašymas
SolutionInputFile
Sprendimo įvesties failas		 (Privaloma) Išpakuojamo sprendimo.zip failo vardas ir kelias.
SolutionTargetFolder
Paskirties aplankas, skirtas sprendimui išpakuoti		 (Būtina) Galutinio aplanko kelias ir pavadinimas, į kurį norite išpakuoti sprendimą.
SolutionType
Sprendimo tipas		 (Būtinas) Norimo išpakuoti sprendimo pavadinimas. Parinktys apima: Nesutvarkytus (rekomenduojamas), Sutvarkytus, irAbu.

„Power Platform“ sprendimo supakavimas

Supakuoja sprendimą rodomą šaltinio valdiklyje į sprendimo.zip failą, kuris gali būti importuojamas į kitą aplinką.

YAML fragmentas (Supakuoti)

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

Parametrai (Supakuoti)

Parametrai Aprašymas
SolutionOutputFile
Sprendimo išvesties failas		 (Būtina) Sprendimo.zip failo pavadinimas ir kelias, į kurį pakuojamas sprendimas.
SolutionSourceFolder
Pakuotino sprendimo šaltinio aplankas		 (Būtina) Sprendimo aplanko šaltinis ir kelias, į kurį pakuojama.
SolutionType
Sprendimo tipas		 (Būtinas) Pakuojamo sprendimo tipas. Parinktys apima: Valdomuosius (rekomenduojama), Nevaldomuosius ir Abu.

„Power Platform” Naikinti sprendimą

Panaikina sprendimą iš paskirties aplinkos.

YAML fragmentas (Naikinimas)

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'

Parametrai (Naikinimas)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kurį norite panaikinti (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kurį norite panaikinti (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
SolutionName
Sprendimo pavadinimas		 (Privaloma) Naikinamo sprendimo pavadinimas. Visada naudokite sprendimo Pavadinimą, o ne jo Rodomą pavadinimą.

„Power Platform” tinkinimų publikavimas

Publikuoja visus tinkinimus aplinkoje.

YAML fragmentas (Publikuoti)

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

Parametrai (Publikuoti)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kuriame norite publikuoti tinkinimus (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kuriame norite publikuoti tinkinimus (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas

„Power Platform“ sprendimo versijos nustatymas

Atnaujina sprendimo versiją.

YAML fragmentas (Versija)

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

Parametrai (Versija)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kuriam norite nustatyti sprendimo versiją (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kuriam norite nustatyti sprendimo versiją (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
SolutionName
Sprendimo pavadinimas		 (Būtina) Sprendimo, kuriam reikia nustatyti versiją, pavadinimas. Visada naudokite sprendimo Pavadinimą, o ne jo Rodomą pavadinimą.
SolutionVersionNumber
Sprendimo Versijos numeris		 (Būtinas) Jūsų norimas nustatyti versijos skaičius.

Nors versijos numerį galima užkoduoti srauto, rekomenduojama naudoti srauto kintamąjį, pvz., „Azure DevOps“ tokią kaip BuildId. Jame pateikiamos parinktys tiksliai versijos numerio formai skirtuke Parinktys apibrėžti, pavyzdžiui: „$(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3”

Ši sąvoka gali būti naudojama „Set Solution Version“ užduotyje pagal nustatymus „Version Number“ ypatybes su: $(Build.BuildId) vietoje stipraus kodavimo 20200824.0.0.2.

Kitu atveju, „powershell” įdėtosios eilutės scenarijaus $(„Get-Date -Format yyyy.MM.dd.HHmm”) išvestis, nustatyta į tuščią kintamąjį, pavadinimu „SolutionVersion” kaip „Write-Host” ("##vso[task.setvariable variable=SolutionVersion;]$version"), nustatykite Sprendimo versiją kaip „$(SolutionVersion)”.

Power Platform Ryšio kintamųjų nustatymas

Nustato PowerPlatformSetConnectionVariables.BuildTools.* kintamuosius, kad pasirinktinės scenarijaus užduotys galėtų naudoti tarnybos ryšį kaip vieną tiesos šaltinį.

Nustatomi šie kintamieji:

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

YAML fragmentas (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

Parametrai (SetConnectionVariables)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kurio ryšio kintamuosius norite nustatyti. Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
timeoutInMinutes
Skirtasis laikas		 Nurodo maksimalų laiką minutėmis, kurį leidžiama vykdyti užduotį prieš ją atšaukiant serveryje. Nulinė reikšmė rodo begalinį skirtąjį laiką.
retryCountOnTaskFailure
Pakartotinių bandymų skaičius, jei užduotis nepavyko		 Nurodo šios užduoties pakartotinių bandymų, kurie įvyks užduoties gedimo atveju, skaičių. Nepalaikoma atliekant užduotis be agentų.
ApplicationId
Programos ID prisijungimui		 (Būtina vartotojo vardui / slaptažodžiui) Programos ID, kurį reikia naudoti prisijungiant (žr. papildomą pastabą toliau).
RedirectUri
Peradresuoti konkrečios programos URI		 (Būtina vartotojo vardui / slaptažodžiui) Peradresuokite nurodytos programos URI. Reikalinga nurodant programos ID (žr. toliau pateiktą papildomą pastabą).

Pastaba.

Naudojant vartotojo vardo / slaptažodžio autentifikavimo tipą, reikės programos ID ir peradresavimo uri. Šiame autentifikavimo dokumente yra paaiškinimas, kodėl jums reikia sukurti programos registraciją, kad galėtumėte autentifikuotis Dataverse. Kai prisijungiate naudodami vartotojo vardo / slaptažodžio autentifikavimą, ryšys veikia kaip programa, kuri jungiasi vartotojo vardu Dataverse.

„Power Platform” visuotinio diegimo paketas

Įdiegia paketą aplinkoje. Paketo diegimas, skirtingai nei vienas sprendimo failas, suteikia galimybę aplinkoje padėti daugelį sprendimų, duomenų ir kodą.

YAML fragmentas (Visuotinis diegimas)

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

Parametrai (Visuotinis diegimas)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kuriame norite visuotinai diegti paketą (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kuriame norite visuotinai diegti paketą (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą. Daugiau informacijos: skaitykite „BuildTools.EnvironmentUrl” dalyje „Power Platform” Aplinkos kūrimas
PackageFile
Supakuotas failas		 (Būtina) Paketo failų rinkinio (.dll) kelias ir failo vardas.
MaxAsyncWaitTime
Maksimali laukimo trukmė		 Maksimali asinchroninės operacijos laukimo trukmė minutėmis; numatytoji reikšmė yra 60 minučių (1 valanda), tokia pati kaip „Azure DevOps” numatyta užduotims.

Aplinkos valdymo užduotys

Įprastų aplinkos ciklo valdymo (ELM) užduočių automatizavimas.

„Power Platform“ aplinkos kūrimas

Sukuriama nauja aplinka. Sukūrus naują aplinką taip pat automatiškai sukuriama „BuildTools.EnvironmentUrl”.

Svarbu

Nustatytas „BuildTools.EnvironmentUrl” bus naudojamas kaip numatytasis aptarnavimo ryšys tolesnėse srauto užduotyse. Kiekviena šiame straipsnyje aprašyta užduotis naudoja galinį punktą iš aptarnavimo ryšio, kai „BuildTools.EnvironmentUrl” nėra nustatyta.

Naują aplinką galima parengti tik tuo atveju, jei jūsų licencija arba pajėgumas leidžia kurti papildomas aplinkas. Daugiau informacijos apie tai, kaip peržiūrėti pajėgumą, žr. Pajėgumo puslapio informacija.

YAML fragmentas („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

Parametrai („Create-env”)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kurį norite sukurti aplinkoje (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kurį norite sukurti aplinkoje (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
DisplayName
Rodomas vardas		 (Būtina) Rodomas sukurtos aplinkos pavadinimas.
LocationName
Visuotinio diegimo Regionas		 (Būtina) Regionas, kuriame turi būti sukurta aplinka.
EnvironmentSku
Aplinkos tipas		 (Būtina) Diegiamo egzemplioriaus tipas. Parinktys yra Smėlio dėžės, Gamybos, Bandomosios aplinkos ir „SubscriptionBasedTrial”.
AppsTemplate
Programėlės		 Ne bandomosios versijos aplinkos tipui palaikomos programos yra „D365_CustomerService”, „D365_FieldService”, „D365_ProjectServiceAutomation” ir „D365_Sales”.
CurrencyName
Valiuta		 (Būtina) Kuriamos aplinkos bazinė valiuta. Sukūrus aplinką valiutos atnaujinti negalima.
LanguageName
Kalba		 (Būtina) Pagrindinė aplinkos kalba.
DomainName
Domeno vardas		 (Būtina) Tai yra konkrečią aplinką atitinkanti eilutė, kuri yra URL dalis. Pavyzdžiui, aplinkai su tolesniu URL: https://powerappsbuildtasks.crm.dynamics.com/, domeno pavadinimas bus 'powerappsbuildtasks'.

Pastaba: jei įvesite jau naudojamą domeno vardą, užduotis prie domeno vardo prideda skaitinę reikšmę, pradedant nuo 0. Pirmiau pateiktame pavyzdyje URL gali taptihttps://powerappsbuildtasks0.crm.dynamics.com/.

„Power Platform” aplinkos naikinimas

Naikinama aplinka.

YAML fragmentas („Delete-env”)

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

Parametrai („Delete-env”)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kurį norite panaikinti (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kurį norite panaikinti (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.

Power Platform Priskirti vartotoją

Priskirkite vartotoją paskirties aplinkai su nurodytu saugos vaidmeniu.

YAML fragmentas (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

Parametrai (AssignUser-env)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas aplinkai, kuriai norite priskirti vartotoją (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
User
Power Platform vartotojo vardas		 Microsoft Entra objekto ID arba vartotojo pagrindinis vardas, kurį reikia priskirti paskirties aplinkai.
Role
Saugos vaidmens pavadinimas arba ID		 Saugos vaidmens pavadinimas arba ID, kuris turi būti priskirtas vartotojui.
ApplicationUser
Power Platform programos vartotojo vardas		 Nurodo, ar įvesties vartotojas yra programos vartotojas (true|false).

Power Platform Iš naujo nustatyti aplinką

Iš naujo nustato aplinką.

YAML fragmentas (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'

Parametrai (Reset-env)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kurį norite iš naujo nustatyti aplinkai (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kurį norite iš naujo nustatyti aplinkai (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.

„Power Platform“ aplinkos atsarginė kopija

Sukuriama aplinkos atsarginė kopija.

YAML fragmentas („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)'

Parametrai („Backup-env”)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, kurio atsarginę aplinkos kopiją norite sukurti (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, kurio atsarginę aplinkos kopiją norite sukurti (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
BackupLabel
Atsarginės kopijos žyma		 (Būtinas) Lentelė priskirtina prie atsarginės kopijos.

„Power Platform” kopijavimo aplinka

Aplinka kopijuojama į paskirties aplinką. Galimi du kopijų tipai: pilna ir minimali. Pilna kopija apima duomenis ir sprendimo metaduomenis (tinkinimus), o minimali kopija apima tik sprendimo metaduomenis, bet ne faktinius duomenis.

YAML fragmentas („Copy-env”)

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

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

Parametrai („Copy-env”)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Tarnybos galinis punktas, skirtas šaltinio aplinkai, iš kurios norite kopijuoti (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas, skirtas šaltinio aplinkai, iš kurios norite kopijuoti (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
TargetEnvironmentUrl
Tikslinės aplinkos URL		 (Būtinas) URL tikslinei aplinka, į kurią norite kopijuoti.
CopyType
Kopijos tipas		 Atliekamos kopijos tipas: „FullCopy” arba „MinimalCopy”
OverrideFriendlyName
Draugiško pavadinimo perrašymas		 Pakeisti paskirties aplinkos draugišką pavadinimą į kitą (tiesa|netiesa).
FriendlyName
Paprastas pavadinimas		 Paskirties aplinkos draugiškas pavadinimas.
SkipAuditData
SkipAuditData		 Ar praleisti audito duomenis kopijavimo operacijos metu. (tiesa|klaidinga).
MaxAsyncWaitTime
Maksimali laukimo trukmė		 Maksimali asinchroninės operacijos laukimo trukmė minutėmis; numatytoji reikšmė yra 60 minučių (1 valanda), tokia pati kaip „Azure DevOps” numatyta užduotims.

Power Platform Atkurti aplinką

Aplinka atkuriama pagal pateiktą atsarginę kopiją.

YAML fragmentas (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'

Parametrai (Restore-env)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformEnvironment
„Power Platform“ aplinkos URL		 Šaltinio aplinkos, iš kurios norite atkurti, tarnybos galinis punktas (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Šaltinio aplinkos, iš kurios norite atkurti, tarnybos galinis punktas (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
RestoreLatestBackup
Naujausia atsarginė kopija, skirta atkurti		 Ar atkurti naujausią atsarginę kopiją, ar pateikti RestoreTimeStamp (true|false).
RestoreTimeStamp
Atsarginės kopijos kūrimo data		 Atsarginės kopijos data ir laikas MMMM-mm-dd val:min formatu ARBA eilutė „naujausia“.
TargetEnvironmentUrl
Tikslinės aplinkos URL		 (Būtina) Paskirties aplinkos, kurią norite atkurti, URL.
FriendlyName
Atkurtos aplinkos pavadinimas		 (Pasirinktinai) Atkurtos aplinkos pavadinimas.
DisableAdminMode
Išjungti administravimo režimą		 Ar išjungti administravimo režimą (tiesa|netiesa).

Duomenų eksportavimas Dataverse

Eksportuokite duomenis iš aplinkos su pateikta schema.

YAML fragmentas (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

Parametrai (exportdata-env)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Aplinkos, iš kurios norite eksportuoti duomenis, tarnybos galinis punktas (pvz., https://powerappsbuildtools.crm.dynamics.com). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
SchemaFile
Schemos XML failo vardas		 Schemos XML failo vardas. Jį galima sukurti naudojant konfigūracijos perkėlimo įrankį.
DataFile
Duomenų failo pavadinimas		 Eksportuotinų duomenų failo vardas (zip failas).
Overwrite
Turinio perrašymas		 Power Pages svetainės turinį, kurį reikia perrašyti (true|false).

Duomenų importavimas Dataverse

Importuokite duomenis į aplinką.

YAML fragmentas (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'

Parametrai (importdata-env)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Aplinkos, į kurią norite importuoti duomenis, tarnybos galinis punktas (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
DataFile
Duomenų failo pavadinimas		 Suglaudinto ZIP) duomenų failo, kurį norite importuoti, arba aplanko su importuotinais data-schema.xml ir data.xml failo vardas.

Power Pages Valdymo užduotys

Darbo su Power Pages svetaine užduotys.

„Power Platform“ Atsisiųsti „PAPortal“

Atsisiųsti „Power Pages“ svetainės turinį iš dabartinės „Dataverse“ aplinkos.

YAML fragmentas (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

Parametrai (download-paportal)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Tarnybos galinis punktas aplinkai, iš kurios norite atsisiųsti turinį (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
WebsiteId
Portalo svetainės ID		 Power Pages svetainės ID, kurį norite atsisiųsti.
Overwrite
Turinio perrašymas		 Power Pages svetainės turinį, kurį reikia perrašyti (true|false).
ModelVersion
Svetainės duomenų modelis		 Nurodo, ar svetainės duomenys, kuriuos reikia įkelti, naudos standartinį (1) ar patobulintą duomenų modelį (2). Numatytoji reikšmė yra "1".

„Power Platform“ Įkelti „PAPortal“

Įkelkite Power Pages svetainės turinį į dabartinę Dataverse aplinką.

YAML fragmentas (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'

Parametrai (upload-paportal)

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Paslaugos galinis punktas aplinkai, į kurią norite įkelti turinį (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
UploadPath
Įkelti turinio kelią		 Kelias, Power Pages iš kurio bus įkeltas svetainės turinys.
ModelVersion
Svetainės duomenų modelis		 Nurodo, ar svetainės duomenys, kuriuos reikia įkelti, naudos standartinį (1) ar patobulintą duomenų modelį (2). Numatytoji reikšmė yra "1".

Užduočių katalogas Power Platform (peržiūra)

Šios užduotys atlieka veiksmus su katalogu, esančiu kataloge Power Platform , ir apima toliau nurodytus dalykus.

Pastaba.

Šiuo metu katalogo užduotys Power Platform yra išankstinė versija.

Įdiegti katalogo elementą

Įdiekite katalogo elementą tikslinėje aplinkoje.

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Paslaugos galinis punktas aplinkai, į kurią norite įkelti turinį (pvz., https://powerappsbuildtools.crm.dynamics.com Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
Environment
Tikslinės aplinkos URL		 (Privaloma) Aplinkos URL, į kurį nukreipta ši užduotis.
CatalogItemId
Įdiegiamo katalogo elemento ID		 (Privaloma) Katalogo elementas, kuris bus įdiegtas paskirties aplinkoje.
TargetEnvironmentUrl
Tikslinės aplinkos URL		 (Privaloma) Paskirties aplinkos, kurioje diegiamas katalogo elementas, URL (pvz., „https://YourOrg.crm.dynamics.com“).
PollStatus
Patikrinkite apklausos būseną		 (Nebūtina) Apklausa, skirta jūsų užklausos būsenai patikrinti (teisinga | klaidinga).

Parametrai (catalog-install)

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

Pateikti katalogo patvirtinimą

Pateikite katalogo patvirtinimo užklausą.

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Aplinkos, į kurią norite įkelti turinį, paslaugos galinis punktas (pvz., „https://powerappsbuildtools.crm.dynamics.com“). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
Environment
Tikslinės aplinkos URL		 (Privaloma) Aplinkos URL, į kurį nukreipta ši užduotis.
CatalogSubmissionFile
Katalogo pateikimo failas		 (Privaloma) Nurodykite katalogo pateikimo failo kelią ir pavadinimą.
UsePackageSolutionZipFile
Failo tipas		 Failo tipas: paketas arba sprendimo ZIP failas.
SolutionZipFile
Sprendimo ZIP failo pavadinimas		 Nurodykite sprendimo ZIP failo kelią ir failo pavadinimą.
PollStatus
Patikrinkite apklausos būseną		 (Nebūtina) Apklausa, skirta jūsų užklausos būsenai patikrinti (teisinga | klaidinga).

Parametrai (katalogo pateikimas)

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

Katalogo užklausos būsena

Gaukite katalogo diegimo / pateikimo užklausos būseną.

Parametrai Aprašymas
authenticationType
Autentifikavimo Tipas		 (Būtina SPN) Nurodykite „PowerPlatformEnvironment” vartotojo vardo/slaptažodžio ryšiui arba „PowerPlatformSPN” Pagrindinei tarnybai/kliento slaptojo rakto ryšiui.
PowerPlatformSPN
„Power Platform” Pagrindinė tarnyba		 Aplinkos, į kurią norite įkelti turinį, paslaugos galinis punktas (pvz., „https://powerappsbuildtools.crm.dynamics.com“). Apibrėžta Tarnybos ryšių dalyje Aptarnavimo parametrai naudojant „Power Platform” jungties tipą.
Environment
Tikslinės aplinkos URL		 (Privaloma) Aplinkos URL, į kurį nukreipta ši užduotis.
TrackingId
Užklausos stebėjimo ID		 (Privaloma) Pateikite užklausos sekimo ID.
RequestType
Užklausos tipas		 (Privaloma) Užklausos tipas. (Reikšmės: Įdiegti | Pateikti).

Parametrai (katalogo būsena)

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

Kūrimo ir leidimo srautai

Dabar, kai nustatėme, kas gali būti atlikta naudojant kūrimo įrankius, pažiūrėkime, kaip pritaikyti šiuos įrankius kūrimo ir leidimo srautams. Toliau pateikiama konceptuali apžvalga. Peržiūrėkite kai kurią srauto diegimo informaciją naudojant kūrimo priemonių užduotis kituose poskyriuose.

Tam, kad sužinotumėte apie šių srautų kūrimą ir realių srautų autorizavimą naudojant „Microsoft Power Platform“ „Build Tools“, pabaikite kūrimo įrankių bandymus, kuriuos galite atsisiųsti iš „GitHub“.

Daugiau informacijos apie „Azure Pipelines“: Naudokite „Azure Pipelines“

Srauto kūrimas: sprendimo eksportavimas iš programavimo aplinkos (DEV)

Toliau pateiktame paveiksle nurodytos kūrimo įrankių užduotys, kurias galite pridėti prie srauto, eksportuojančio sprendimą iš programavimo aplinkos.

Eksportuoti sprendimą iš kūrimo aplinkos (DEV).

Srauto kūrimas: valdomojo sprendimo kūrimas

Toliau pateiktame paveiksle nurodytos kūrimo įrankių užduotys, kurias galite pridėti prie srauto, kuriančio valdomąjį sprendimą.

Sukurkite valdomą sprendimą.

Leidimo srautas: visuotinis diegimas gamybos aplinkoje (PROD)

Toliau pateiktame paveiksle nurodytos kūrimo įrankių užduotys, kurias galite pridėti prie srauto, diegiančio gamybos aplinkoje.

Diegimas gamybinėje aplinkoje (PROD).

Taip pat žr.

Microsoft Power Platform Sukurkite įrankius, skirtus Azure DevOps

  • Last updated on