Jagamisviis:

Microsoft Power Platform Build Toolsi ülesanded

Saadaolevaid arendusülesanded kirjeldatakse järgmistes jaotistes. Seejärel tutvustame mõningaid näiteid Azure’i torujuhtmetest, mis neid ülesandeid kasutavad. Lisateavet ehitustööriistade ja nende allalaadimise kohta leiate jaotisest Microsoft Power Platform Azure’i torujuhtmete ehitustööriistad.

Abilise tööülesanne

Järgnevalt kirjeldatakse saadaolevaid abilise ülesandeid.

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 täiendavat konfigureerimist. See ülesanne sisaldab parameetreid iga installitava tööriista konkreetse versiooni jaoks.

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@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

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.
AddToolsToPath
Tööriistade lisamine teele		 Lisab pac cli keskkonnamuutujale PATH . Võimaldab kasutada skriptiülesannete pac cli-d, ilma et peaksite teed käsitsi seadistama.
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@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'

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 toodud lahenduse kvaliteedi kontrollimiseks saadaolevad ülesanded.

Power Platformi kontrollija

See ülesanne käivitab teie lahenduste staatilise analüüsi parimate tavade reeglite alusel, et tuvastada probleemseid mustreid, mida võisite lahenduse loomisel kogemata tekitada.

YAML lõigend (Kontrollija)

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

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. Lisateavet leiate jaotisest BuildTools.EnvironmentUrl Keskkonna loomine Power Platform Märkus. Kontrollija ülesande jaoks on saadaval teenuse printsiibi ja kasutajanime/parooli autentimismeetodid.

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 (true) kasutab kontrolliteenuse geograafiline asukoht sama geograafilist asukohta kui keskkond, millega ühendute.
CustomPACheckerEndpoint
Kohandatud PAC kontrollija lõpp-punkt		 Nõutav, kui UseDefaultPACheckerEndpoint on väär. Võite määrata kasutamiseks mõne muu geograafilise asukoha, näiteks https://japan.api.advisor.powerapps.com. Saadaolevate geograafiliste asukohtade loendi leiate jaotisest Kasutage Power Platform Checker API-t.
FileLocation
Analüüsitavate failide asukoht		 Nõutav jagatud juurdepääsuga allkirja (SAS) URL-ilt failile viitamisel. sasUriFile.

Märkus. Oluline on viidata eksporditud lahendusfailile, mitte hoidlas olevatele lahtipakkitud lähtekoodifailidele. 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 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.
  • Lahenduste kontrollija: See reeglistik on sama, mida käivitatakse Power Apps tegijate portaalist.
  • Marketplace: Laiendatud reeglistik, mida kasutatakse rakenduse sertifitseerimiseks enne selle avaldamist Marketplace'is.
ErrorLevel
Veatase		 Koos veaparameetriga määrab läviväärtus 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-faili Azure’i artefaktide nimi.

Lahenduse ülesanded

See toimingute kogum saab automatiseerida lahenduse toiminguid. Selles jaotises hiljem kirjeldatud keskkonnaülesanded, mis loovad, kopeerivad või taastavad keskkonda, kirjutavad üle teenuseühendused äsja loodud keskkondadega. Need ülesanded võimaldavad teostada lahendusülesandeid nõudmisel loodud keskkondades.

Power Platformi impordi lahendus

Impordib lahenduse sihtkeskkonda.

