Jagamisviis:

Microsoft Power Platform Build Toolsi ülesanded

  • Artikkel

Saadaolevaid arendusülesanded kirjeldatakse järgmistes jaotistes. Seejärel tutvustame mõnda näidet Azure’i torujuhtmetest, mis neid ülesandeid kasutavad. Lisateavet koostamistööriistade ja nende allalaadimise kohta leiate teemast Microsoft Power Platform Azure’i torujuhtmete jaoks tööriistade koostamine.

Abilise tööülesanne

Saadaolevaid abiülesandeid kirjeldatakse allpool.

Power Platformi tööriista installer

See ülesanne tuleb lisada enne mis tahes muid koostamis- ning väljastuskonveieris olevaid Power Platform Build Toolsi ülesandeid. Selle toiminguga installitakse Power Platformi põhiste tööriistade komplekt, mida agent nõuab Microsoft Power Platformi arendusülesannete käitamiseks. See ülesanne ei vaja lisamisel rohkem konfigureerimist. See ülesanne sisaldab iga installitava tööriista konkreetsete versioonide parameetreid.

Selleks et tööriista versioonid püsiksid ajakohasena veenduge, et need parameetrid vastavad tööriistade versioonidele, mis on vajalikud konveieri õigeks käitamiseks.

YAML lõigendi (Installer)

# 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

Parameetrid (Installer)

Parameetrid Kirjeldus
DefaultVersion
Kasutage tööriistade vaikeversioone		 See on tõene kõigi tööriistade vaikeversiooni kasutamiseks, muul juhul väär. Nõutav (ja väär), kui tööriistaversioonid on määratud.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Tööriista versioon		 Tööriista konkreetne versioon, mida kasutada.

Power Platform WhoAmI

Kontrollib Power Platformi keskkonnateenuse ühendust, luues ühenduse ja esitades WhoAmI taotluse. See ülesanne võib olla kasulik konveierisse varaseks kaasamiseks, et kontrollida ühenduvust enne töötlemise algust.

YAML lõigend (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'

Parameetrid (WhoAmI)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Valikuline) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt keskkonna jaoks, millega luuakse ühendus. Määratletakse jaotise Teenuse ühendused sätetes Projekti sätted. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, millega luuakse ühendus. Määratletakse jaotise Teenuse ühendused sätetes Projekti sätted.

Kvaliteedikontroll

Järgmises osas on saadaval olevad ülesanded lahenduse kvaliteedi kontrollimiseks.

Power Platform Checker

See ülesanne käivitab teie lahenduste staatilise analüüsi kontrolli parimate tavade reeglite kogumi alusel, et tuvastada probleemsed mustrid, mida võite lahenduse loomisel kogemata kasutusele võtta.

YAML lõigend (Kontrollija)

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

Parameetrid (Kontrollija)

Parameetrid Kirjeldus
PowerPlatformSPN
Teenuse ühendus		 (Nõutav) Power Platformi kontrollija kasutamiseks on nõutav ühendus litsentsitud Microsoft Power Platformi keskkonnaga. Teenuse ühendused määratletakse jaotises Projekti sätted, Teenuse ühendused ühenduse tüübi Power Platform abil. Lisateave: vaadake BuildTools.EnvironmentUrl jaotist Power Platform Keskkonna

loomine Märkus: Teenuse põhi- ja kasutajanime/parooli autentimismeetodid on kontrollija ülesande jaoks saadaval. Lisateavet selle ülesandega kasutatavate teenuse subjektide konfigureerimise kohta leiate teemast Teenuse subjekti ühenduste konfigureerimine Power Platform -i keskkondade jaoks.
UseDefaultPACheckerEndpoint
Kasuta Power Platform Kontrollija lõpp-punkti		 Vaikimisi (tõene) kasutab kontrollimisteenuse geograafiline asukoht sama geograafiat kui keskkond, millega ühenduse loote.
CustomPACheckerEndpoint
Kohandatud PAC kontrollija lõpp-punkt		 Nõutav, kui UseDefaultPACheckerEndpoint on väär. Võite määrata mõne muu kasutatava geograafilise asukoha, näiteks https://japan.api.advisor.powerapps.com. Saadaolevate geograafiliste piirkondade loendi leiate teemast Kontrollija API Power Platform kasutamine.
FileLocation
Analüüsitavate failide asukoht		 Nõutav, kui viidatakse failile jagatud juurdepääsu allkirja (SAS) URL-ilt sasUriFile.