YAML lõigend (Import)

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

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 (näiteks 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 (näiteks 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) Sihtkeskkonda imporditava lahenduse .zip-faili tee ja failinimi (näiteks .zip). $(Build.ArtifactStagingDirectory)$(SolutionName)

Märkus. Muutujad pakuvad mugavat viisi oluliste andmete hankimiseks oma torujuhtme erinevatesse osadesse. 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		 Vananenud. Hallatava lahenduse importimisel teisendab süsteem mittehallatavad lahenduse komponendid hallatavateks.
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 Lisa lahenduse komponent

Lisab lahenduse komponendi mittehallatavale lahendusele.

YAML-koodilõik (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 lahenduse komponenti. Komponentide väärtuste põhjaliku loendi leiate jaotisest Kasuta eelnevalt määratletud komponentide tüüpe .
SolutionUniqueName
Lahenduse nimi		 Lahenduse unikaalne nimi.
AddRequiredComponents
Lahenduse komponendist sõltuvad muud lahenduse komponendid		 (Valikuline) Näitab, kas haldamata lahendusele tuleks lisada ka teisi lahenduse komponente, mida lisatav lahenduse komponent vajab.
Environment
Keskkonna URL või ID		 (Valikuline) Sihtkeskkonna 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@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

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, milleks soovite lahenduse uuendada (näiteks 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, milleks soovite lahenduse uuendada (näiteks 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@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

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, milleks soovite lahenduse uuendada (näiteks 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, milleks soovite lahenduse uuendada (näiteks 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 mõeldud solution.zip-faili tee ja failinimi (näiteks $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Märkus. Muutujad pakuvad mugavat viisi oluliste andmete hankimiseks oma torujuhtme erinevatesse osadesse. 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@2
  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@2
  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@2
  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, kust soovite lahenduse kustutada (näiteks 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, kust soovite lahenduse kustutada (näiteks 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@2
  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, kus soovite kohandused avaldada (näiteks 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, kus soovite kohandused avaldada (näiteks 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@2
  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 (näiteks 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 (näiteks 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 Määra ühenduse muutujad

Määrab PowerPlatformSetConnectionVariables.BuildTools.* muutujad, et pakkuda kohandatud skriptiülesannetele juurdepääsu teenuseühenduse kasutamiseks ühe tõeallikana.

Määratakse järgmised muutujad:

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

YAML-koodilõik (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 määrata. 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 minutites maksimaalse aja, mille jooksul ülesanne võib enne serveri poolt tühistamist käivituda. Nullväärtus näitab lõpmatut ajalõppu.
retryCountOnTaskFailure
Uuesti proovimiste arv ülesande ebaõnnestumise korral		 Määrab selle ülesande uuesti proovimiste arvu, mis tehakse ülesande nurjumise korral. Agendita ülesannete puhul ei toetata.
ApplicationId
Rakenduse ID sisselogimiseks		 (Kasutajanime/parooli puhul nõutav) Sisselogimiseks kasutatav rakenduse ID (vt lisamärkust allpool).
RedirectUri
Määratud rakenduse ümbersuunamise URI		 (Kasutajanime/parooli puhul nõutav) Määratud rakenduse ümbersuunamise URI. Vajalik rakenduse ID määramisel. (Vt lisamärkust allpool).

Märkus.

Kasutajanime/parooli autentimistüübi kasutamisel on nõutavad rakenduse ID ja ümbersuunamise Uri. See oautentimise dokument selgitab, miks peate autentimiseks looma rakenduse registreeringu Dataverse. Kui loote ühenduse kasutajanime/parooliga autentimise abil, käitub ühendus rakendusena, mis loob ühenduse kasutaja nimel 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@2
  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 (näiteks 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 (näiteks 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.

Uue keskkonna saab luua ainult siis, kui teie litsents või võimsus lubab täiendavate keskkondade loomist. 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@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

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 jaoks soovite keskkonda luua (näiteks 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 jaoks soovite keskkonda luua (näiteks 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 domeeninime, mis on juba kasutusel, lisab ülesanne domeeninimele numbrilise väärtuse, alustades nullist. Ü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@2
  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 keskkonda soovite kustutada (näiteks 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 keskkonda soovite kustutada (näiteks 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 sihtkeskkonda kindla turberolliga.

YAML-koodijupp (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		 Selle keskkonna teenuse lõpp-punkt, kuhu soovite kasutaja määrata (näiteks 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 põhinimi, mis sihtkeskkonnale määrata.
Role
Turberolli nimi või ID		 Kasutajale määratav turberolli nimi või ID.
ApplicationUser
Power Platform rakenduse kasutajanimi		 Määrab, kas sisendkasutaja on rakenduse kasutaja (true|false).

Power Platform Lähtesta keskkond

Lähtestab keskkonna.

YAML-koodijupp (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 keskkonda soovite lähtestada (näiteks 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 keskkonda soovite lähtestada (näiteks 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@2
  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, mille keskkonda soovite varundada (näiteks 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 keskkonda soovite varundada (näiteks 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@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

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		 Lähtekeskkonna teenuse lõpp-punkt, kust soovite kopeerida (näiteks https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Lähtekeskkonna teenuse lõpp-punkt, kust soovite kopeerida (näiteks 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.
SkipAuditData
SkipAuditData		 Kas kopeerimistoimingu ajal jäetakse auditeerimisandmed vahele. (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.

Power Platform Taasta keskkond

Taastab keskkonna määratud varukoopia.

YAML-koodijupp (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		 Lähtekeskkonna teenuse lõpp-punkt, millest soovite taastada (näiteks https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
PowerPlatformSPN
Power Platform Teenuse Subjekt		 Lähtekeskkonna teenuse lõpp-punkt, millest soovite taastada (näiteks https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
RestoreLatestBackup
Viimane taastatav varukoopia		 Kas taastada viimane varukoopia või esitada RestoreTimeStamp (true|false).
RestoreTimeStamp
Varunduse kuupäev ja kellaaeg		 Varukoopia kuupäev ja kellaaeg vormingus „kk/pp/aaaa hh:mm“ VÕI stringina „uusim“.
TargetEnvironmentUrl
Sihtkeskkonna URL		 (Nõutav) Sihtkeskkonna URL, mida soovite taastada.
FriendlyName
Taastatud keskkonna nimi		 (Valikuline) Taastatud keskkonna nimi.
DisableAdminMode
Administratsiooni režiimi keelamine		 Administraatori režiimi keelamine (tõene|väär).

Ekspordi andmed Dataverse

Ekspordi andmed keskkonnast antud skeemi abil.

YAML-koodijupp (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		 Selle keskkonna teenuse lõpp-punkt, kust soovite andmeid eksportida (näiteks https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
SchemaFile
Skeemi XML-faili nimi		 Skeemi XML-faili nimi. Selle saab luua konfiguratsiooni migreerimise tööriista abil.
DataFile
Andmefaili nimi		 Eksporditavate andmete failinimi (zip-fail).
Overwrite
Sisu ülekirjutamine		 Power Pages veebisaidi sisu ülekirjutamiseks (true|false).

Andmete importimine Dataverse

Andmete importimine keskkonda.

YAML-koodijupp (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		 Selle keskkonna teenuse lõpp-punkt, kuhu soovite andmeid importida (näiteks https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
DataFile
Andmefaili nimi		 Imporditava tihendatud zip-andmefaili failinimi või imporditava data-schema.xml ja data.xml failidega kaust.

Power Pages juhtimisülesanded

Veebisaidiga töötamise ülesanded. Power Pages

Power Platform PAPortal allalaadimine

Power Pagesi veebisaidisisu allalaadimine praegusest Dataverse’i keskkonnast.

YAML-koodijupp (allalaaditav paportaal)

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 (allalaadimisportaali)

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, 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 Allalaaditava veebisaidi ID.
Overwrite
Sisu ülekirjutamine		 Power Pages veebisaidi sisu ülekirjutamiseks (true|false).
ModelVersion
Saidi andmemudel		 Näitab, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2). Vaikimisi väärtus on ’1’.

Power Platform PAPortal üleslaadimine

Laadige Power Pages veebisaidi sisu üles praegusesse Dataverse keskkonda.

YAML-koodijupp (üleslaadimisportaal)

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 (üleslaadimise portaal)

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 (näiteks https://powerappsbuildtools.crm.dynamics.com). Määratletud jaotises Teeninduse ühendusedProjekti sätetes, kasutades ühenduse Power Platform tüüpi.
UploadPath
Sisu üleslaadimise tee		 Tee, kust veebisaidi sisu üles laaditakse. Power Pages
ModelVersion
Saidi andmemudel		 Näitab, kas üleslaaditavad saidiandmed kasutavad standardset (1) või täiustatud andmemudelit (2). Vaikimisi väärtus on ’1’.

Ülesannete kataloog (eelvaade) Power Platform

Need ülesanded teostavad toiminguid kataloogis Power Platform ja hõlmavad järgmist.

Märkus.

Praegu on kataloogiülesanded Power Platform eelvaate väljaandes.

Kataloogiüksuse installimine

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		 Selle keskkonna teenuse lõpp-punkt, kuhu soovite sisu üles laadida (näiteks 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
Paigaldatava kataloogiüksuse ID		 (Nõutav) Kataloogiüksus, mis tuleb sihtkeskkonda installida.
TargetEnvironmentUrl
Sihtkeskkonna URL		 (Nõutav) Sihtkeskkonna URL kataloogiüksuse installimiseks (näiteks "https://YourOrg.crm.dynamics.com").
PollStatus
Kontrolli küsitluse olekut		 (Valikuline) Küsitlus oma taotluse oleku kontrollimiseks (tõene|väär).

Parameetrid (kataloogi installimine)

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 (näiteks "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 kataloogi esitamise faili tee ja failinimi.
UsePackageSolutionZipFile
Faili tüüp		 Failitüüp: pakett või lahenduse zip-fail.
SolutionZipFile
Lahenduse zip-faili nimi		 Määrake lahenduse zip-faili tee ja failinimi.
PollStatus
Kontrolli küsitluse olekut		 (Valikuline) Küsitlus oma taotluse oleku kontrollimiseks (tõene|väär).

Parameetrid (kataloogi esitamine)

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 installimise/esitamise taotluse 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 (näiteks "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älgimis-ID taotlemine		 (Nõutav) Taotle jälgimis-ID-d.
RequestType
Taotluse tüüp		 (Nõutav) Päringu 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.

Lisateavet Azure’i torujuhtmete kohta: Kasutage Azure’i torujuhtmeid

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.

Looge 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.

Juurutage tootmiskeskkonda (PROD).

Vt ka

Microsoft Power Platform Ehitustööriistad Azure DevOps

  • Last updated on