märkused: Oluline on viidata eksporditud lahendusefailile, mitte hoidlas olevatele pakendamata lähtefailidele. Analüüsida saab nii hallatava kui ka mittehallatava lahenduse faile.
FilesToAnalyzeSasUri
SAS failid analüüsimiseks		 Nõutav, kui FileLocation on seatud sasUriFile. Sisestage SAS-i URI. Saate lisada mitu SAS URI-d komaga (,) või semikooloniga (;) eraldatud loendi abil.
FilesToAnalyze
Kohalikud failid analüüsimiseks		 Nõutav, kui SAS-faile ei analüüsita. Määrake analüüsitavate ZIP-failide tee ja failinimi. Metamärke saab kasutada. Näiteks sisestage ** \*.zip kõigi kõigis alamkaustades olevate zip-failide jaoks.
FilesToExclude
Kohalikud failid välistamiseks		 Määrake analüüsist välistatud failide nimed. Kui on rohkem kui üks, sisestage koma (,) või semikooloni (;) eraldatud loendisse. See loend võib sisaldada täisnime või ees- või lõpu metamärkidega nime, näiteks *jquery või form.js
RulesToOverride
Alistamise reeglid		 JSON-massiiv, mis sisaldab alistamiseks reegleid ja tasemeid. OverrideLevel'i aktsepteeritud väärtused on: Kriitiline, Kõrge, Keskmine, Madal, Teabetase. Näide: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Reeglistik		 (Nõutav) Määrake, millist reeglikomplekti rakendada. Saadaval on kaks järgmist reeglikomplekti.
  • Lahendusekontroll: see reeglistik on sama, mida käitatakse koostaja Power Apps portaalist.
  • AppSource: laiendatud reeglistik, mida kasutatakse taotluse sertifitseerimiseks enne, kui selle saab avaldada AppSource.
ErrorLevel
Veatase		 Koos veaga määratleb läviväärtuse parameeter lubatud vigade ja hoiatuste tõsiduse. Toetatud läveväärtused on <level>IssueCount, kus tase=Kriitiline, Kõrge, Keskmine, Madal, Teabetase.
ErrorThreshold
Vealävi		 Määratleb määratud taseme tõrgete (>=0) arvu, mille korral saab kontrollija kontrollitavaid lahendusi edastada.
FailOnPowerAppsCheckerAnalysisError
Nurjumine tõrkel		 Kui väärtus on tõene, Power Apps nurjub, kontrollija analüüs tagastatakse väärtusena Nurjunud või FinishedWithErrors.
ArtifactDestinationName
DevOps'i artefakti nimi		 Määrake kontrollija .sarif-failile Azure’i artefaktide nimi.

Lahenduse ülesanded

See toimingute kogum saab automatiseerida lahenduse toiminguid. Selles jaotises allpool kirjeldatud keskkonnaülesanded, mis loovad, kopeerivad või taastavad keskkonna, kirjutavad teenuseühendused vastloodud keskkondadega üle. Need ülesanded võimaldavad teha lahendusülesandeid nõudmisel loodud keskkondade suhtes.

Power Platformi impordi lahendus

Impordib lahenduse sihtkeskkonda.

YAML lõigend (Import)

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

Parameetrid (Import)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, kuhu soovite lahenduse importida (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, kuhu soovite lahenduse importida (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
SolutionInputFile
Lahenduse sisendfail		 (Nõutav) Lahenduse tee ja failinimi .zip sihtkeskkonda importimiseks faili (nt .zip $(Build.ArtifactStagingDirectory)$(SolutionName)).

Märkus. Muutujad võimaldavad teil saada mugavalt peamisi andmeid oma konveieri erinevate osades kohta. Täieliku loendi leiate teemast Eelmääratletud muutujate kasutamine.
HoldingSolution
Importimine hoidmislahendusena		 Varasemat parameetrit (tõene|väär) kasutatakse kui lahendus vajab täiendamist. See parameeter majutab lahendust, Dataverse , kuid ei täienda lahendust enne, kui Rakenda Lahenduse Täiendamise tööülesanne on käitatud.
OverwriteUnmanagedCustomizations
Mittehallatavate kohanduste ülekirjutamine		 Täpsustage, kas mittehallatavad kohandused kirjutatakse üle (tõene|väär).
SkipProductUpdateDependencies
Tootevärskenduse sõltuvuste vahelejätmine		 Määrake, kas tootevärskendustega seotud sõltuvuste täitmine tuleks vahele jätta (tõene|väär).
ConvertToManaged
Teisendage hallatavaks		 Määrake, kas importida hallatav lahendus (tõene|väär).
AsyncOperation
Asünkroonne import		 Kui valitud on (tõene), sooritatakse impordi toiming asünkroonselt. See on soovitatav suuremate lahenduste puhul, kuna muul juhul on selle ülesande ajalõpp automaatselt 4 minuti pärast. Asünkroonse valimine pollib ja ootab, kuni MaxAsyncWaitTime on täis (tõene|väär).
MaxAsyncWaitTime
Maksimaalne ooteaeg		 Asünkroonse toimingu jaoks lubatud maksimaalne ooteaeg minutites; vaikeväärtus on 60 minutit (1h), sama mis Azure DevOps toimingute vaikeväärtus.
PublishWorkflows
Aktiveeri protsessid pärast importimist		 Täpsustage, kas lahenduse mis tahes protsessid (töövood) tuleb pärast importimist aktiveerida (tõene|väär).
UseDeploymentSettingsFile
Juurutussätete faili kasutamine		 Ühenduse viiteid ja keskkonnamuutujate väärtusi saab määrata, kasutades juurutamise seadete faili (tõene|väär).
DeploymentSettingsFile
Juurutussätete fail		 (Nõutav kui UseDeploymentSettingsFile=tõene) Juurutussätete faili tee ja failinimi.

Power Platform Lahendusekomponendi lisamine

Lisab mittehallatavale lahendusele lahendusekomponendi.

YAML lõigend (Lisa)

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

Parameetrid (Lisa)

Parameetrid Kirjeldus
ComponentId
Lahenduse komponendi ID		 Sihtlahendusse lisatava komponendi skeemi nimi või ID.
ComponentType
Power Platformi keskkonna URL		 Väärtus, mis tähistab lisatavat lahendusekomponenti. Komponendiväärtuste täieliku loendi leiate teemast Eelmääratletud komponenditüüpide kasutamine.
SolutionUniqueName
Lahenduse nimi		 Lahenduse kordumatu nimi.
AddRequiredComponents
Kõik teisest lahusest nõutavad komponendid sõltuvad lahuse komponendist		 (Valikuline) Näitab, kas mittehallatavale lahendusele tuleks lisada ka muid lahendusekomponente, mida lisatav lahendusekomponent nõuab.
Environment
Keskkonna URL või ID		 (Valikuline) Sihtkeskkonna keskkonna URL või ID.

Power Platform Rakenda Lahenduse Täiendamine

Täiendab lahendust, mis on imporditud hoidmislahenduseks.

YAML lõigend (Täiendus)

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

Parameetrid (Täiendus)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, kuhu soovite lahenduse täiendada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, kuhu soovite lahenduse täiendada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
SolutionName
Lahenduse nimi		 (Nõutav) Versiooni uuenduse rakendamiseks pakutava lahenduse nimi. Kasutage alati lahenduse Nime, mitte selle Kuvatavat nime.
AsyncOperation
Asünkroonne täiendus		 Kui valitud on (tõene), sooritatakse uuenduse toiming asünkroonse pakett-tööna. Asünkroonse valimine pollib ja ootab, kuni MaxAsyncWaitTime on täis.
MaxAsyncWaitTime
Maksimaalne ooteaeg		 Asünkroonse toimingu jaoks lubatud maksimaalne ooteaeg minutites; vaikeväärtus on 60 minutit (1h), sama mis Azure DevOps toimingute vaikeväärtus.

Märkus.

Muutujad võimaldavad teil saada mugavalt peamisi andmeid oma konveieri erinevate osades kohta. Täieliku loendi leiate teemast Eelmääratletud muutujate kasutamine. Ühenduse viite- ja keskkonna muutujate teabe sihtkeskkonna jaoks saate eelasustada lahenduse importimisel juurutussätete faili abil.

Lisateave. Ühenduse viidete ja keskkonna muutujate eeljuurutused automaatsete juurutuste jaoks

Power Platformi lahenduse eksportimine

Ekspordib lahenduse lähtekeskkonnast.

YAML lõigend (Eksport)

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

Parameetrid (Eksport)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, kuhu soovite lahenduse täiendada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, kuhu soovite lahenduse täiendada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
SolutionName
Lahenduse nimi		 (Nõutav) Eksporditava lahenduse nimi. Kasutage alati lahenduse Nime, mitte selle Kuvatavat nime.
SolutionOutputFile
Lahenduse väljundfail		 (Nõutav) Lähtekeskkonna eksportimiseks solution.zip faili tee ja failinimi (nt $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ).

Märkus. Muutujad võimaldavad teil saada mugavalt peamisi andmeid oma konveieri erinevate osades kohta. Täieliku loendi leiate teemast Eelmääratletud muutujate kasutamine.
AsyncOperation
Asünkroonne eksport		 Kui valitud on (tõene), sooritatakse ekspordi toiming asünkroonse pakett-tööna. Asünkroonse valimine pollib ja ootab, kuni MaxAsyncWaitTime on täis.
MaxAsyncWaitTime
Maksimaalne ooteaeg		 Asünkroonse toimingu jaoks lubatud maksimaalne ooteaeg minutites; vaikeväärtus on 60 minutit (1h), sama mis Azure DevOps toimingute vaikeväärtus.
Managed
Ekspordi hallatuna		 Kui valitud on (tõene), eksportige lahendus hallatava lahendusena; muul juhul eksportige see mittehallava lahendusena.
ExportAutoNumberingSettings
Automaatse nummerdamise seadete eksportimine		 Automaatse nummerdamise seadete eksportimine (tõene|väär).
ExportCalendarSettings
Kalendri seadete eksportimine		 Kalendri seadete eksportimine (tõene|väär).
ExportCustomizationSettings
Kohandamise seadete eksportimine		 Kohandamise seadete eksportimine (tõene|väär).
ExportEmailTrackingSettings
Meili jälgimise seadete eksportimine		 Meili jälgimise seadete eksportimine (tõene|väär).
ExportGeneralSettings
Üldiste seadete eksportimine		 Üldiste seadete eksportimine (tõene|väär).
ExportIsvConfig
ISV konfiguratsiooni eksportimine		 ISV konfiguratsiooni eksportimine (tõene|väär).
ExportMarketingSettings
Turunduse seadete eksportimine		 Turunduse seadete eksportimine (tõene|väär).
ExportOutlookSynchronizationSettings
Outlooki sünkroonimise seadete eksportimine		 Outlooki sünkroonimise seadete eksportimine (tõene|väär).
ExportRelationshipRoles
Seoserollide eksportimine		 Seoserollide eksportimine (tõene|väär).
ExportSales
Müükide eksportimine		 Müükide eksportimine (tõene|väär).

Power Platformi lahtipakitav lahendus

Viib tihendatud lahenduse faili ja pöörab need tagasi mitmesse XML-faili, et neid faile saaks lähtekeskkonna juhtimissüsteemi kaudu hõlpsamalt lugeda ja hallata.

YAML lõigend (Avama)

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

Parameetrid (Avama)

Parameetrid Kirjeldus
SolutionInputFile
Lahenduse sisendfail		 (Nõutav) Lahtipakitava faili solution.zip tee ja failinimi.
SolutionTargetFolder
Lahenduse lahtipakkimise sihtkaust		 (Nõutav) Tee ja sihtkaust, kuhu soovite lahenduse lahti pakkida.
SolutionType
Lahenduse tüüp		 (Nõutav) Lahtipakitava lahenduse tüüp. Suvandite hulka kuuluvad: Mittehallatav (soovitatav), Hallatavja Mõlemad.

Power Platformi pakitav lahendus

Lähtekeskkonna juhtimises esitatud lahendus pakitakse faili solution.zip, mida saab importida teise keskkonda.

YAML lõigend (Pakkima)

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

Parameetrid (Pakkima)

Parameetrid Kirjeldus
SolutionOutputFile
Lahenduse väljundfail		 (Nõutav) Faili solution.zip tee ja failinimi, kuhu lahendust pakkida.
SolutionSourceFolder
Pakitav lahenduse lähtekaust		 (Nõutav) Pakitava lahenduse tee ja lähtekaust.
SolutionType
Lahenduse tüüp		 (Nõutav) Pakitava lahenduse tüüp. Suvandite hulka kuuluvad: Hallatav (soovitatav), Mittehallatavja Mõlemad.

Power Platform Lahenduse Kustutamine

Kustutage lahendus sihtkeskkonnast.

YAML lõigend (Kustutamine)

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'

Parameetrid (Kustutamine)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, mille soovite lahenduse kustutada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, mille soovite lahenduse kustutada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
SolutionName
Lahenduse nimi		 (Nõutud) Kustutatava lahenduse nimi. Kasutage alati lahenduse Nime, mitte selle Kuvatavat nime.

Power Platformi kohanduste avaldamine

Avaldab kõik kohandused keskkonnas.

YAML lõigend (Avalda)

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

Parameetrid (Avalda)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, mille kohandused soovite avaldada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, mille kohandused soovite avaldada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond

Power Platformi lahenduse versiooni määramine

Värskendab lahenduse versiooni.

YAML lõigend (Versioon)

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

Parameetrid (Versioon)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, millele soovite lahenduse versiooni määrata (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, millele soovite lahenduse versiooni määrata (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
SolutionName
Lahenduse nimi		 (Nõutav) Lahenduse nimi, mille versioon määrata. Kasutage alati lahenduse Nime, mitte selle Kuvatavat nime.
SolutionVersionNumber
Lahenduse versiooni number		 (Nõutav) Versiooni number, mille soovite määrata.

Versiooni numbrit saab konveieris hardcoded kasutada, kuid soovitatav on kasutada konveieri Azure DevOps muutujat nagu BuildId. See pakub suvandeid versiooninumbri täpse kuju määratlemiseks vahekaardil "Suvandid", näiteks: $(Aasta:yyyy)-$(Kuu:MM)-$(Päev:dd)-$(rev:r)-3

Seda määratlust saab seejärel kasutada lahenduse seadmise versiooni ülesandes, seadistades atribuudi versiooninumbri: $(Build.BuildId) püsiprogrammeeritud 20200824.0.0.2asemel.

Teise võimalusena määratakse Powershell'i tekstisisese ülesande skripti $(Get-Date -Format yyyy.MM.dd.HHmm) väljundiks tühja muutuja nimega Lahenduse Versioon kirjutamishostiks ("##vso[task.setvariable variable=SolutionVersion;]$version"), Määrake Lahenduse Versioon väärtuseks $(SolutionVersion).

Power Platform Ühendusmuutujate määramine

Määrab BuildTools.* muutujad, et anda kohandatud skriptiülesannetele juurdepääs, et kasutada teenuseühendust ühe tõeallikana.

YAML lõigend (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

Parameetrid (SetConnectionVariables)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, millele soovite ühenduse muutujaid seada. Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
timeoutInMinutes
Ajalõpp		 Määrab maksimaalse aja (minutites), mille jooksul on tööülesanne lubatud käivitada enne, kui server selle tühistab. Nullväärtus näitab lõpmatut ajalõppu.
retryCountOnTaskFailure
Korduskatsete arv ülesande nurjumise korral		 – saate määrata selle ülesande korduskatsete arvu, mis juhtub ülesande nurjumise korral. Ei toetata agentideta ülesannete puhul.
ApplicationId
Sisselogimise rakenduse ID		 (Nõutav kasutajanime/parooli jaoks) Sisselogimiseks kasutatav rakenduse ID (vt lisamärkust allpool).
RedirectUri
Konkreetse rakenduse URI ümbersuunamine		 (Nõutav kasutajanime/parooli jaoks) Suunake määratud rakenduse URI ümber. Vajalik rakenduse ID määramisel (vt lisamärkust allpool).

Märkus.

Kasutajanime/parooli autentimise tüübi kasutamisel on vaja rakenduse ID ja ümbersuunamise uri. See autenditud oauth dokument sisaldab selgitust, miks peate looma rakenduse registreerimise, millega autentida Dataverse. Kui loote ühenduse kasutajanime/parooliga autentimise abil, käitub ühendus rakendusena, millega kasutaja nimel ühendus luuakse Dataverse.

Power Platformi paketi juurutamine

Juurutab paketi keskkonda. Paketi juurutamine ühe lahendusefaili asemel võimaldab teil juurutada mitut lahendust, andmeid ja koodi keskkonda.

YAML lõigend (Kasutusele võtmine)

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

Parameetrid (Kasutusele võtmine)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, kuhu soovite paketi juurutada (nt https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, kuhu soovite paketi juurutada (nt https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi. Lisateavet leiate teemast: vaadake jaotist BuildTools.EnvironmentUrl jaotises Power Platform Loo Keskkond
PackageFile
Paketi fail		 (Nõutav) Paketifaili komplekti (.dll) tee ja faili nimi.
MaxAsyncWaitTime
Maksimaalne ooteaeg		 Asünkroonse toimingu jaoks lubatud maksimaalne ooteaeg minutites; vaikeväärtus on 60 minutit (1h), sama mis Azure DevOps toimingute vaikeväärtus.

Keskkonnahalduse ülesanded

Saate automatiseerida ühise keskkonna elutsükli haldamise (ELM) ülesanded.

Power Platformi keskkonna loomine

Loob uue keskkonna. Uue keskkonna loomine loob automaatselt BuildTools.EnvironmentUrl-i.

Oluline

Kui on seadistatud, kasutatakse BuildTools.EnvironmentUrl-i konveieris järgmiste toimingute jaoks vaiketeenuse ühendusena. Igas selles artiklis kirjeldatud tööülesanne kasutab teenuseühenduse lõpp-punkti ainult juhul, kui BuildTools.EnvironmentUrl pole seadistatud.

Uut keskkonda saab ette valmistada ainult juhul, kui teie litsents või võimsus võimaldavad luua täiendavaid keskkondi. Lisateavet võimsuse vaatamise kohta leiate jaotisest Võimsuse lehe üksikasjad.

YAML lõigend (Loo-env)

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

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

Parameetrid (Loo-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, mille soovite luua (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, mille soovite luua (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
DisplayName
Kuvatav nimi		 (Nõutav) Loodud keskkonna kuvatav nimi.
LocationName
Juurutamise piirkond		 (Nõutav) Piirkond, kuhu keskkond tuleks luua.
EnvironmentSku
Keskkonna tüüp		 (Nõutav) Juurutatava eksemplari tüüp. Suvandid on Liivakast, Produktsioon, Prooviversioon ja SubscriptionBasedTrial.
AppsTemplate
Rakendused		 Keskkonnatüübi puhul, mis ei ole prooviversioon, on toetatud rakendused D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation ja D365_Sales.
CurrencyName
Valuuta		 (Nõutav) Põhivaluuta loodud keskkonna jaoks. Valuutat ei saa pärast keskkonna loomist värskendada.
LanguageName
Keel		 (Nõutav) Baaskeel keskkonnas.
DomainName
Domeeni nimi		 (Nõutav) See on keskkonnale kuuluv string, mis moodustab osa URL-ist. Näiteks keskkond, mille URL on https://powerappsbuildtasks.crm.dynamics.com/, saab domeeninimeks powerappsbuildtasks.

Märkus. Kui sisestate juba kasutusel oleva domeeninime, lisab tööülesanne domeeninimele numbrilise väärtuse, alustades väärtusega 0. Ülaltoodud näite puhul võib URL muutuda järgmiselthttps://powerappsbuildtasks0.crm.dynamics.com/.

Power Platformi keskkonna kustutamine

Kustutab keskkonna.

YAML lõigend (Kustuta-env)

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

Parameetrid (Kustuta-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, mille soovite keskkonna kustutada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, mille soovite keskkonna kustutada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.

Power Platform Kasutaja määramine

Määrake kasutaja määratud turberoll sihtkeskkonda.

YAML lõigend (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

Parameetrid (AssignUser-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, millele soovite kasutajale määrata (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
User
Power Platform kasutajanimi		 Microsoft Entra objekti ID või kasutaja turvanimi, mida sihtkeskkonnale määrata.
Role
Turberoll nimi või ID		 Turberoll kasutajale määratav nimi või ID.
ApplicationUser
Power Platform Rakenduse kasutajanimi		 Määrab, kas sisendkasutaja on rakenduse kasutaja (tõene|väär).

Power Platform Lähtesta keskkond

Lähtestab keskkonna.

YAML lõigend (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'

Parameetrid (Reset-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, mille soovite keskkonna lähtestada (nt https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, mille soovite keskkonna lähtestada (nt https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.

Power Platformi keskkonna varukoopia

Varundab keskkonna.

YAML lõigend (Varukoopia-env)

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

Parameetrid (Varukoopia-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt, mida soovite keskkonda varundada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt, mida soovite keskkonda varundada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
BackupLabel
Varukoopia silt		 (Nõutav) Varukoopiale määratav silt.

Power Platformi keskkonna kopeerimine

Kopeerib keskkonna sihtkeskkonda. Saadaval on kahte tüüpi koopiaid: täielik ja minimaalne. Täielik koopia sisaldab nii andmeid kui ka lahenduse metaandmeid (kohandusi), samas kui minimaalne koopia sisaldab ainult lahenduse metaandmeid, mitte tegelikke andmeid.

YAML lõigend (Kopeeri-env)

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

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

Parameetrid (Kopeeri-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt lähtekeskkonna jaoks, millest soovite kopeerida (nt https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt lähtekeskkonna jaoks, millest soovite kopeerida (nt https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
TargetEnvironmentUrl
Sihtkeskkonna URL		 (Nõutav) Selle sihtrakenduse URL, kuhu soovite kopeerida.
CopyType
Koopia tüüp		 Tehtava koopia tüüp: FullCopy või MinimalCopy
OverrideFriendlyName
Sõbraliku nime tühistamine		 Muutke sihtkeskkonna sõbralik nimi teiseks nimeks (tõene|väär).
FriendlyName
Sõbralik nimi		 Sihtkeskkonna sõbralik nimi.
DisableAdminMode
Administratsiooni režiimi keelamine		 Administraatori režiimi keelamine (tõene|väär).

Power Platform Keskkonna taastamine

Taastab keskkonna määratud varukoopia.

YAML lõigend (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'

Parameetrid (Restore-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformEnvironment
Power Platformi keskkonna URL		 Teenuse lõpp-punkt lähtekeskkonna jaoks, kust soovite taastada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt lähtekeskkonna jaoks, kust soovite taastada (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
RestoreLatestBackup
Uusim varukoopia taastamiseks		 Kas taastada uusim varukoopia või pakkuda funktsiooni RestoreTimeStamp (true|false).
RestoreTimeStamp
Varundamise kuupäevKellaaeg		 Varukoopia kuupäev ja kellaaeg vormingus „kk/pp/aaaa hh:mm“ VÕI stringina „uusim“.
TargetEnvironmentUrl
Sihtkeskkonna URL		 (Nõutav) Selle sihtkeskkonna URL, mille soovite taastada.
FriendlyName
Taastatud keskkonna nimi		 (Valikuline) Taastatud keskkonna nimi.
DisableAdminMode
Administratsiooni režiimi keelamine		 Administraatori režiimi keelamine (tõene|väär).

Ekspordi Dataverse andmed

Eksportige andmed keskkonnast esitatud skeemi abil.

YAML lõigend (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

Parameetrid (exportdata-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, kust soovite andmeid eksportida (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
SchemaFile
Schema XML-faili nimi		 Schema XML-faili nimi. Seda saab luua tööriista Configuration Migration abil.
DataFile
Andmefaili nimi		 Eksporditavate andmete failinimi (zip-fail).
Overwrite
Sisu ülekirjutamine		 Power Pages veebisaidi sisu ülekirjutamiseks (tõene|väär).

Andmete importimine Dataverse

Andmete importimine keskkonda.

YAML lõigend (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'

Parameetrid (importdata-env)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, kuhu soovite andmeid importida (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
DataFile
Andmefaili nimi		 Tihendatud zip-faili nimi) imporditav andmefail või imporditavate data-schema.xml ja data.xml kaust.

Power Pages Juhtimisülesanded

Veebisaidiga töötamise ülesanded Power Pages .

Power Platform PAPortal allalaadimine

Power Pagesi veebisaidisisu allalaadimine praegusest Dataverse’i keskkonnast.

YAML lõigend (allalaadimine-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

Parameetrid (allalaadimine-paportal)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, kust soovite sisu alla laadida (näiteks). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
WebsiteId
Portaali veebisaidi ID		 Power Pages veebisaidi ID allalaadimiseks.
Overwrite
Sisu ülekirjutamine		 Power Pages veebisaidi sisu ülekirjutamiseks (tõene|väär).
ModelVersion
Saidi andmemudel		 Näitab, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2). Vaikeväärtus on "1".

Power Platform PAPortal üleslaadimine

Laadige Power Pages veebisaidi sisu üles praegusesse Dataverse keskkonda.

YAML lõigend (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'

Parameetrid (upload-paportal)

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, kuhu soovite sisu üles laadida (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
UploadPath
Laadige üles sisu tee		 Teekond, Power Pages kust veebisaidi sisu üles laaditakse.
ModelVersion
Saidi andmemudel		 Näitab, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2). Vaikeväärtus on "1".

Tööülesannete kataloog Power Platform (eelvaade)

Need ülesanded teevad toiminguid kataloogi Power Platform vastu ja sisaldavad järgmist.

Märkus.

Praegu on Power Platform kataloogiülesanded eelvaateväljaanne .

Installige kataloogiüksus

Saate kataloogi üksuse installida sihtkeskkonda.

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Teenuse lõpp-punkt keskkonna jaoks, kuhu soovite sisu üles laadida (nt ). https://powerappsbuildtools.crm.dynamics.com Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
Environment
Sihtkeskkonna URL		 (Nõutav) Keskkonna URL, millele see ülesanne on suunatud.
CatalogItemId
Installitav kataloogiüksuse ID		 (Nõutav) Sihtkeskkonda installitav kataloogiüksus.
TargetEnvironmentUrl
Sihtkeskkonna URL		 (Nõutav) Kataloogiüksuse installimise sihtkeskkonna URL (nt "https://YourOrg.crm.dynamics.com").
PollStatus
Kontrollige küsitluse olekut		 (Valikuline) Küsitlus, et kontrollida oma taotluse olekut (tõene|väär).

Parameetrid (kataloog-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

Esita kataloogi kinnitus

Esitage kataloogi kinnitamise taotlus.

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Selle keskkonna teenuse lõpp-punkt, kuhu soovite sisu üles laadida (nt "https://powerappsbuildtools.crm.dynamics.com"). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
Environment
Sihtkeskkonna URL		 (Nõutav) Keskkonna URL, millele see ülesanne on suunatud.
CatalogSubmissionFile
Kataloogi esitamise fail		 (Nõutav) Määrake kataloogiedastusfaili tee ja failinimi.
UsePackageSolutionZipFile
Faili tüüp		 Faili tüüp: pakendi või lahenduse ZIP-fail.
SolutionZipFile
Lahenduse zip-faili nimi		 Määrake lahenduse ZIP-faili tee ja failinimi.
PollStatus
Kontrollige küsitluse olekut		 (Valikuline) Küsitlus, et kontrollida oma taotluse olekut (tõene|väär).

Parameetrid (catalog-submit)

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

Kataloogitaotluse olek

Hankige kataloogi installimis-/esitamistaotluse olek.

Parameetrid Kirjeldus
authenticationType
Autentimise tüüp		 (Nõutud SPN jaoks) Määrake kasutajanime/parooliga ühenduse jaoks PowerPlatformEnvironment või PowerPlatformSPN Teenuse subjekti/kliendi saladusühenduse jaoks.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Selle keskkonna teenuse lõpp-punkt, kuhu soovite sisu üles laadida (nt "https://powerappsbuildtools.crm.dynamics.com"). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
Environment
Sihtkeskkonna URL		 (Nõutav) Keskkonna URL, millele see ülesanne on suunatud.
TrackingId
Jälgimise ID taotlemine		 (Nõutav) Jälgimise ID taotlemine.
RequestType
Taotluse tüüp		 (Nõutav) Reqeust tüüp. (Väärtused: Installi | Esita).

Parameetrid (kataloogi olek)

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

Konveierite loomine ja väljaandmine

Nüüd, kui oleme kindlaks teinud, mida saab arendustööriistade abil teha, vaatame, kuidas rakendada neid vahendeid oma järku ja anda välja konveierid. Allpool on esitatud kontseptuaalne ülevaade. Tutvume mõningate konveieri rakendamise üksikasjadega, kasutades arendustööriista ülesandeid järgnevates alamjaotistes.

Lisateavet selle kohta, kuidas luua neid konveiereid ja kuidas toimub konveierite aktiivne koostamine Microsoft Power Platform Build Toolsi abil, leiate arendustööriistade laboritest, mille saate alla laadida GitHubist.

Lisateave Azure’i torujuhtmete kohta: Azure’i torujuhtmete kasutamine

Konveieri loomine: lahenduse eksportimine arenduskeskkonnast (DEV)

Järgmisel joonisel on kujutatud arendustööriista tööülesandeid, mida võite lisada konveierisse, mis ekspordib lahenduse arenduskeskkonnast.

Lahenduse eksportimine arenduskeskkonnast (DEV).

Konveieri loomine: hallatava lahenduse loomine

Järgmisel joonisel on kujutatud arendustööriista tööülesandeid, mida võite lisada konveierisse, mis loob hallatava lahenduse.

Ehitage hallatav lahendus.

Väljalaske konveier: tootmiskeskkonda (PROD) juurutamine

Järgmisel joonisel on kujutatud arendustööriista tööülesandeid, mida võite lisada konveierisse, mis juurutab arenduskeskkonda.

Juurutamine tootmiskeskkonda (PROD).

Vt ka

Microsoft Power Platform'i loomise tööriistad Azure DevOps'i jaoks