Microsoft Power Platform Build Tools -tehtävät

Artikkeli
04/30/2024

Käytettävissä olevat koontitehtävät kuvataan seuraavissa osissa. Tämän jälkeen esitellään joitakin esimerkkejä Azure-jaksoista, joissa hyödynnetään näitä tehtäviä. Tietoja Build Tools -työkaluista ja niiden latauksesta: Microsoft Power Platform Build Tools Azure-putkille.

Avustajatehtävä

Seuraavassa on kuvattu käytettävissä olevat avustajatehtävät.

Power Platform -työkalun asennusohjelma

Tämä tehtävä on lisättävä kerran ennen muita Power Platform -koontityökaluja, joiden avulla rakennetaan ja vapautetaan koontijaksoja. Tämä tehtävä asentaa joukon Power Platformin työkaluja, joita asiakaspalvelija Microsoft Power Platformin koontitehtävien suorittamiseen. Tämä tehtävä ei edellytä muita määrityksiä lisättäessä. Tämä tehtävä sisältää parametrejä, jotka koskevat kaikkien asennettavien työkalujen eri versioita.

Jos haluat pysyä ajan tasalla työkaluversioiden kanssa, varmista, että nämä parametrit vastaavat niiden työkalujen versioita, jotka tarvitaan, jotta jakso toimii oikein.

YAML-katkelma (asennusohjelma)

# 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

Parametrit (asennusohjelma)

Parametrit	Kuvaus
`DefaultVersion` Oletustyökaluversioiden käyttäminen	Arvoksi on määritettävä tosi, jos haluat käyttää kaikkien työkalujen oletusversiota, muussa tapauksessa epätosi. Pakollinen (ja epätosi), kun työkaluversioita on määritetty.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` Työkaluversio	Työkalun tietty versio.

Power Platform WhoAmI

Tarkistaa Power Platform -ympäristöpalveluyhteyden yhdistämällä ja tekemällä WhoAmI-pyynnön. Tämä tehtävä voi olla hyödyllinen lisätä jakson alkuvaiheessa ja tarkistaaksesi yhteyden, ennen kuin käsittely alkaa.

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

Parametrit (WhoAmI)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Valinnainen) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Sen ympäristön palvelupäätepiste, johon haluat yhdistää. Määritetään Projektiasetukset -kohdan kohdassa Palveluyhteydet. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Sen ympäristön palvelupäätepiste, johon haluat yhdistää. Määritetään Projektiasetukset -kohdan kohdassa Palveluyhteydet.

Laaduntarkastus

Seuraavassa osassa esitetään käytettävissä olevat tehtävät, joilla voi tarkistaa ratkaisun laadun.

Power Platform Checker

Tämä tehtävä suorittaa staattisen analyysitarkistuksen ratkaisuillesi suhteessa parhaiden käytäntöjen sääntöihin, jotta voidaan tunnistaa ongelmalliset mallit, jotka olet saattanut ottaa vahingossa käyttöön ratkaisua rakennettaessa.

YAML-katkelma (Checker)

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

Parametrit (Checker)

Parametrit	Kuvaus
`PowerPlatformSPN` Palveluyhteys	(Paollinen) Yhteys lisensoituun Microsoft Power Platform -ympäristöön vaaditaan Power Platformin tarkistuksen käyttämiseen. Palveluyhteydet määritetään Projektiasetukset-kohdan PalveluyhteydetPower Platform -yhteystyyppiä käyttäen. Lisätietoja: Katso `BuildTools.EnvironmentUrl` kohdassa Power Platform – luo ympäristö Huomautus: Palvelun päänimi ja käyttäjänimi-/salasanatodentamismenetelmät käytettävissä tarkistustehtävälle. Lisätietoja tämän tehtävän kanssa käytettävien palvelujen päänimien määrittämisestä: Määritä palvelun päänimiyhteyksiä Power Platform -ympäristöille.
`UseDefaultPACheckerEndpoint` Käytä Power Platform -Checker-päätepistettä	Oletusarvon mukaan (tosi), tarkistuspalvelun maantieteellinen sijainti käyttää samaa maantieteellistä sijaintia kuin ympäristö, johon yhdistetään.
`CustomPACheckerEndpoint` Mukautettu PAC-tarkistuspalvelun päätepiste	Pakollinen, kun `UseDefaultPACheckerEndpoint` on epätosi. Voit määrittää käytettäväksi toisen maantieteellisen alueen, kuten, `https://japan.api.advisor.powerapps.com.`. Luettelo käytettävissä olevista maantieteellisistä alueista: Power Platformin tarkastusohjelmointirajapinnan käyttäminen.
`FileLocation` Analysoitavien tiedostojen sijainti	Pakollinen, kun tiedostoon viitataan jaetun käytön allekirjoituksen (SAS) URL-osoitteesta `sasUriFile`. Huomautus: On tärkeää viitata viedyn ratkaisun tiedostoon eikä säilön purettuihin lähdetiedostoihin. Sekä hallittujen että hallitsemattomien ratkaisujen tiedostoja voidaan analysoida.
`FilesToAnalyzeSasUri` Analysoitavat SAS-tiedostot	Pakollinen, kun `FileLocation`-asetuksena on `sasUriFile`. Syötä SAS:n URI-osoite. Voit lisätä useita SAS URI -osoitteita pilkulla (,) tai puolipisteellä (;) erotetulla luettelolla.
`FilesToAnalyze` Analysoitavat paikalliset tiedostot	Tarvitaan, kun SAS-tiedostoja ei analysoida. Määritä analysoitavien zip-tiedostojen polku ja tiedostonimi. Yleismerkkejä voidaan käyttää. Syötä esimerkiksi *\.zip, kun haluat käyttää kaikkia alikansioiden zip-tiedostoja.
`FilesToExclude` Pois jätettävät paikalliset tiedostot	Määritä niiden tiedostojen nimet, jotka jätetään pois analyysistä. Jos useita, anna pilkulla (,) tai puolipisteellä (;) erotettu luettelo. Luettelossa voi olla koko tiedostonimi tai nimi, jonka alussa tai lopussa on asteriski, kuten *jquery tai form.js
`RulesToOverride` Ohitetttavat säännöt	JSON-matriisi, joka sisältää ohitettavat säännöt ja tasot. OverrideLevel-kohteen hyväksytyt arvot ovat Kriittinen, Korkea, Normaali, Alhainen, Tiedottava. Esimerkki: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
`RuleSet` Sääntöjoukko	(Pakollinen) Määritä sovellettava sääntöjoukko. Käytettävissä ovat seuraavat kaksi sääntöjoukkoa: Ratkaisun tarkistus: Tämä on sama sääntöjoukko, joka suoritetaan Power Apps Maker Portalista. AppSource: Laajennettu sääntöjoukko, jota käytetään sovelluksen sertifiointiin, ennen kuin se voidaan julkaista AppSourcessa
`ErrorLevel` Virhetaso	Yhdessä virherajaparametrin kanssa määrittää sallittujen virheiden ja varoitusten vakavuuden. Tuetut raja-arvot ovat <level>IssueCount, jossa level=Kriittinen, Korkea, Normaali, Alhainen ja Tiedottava.
`ErrorThreshold` Virhekynnys	Määrittää sen virheiden määrän (>=0), joka on sallittu tietyllä tasolla, jotta tarkistaja hyväksyy tarkistettavat ratkaisut.
`FailOnPowerAppsCheckerAnalysisError` Epäonnistui virheellä	Jos arvo on tosi, epäonnistuu, jos Power Apps -Tarkistustoiminto-analyysi palautetaan epäonnistuneena tai FinishedWithErrors.
`ArtifactDestinationName` DevOps-artefaktin nimi	Määritä Azure-artefaktin nimi tarkistajan .sarif-tiedostolle.

Ratkaisutehtävät

Tämä tehtäväjoukko voi automatisoida ratkaisutoimintoja. Ympäristön luomista, kopioimista tai palauttamista koskevat ympäristötehtävät (joita käsitellään myöhemmin tässä osassa) korvaavat palveluyhteydet juuri luoduilla ympäristöillä. Näiden tehtävien ansiosta voidaan suorittaa ratkaisutehtäviä tarvetta varten juuri luoduissa ympäristöissä.

Power Platform Tuo ratkaisu

Tuo ratkaisun kohdeympäristöön.

YAML-katkelma (Tuo)

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

Parametrit (Tuo)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, johon ratkaisu halutaan tuoda (esim. `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, johon ratkaisu halutaan tuoda (esim. `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`SolutionInputFile` Ratkaisun syötetiedosto	(Pakollinen) Kohdeympäristöön vietävän ratkaisu.zip-tiedoston polku ja nimi (esimerkiksi $(Build.ArtifactStagingDirectory)$(SolutionName).zip). Huomautus: Muuttujat antavat sinulle kätevän tavan saada tärkeitä tietoja putken eri osiin. Katso Käyttäjän ennalta määritetyt muuttujat saadaksesi kattavan luettelon.
`HoldingSolution` Tuominen holding-ratkaisuna	Lisäasetusparametri (tosi\|epätosi), jota käytetään, kun ratkaisun versio on päivitettävä. Tämä parametri isännöi ratkaisua Dataversessa, mutta se ei päivitä ratkaisua ennen kuin Ota ratkaisun päivitys käyttöön -tehtävä suoritetaan.
`OverwriteUnmanagedCustomizations` Ei-hallittujen mukautusten korvaaminen	Määritä, korvataanko hallitsemattomat mukautukset (tosi\|epätosi).
`SkipProductUpdateDependencies` Tuotteen päivityksen riippuvuuksien ohitus	Määritä, ohitetaanko tuotepäivityksiin liittyvien riippuvuuksien pakotus (tosi\|epätosi).
`ConvertToManaged` Muunna hallituksi	Määritä, tuodaanko hallittuna ratkaisuna (tosi\|epätosi).
`AsyncOperation` Asynkroninen tuonti	Jos valittu (tosi), tuonti suoritetaan asynkronisesti. Tätä suositellaan suuremmille ratkaisuille, koska tämä tehtävä aikakatkaistaan muussa tapauksessa 4 minuutin kuluttua. Asynkronisen vaihtoehdon valitseminen etsii ja odottaa, kunnes MaxAsyncWaitTime on saavutettu (tosi\|epätosi).
`MaxAsyncWaitTime` Suurin odotusaika	Asynkronisen toiminnon suurin odotusaika minuutteina; oletusasetus on 60 min (1 t), sama kuin Azure DevOps-tehtävien oletusasetus.
`PublishWorkflows` Prosessien aktivoiminen tuonnin jälkeen	Määritä, aktivoidaanko ratkaisun prosessit (työnkulut) tuonnin jälkeen (tosi\|epätosi).
`UseDeploymentSettingsFile` Käyttöönottoasetustiedoston käyttö	Yhteysviitteet ja ympäristömuuttujien arvot voidaan määrittää käyttöönottoasetusten tiedoston avulla (tosi\|epätosi).
`DeploymentSettingsFile` Käyttöönottoasetustiedosto	(Pakollinen, kun `UseDeploymentSettingsFile`=tosi) Käyttöönottoasetustiedoston polku ja tiedostonimi.

Power Platform Ratkaisun osien lisääminen

Lisää ratkaisun osan ei-hallittuun ratkaisuun.

YAML-katkelma (Lisää)

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

Parametrit (Lisää)

Parametrit	Kuvaus
`ComponentId` Ratkaisun osan tunnus	Kohderatkaisuun lisättävän osan rakenteen nimi tai tunnus.
`ComponentType` Power Platform -ympäristön URL	Arvo, joka edustaa lisättävää ratkaisun osaa. Kattava luettelo osien arvoista: Käytä esimääritettyjä osatyyppejä.
`SolutionUniqueName` Ratkaisun nimi	Ratkaisun yksilöivä nimi.
`AddRequiredComponents` Muusta ratkaisusta tarvittavat osat ratkaisun osan mukaan	(Valinnainen) Ilmaisee, lisätäänkö ei-hallittuun ratkaisuun myös muut lisättävän ratkaisun osan edellyttämät ratkaisun osat
`Environment` Ympäristön URL-osoite tai tunnus	(Valinnainen) Kohdeympäristön URL-osoite tai tunnus.

Power Platform Ota ratkaisun päivitys käyttöön

Päivittää holding-ratkaisuna tuodun ratkaisun version.

YAML-katkelma (päivitys)

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

Parametrit (päivitys)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, johon ratkaisu halutaan päivittää (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, johon ratkaisu halutaan päivittää (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`SolutionName` Ratkaisun nimi	(Pakollinen) Päivitettävän ratkaisun nimi. Käytä aina ratkaisun Nimi-arvoa äläkä sen Näyttönimi-arvoa.
`AsyncOperation` Asynkroninen päivitys	Jos valittu (tosi), päivitysoperaatio suoritetaan asynkronisena erätyönä. Asynkronisen vaihtoehdon valitseminen etsii ja odottaa, kunnes MaxAsyncWaitTime on saavutettu.
`MaxAsyncWaitTime` Suurin odotusaika	Asynkronisen toiminnon suurin odotusaika minuutteina; oletusasetus on 60 min (1 t), sama kuin Azure DevOps-tehtävien oletusasetus.

Muistiinpano

Muuttujat antavat sinulle kätevän tavan saada tärkeitä tietoja putken eri osiin. Katso Käyttäjän ennalta määritetyt muuttujat saadaksesi kattavan luettelon. Voit esitäyttää yhteysviitteen ja ympäristön muuttujatiedot kohdeympäristölle, kun tuot ratkaisua käyttöönottoasetustiedostoa käyttäen.

Lisätietoja: Yhteysviittauksien ja ympäristömuuttujien esitäyttö automaattisille käyttöönotoille

Power Platform -ratkaisun vieminen

Vie ratkaisun lähdeympäristöstä.

YAML-katkelma (Vie)

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

Parametrit (Vie)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, johon ratkaisu halutaan päivittää (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, johon ratkaisu halutaan päivittää (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`SolutionName` Ratkaisun nimi	(Pakollinen) Vietävän ratkaisun nimi. Käytä aina ratkaisun Nimi-arvoa äläkä sen Näyttönimi-arvoa.
`SolutionOutputFile` Ratkaisun tulostetiedosto	(Pakollinen) Lähdeympäristöstä tuotavan ratkaisu.zip-tiedoston polku ja nimi (esimerkiksi $(Build.ArtifactStagingDirectory)$(SolutionName).zip ). Huomautus: Muuttujat antavat sinulle kätevän tavan saada tärkeitä tietoja putken eri osiin. Katso Käyttäjän ennalta määritetyt muuttujat saadaksesi kattavan luettelon.
`AsyncOperation` Asynkroninen vienti	Jos valittu (tosi), vientioperaatio suoritetaan asynkronisena erätyönä. Asynkronisen vaihtoehdon valitseminen etsii ja odottaa, kunnes MaxAsyncWaitTime on saavutettu.
`MaxAsyncWaitTime` Suurin odotusaika	Asynkronisen toiminnon suurin odotusaika minuutteina; oletusasetus on 60 min (1 t), sama kuin Azure DevOps-tehtävien oletusasetus.
`Managed` Vie kuvana hallittuna	Jos valittu (tosi), vie ratkaisu hallittuna ratkaisuna; muussa tapauksessa vie hallitsemattomana ratkaisuna.
`ExportAutoNumberingSettings` Automaattisen numeroimisen asetusten vieminen	Automaattisen numeroimisen asetusten vieminen (tosi\|epätosi).
`ExportCalendarSettings` Vie kalenterin asetukset	Vie kalenterin asetukset (tosi\|epätosi).
`ExportCustomizationSettings` Vie mukautusasetukset	Vie mukautusasetukset (tosi\|epätosi).
`ExportEmailTrackingSettings` Vie sähköpostiseurannan asetukset	Vie sähköpostin seuranta-asetukset (tosi\|epätosi).
`ExportGeneralSettings` Vie yleiset asetukset	Vie yleiset asetukset (tosi\|epätosi).
`ExportIsvConfig` Vie ISV-määritykset	Vie ISV-määritykset (tosi\|epätosi).
`ExportMarketingSettings` Vie markkinointiasetukset	Vie markkinointiasetukset (tosi\|epätosi).
`ExportOutlookSynchronizationSettings` Outlookin synkronointiasetusten vieminen	Vie Outlookin synkronointiasetukset (tosi\|epätosi).
`ExportRelationshipRoles` Vie suhderoolit	Vie suhderoolit (tosi\|epätosi).
`ExportSales` Vie myynnit	Vie myynnit (tosi\|epätosi).

Power Platform -paketin purkuratkaisu

Vie pakatun ratkaisun tiedoston ja purkaa sen useisiin XML-tiedostoihin, jotta lähteenhallintajärjestelmä pystyy helpommin lukemaan ja hallitsemaan kyseisiä tiedostoja.

YAML-katkelma (Pura pakkaus)

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

Parametrit (Pura pakkaus)

Parametrit	Kuvaus
`SolutionInputFile` Ratkaisun syötetiedosto	(Pakollinen) Purettavan ratkaisu.zip-tiedoston polku ja tiedostonimi.
`SolutionTargetFolder` Ratkaisun purkamisen kohdekansio	(Pakollinen) Polku ja kohdekansio, johon haluat purkaa ratkaisun.
`SolutionType` Ratkaisutyyppi	(Pakollinen) Purettavan ratkaisun tyyppi. Vaihtoehtoja ovat: Hallitsematon (suositeltava), Hallittu ja Molemmat.

Power Platform -pakettiratkaisu

Pakkaa lähteenhallinnan ratkaisun solution.zip-tiedostoon, joka voidaan tuoda toiseen ympäristöön.

YAML-katkelma (Pakkaa)

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

Parametrit (Pakkaa)

Parametrit	Kuvaus
`SolutionOutputFile` Ratkaisun tulostetiedosto	(Pakollinen) Sen solution.zip-tiedoston polku ja nimi, johon ratkaisu pakataan.
`SolutionSourceFolder` Pakattavan ratkaisun lähdekansio	(Pakollinen) Pakattavan ratkaisun polku ja lähdekansio.
`SolutionType` Ratkaisutyyppi	(Pakollinen) Pakattavan ratkaisun tyyppi. Vaihtoehtoja ovat Hallittu (suositeltava), Hallitsematon ja Molemmat.

Power Platform Ratkaisun poistaminen

Poistaa ratkaisun kohdeympäristöstä.

YAML-katkelma (Poista)

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'

Parametrit (Poista)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, josta ratkaisu halutaan poistaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, josta ratkaisu halutaan poistaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`SolutionName` Ratkaisun nimi	(Pakollinen) Poistettavan ratkaisun nimi. Käytä aina ratkaisun Nimi-arvoa äläkä sen Näyttönimi-arvoa.

Power Platform -mukautusten julkaiseminen

Julkaisee kaikki muokkaukset ympäristössä.

YAML-katkelma (Julkaise)

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

Parametrit (julkaise)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, johon mukautukset halutaan julkaista (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, johon mukautukset halutaan julkaista (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen

Power Platformissa määritetty ratkaisuversio

Päivittää ratkaisun version.

YAML-katkelma (versio)

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

Parametrit (versio)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, jossa ratkaisun versio halutaan määrittää (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, jossa ratkaisun versio halutaan määrittää (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`SolutionName` Ratkaisun nimi	(Pakollinen) Ratkaisun nimi, jolle versio määritetään. Käytä aina ratkaisun Nimi-arvoa äläkä sen Näyttönimi-arvoa.
`SolutionVersionNumber` Ratkaisun versionumero	(Pakollinen) Versionumero, jonka haluat määrittää.

Versionumero voidaan koodata putkessa, mutta on suositeltavaa käyttää Azure DevOps -putkimuuttujaa, esimerkkinä BuildId. Tämä sisältää vaihtoehdot, jotka määrittävät versionumeron tarkan muodon määrittämisen Asetukset-välilehdessä. Esimerkki: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Tätä määritelmää voidaan sitten käyttöön ratkaisun version määrittämistehtävässä määrittämällä Versionumero-ominaisuus arvolla $(Build.BuildId) eikä pysyvällä koodauksella 20200824.0.0.2.

Vaihtoehtoisesti powershell-inline-tehtäväkomentosarja $(Get-Date -Format yyyy.MM.dd. HHmm) ‑tulosjoukko on tyhjä muuttuja, jonka nimi on SolutionVersion kirjoitusisäntänä ("##vso[task.setvariable variable=SolutionVersion;] $version"), Määritä ratkaisun versioksi $(SolutionVersion).

Power Platform – Määritä yhteysmuuttujat

Määrittää BuildTools.* -muuttujat, jotta mukautetut komentosarjatehtävät voivat käyttää palveluyhteyttä yhtenä totuuslähteenä.

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

Parametrit (SetConnectionVariables)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, jolle yhteysmuuttujat halutaan määrittää. Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`timeoutInMinutes` Timeout	Määrittää tehtävän suorituksen enimmäisajan minuutteina, ennen kuin palvelin peruuttaa sen. Nolla-arvo tarkoittaa loputonta aikakatkaisua.
`retryCountOnTaskFailure` Uudelleenyritysten määrä, jos tehtävä epäonnistui	Määrittää, kuinka monta uudelleenyritystä tehtävää varten tapahtuu, jos tehtävä epäonnistuu. Ei tueta tehtäville, joissa ei ole asiakaspalvelijaa.
`ApplicationId` Kirjautumisen sovellustunnus	(Vaaditaan käyttäjänimelle/salasanalle) Kirjautumisessa käytettävä sovellustunnus (Lisätietoja on jäljempänä).
`RedirectUri` Tietyn sovelluksen uudelleenohjaus-URI	(Vaaditaan käyttäjänimelle/salasanalle) Määritetyn sovelluksen uudelleenohjaus-URI. Tarvitaan, kun määrität sovellustunnuksen. (Katso alla olevaa lisähuomautusta).

Huomautus

Kun käytät käyttäjänimi/salasana-todennustyyppiä, sovellustunnus ja uudelleenohjaus-URI ovat pakollisia. Tässä todenna OAuth -dokumentissa on kuvaus siitä, miksi sinun on luotava sovelluksen rekisteröinti Dataverse-todennusta varten. Kun muodostat yhteyden käyttämällä käyttäjänimi/salasana-todennusta, yhteys toimii sovelluksena, joka muodostaa yhteyden käyttäjän puolesta Dataverseen.

Power Platform -paketin käyttöönotto

Ottaa paketin käyttöön ympäristössä. Kun paketti otetaan käyttöön yhden ratkaisutiedoston asemesta, voit halutessasi ottaa käyttöön useita ratkaisuja, tietoja ja koodeja ympäristöön.

YAML-katkelma (Käyttöönotto)

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

Parametrit (Ota käyttöön)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, jossa paketti halutaan ottaa käyttöön (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, jossa paketti halutaan ottaa käyttöön (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform. Lisätietoja on kohdassa `BuildTools.EnvironmentUrl`Power Platformin alla kohdassa Uuden ympäristön luominen
`PackageFile` Pakettitiedosto	(Pakollinen) Pakettitiedoston kokoonpanon (.dll) polku ja tiedostonimi.
`MaxAsyncWaitTime` Suurin odotusaika	Asynkronisen toiminnon suurin odotusaika minuutteina; oletusasetus on 60 min (1 t), sama kuin Azure DevOps-tehtävien oletusasetus.

Ympäristönhallintatehtävät

Automatisoi yleisiä ympäristön elinkaarenhallinnan (ELM) tehtäviä.

Power Platformin ympäristönluonti

Luo uuden ympäristön. Uuden ympäristön luominen luo myös automaattisesti BuildTools.EnvironmentUrl-osoitteen.

Tärkeä

Kun määritetty, BuildTools.EnvironmentUrl-osoitetta käytetään oletuspalveluyhteytenä putken seuraaville tehtäville. Jokainen tässä artikkelissa kuvattu tehtävä käyttää palveluyhteyden päätepistettä vain silloin, kun BuildTools.EnvironmentUrl-osoitetta ei ole määritetty.

Uusi ympäristö voidaan valmistella vain, jos käyttöoikeus tai kapasiteetti mahdollistaa uusien ympäristöjen luomisen. Lisätietoja kapasiteetin tarkastelemiseen: Kapasiteettisivun tiedot.

YAML katkelma (Luo ympäristö)

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

Parametrit (Luo ympäristö)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, johon ratkaisu halutaan luoda (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, johon ratkaisu halutaan luoda (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`DisplayName` Näyttönimi	(Pakollinen) Luodun ympäristön näyttönimi.
`LocationName` Käyttöönottoalue	(Pakollinen) Alue, jossa ympäristö pitäisi luoda.
`EnvironmentSku` Ympäristön tyyppi	(Pakollinen) Käyttöönotettavan esiintymän tyyppi. Vaihtoehdot ovat Kokeilu, Tuotanto, Kokeiluversio ja SubscriptionBasedTrial.
`AppsTemplate` Sovellukset	Jos ympäristötyyppi ei ole kokeiluversio, tuettuja sovelluksia ovat D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation ja D365_Sales.
`CurrencyName` Valuutta	(Pakollinen) Luodun ympäristön perusvaluutta. Valuuttaa ei voi päivittää ympäristön luomisen jälkeen.
`LanguageName` Language	(Pakollinen) Ympäristön asennuskieli.
`DomainName` Toimialueen nimi	(Pakollinen) Tämä on ympäristökohtainen merkkijono, joka muodostaa osan URL-osoitteesta. Esimerkiksi ympäristössä, jonka URL on `https://powerappsbuildtasks.crm.dynamics.com/`, toimialuenimi olisi 'powerappsbuildtasks'. Huomautus: Jos annat jo käytössä olevan verkkotunnuksen, tehtävä liittää verkkotunnukseen numeroarvon, joka alkaa numerolla 0. Yllä olevassa esimerkissä URL voi muuttua muotoon `https://powerappsbuildtasks0.crm.dynamics.com/`.

Power Platform -ympäristön poisto

Poistaa ympäristön.

YAML-katkelma (Poista ympäristö)

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

Parametrit (Poista ympäristö)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, josta ratkaisu halutaan poistaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, josta ratkaisu halutaan poistaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.

Power Platform – käyttäjän määrittäminen

Määritä käyttäjä kohdeympäristöön määritetyn käyttöoikeusroolin avulla.

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

Parametrit (AssignUser-env)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, johon haluat määrittää käyttäjän (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`User` Power Platformin käyttäjätunnus	Microsoft Entra:n objektin tunnus tai täydellinen käyttäjätunnus, jota käytetään kohdeympäristöön määritettäessä.
`Role` Käyttöoikeusroolin nimi tai tunnus	Käyttöoikeusroolin nimi tai tunnus, joka määritetään käyttäjälle.
`ApplicationUser` Power Platform -sovelluksen käyttäjätunnus	Määrittää, onko syötteen käyttäjä sovelluksen käyttäjä (tosi\|epätosi).

Power Platform – Palauta ympäristön oletusasetukset

Palauttaa ympäristön oletusasetukset.

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

Parametrit (Reset-env)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Palvelun päätepiste, jossa ratkaisu halutaan palauttaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Palvelun päätepiste, jossa ratkaisu halutaan palauttaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.

Power Platformin ympäristön varmuuskopiointi

Varmuuskopioi ympäristön.

YAML-katkelma (varmuuskopioi ympäristö)

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

Parametrit (Varmuuskopioi ympäristö)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	TPalvelun päätepiste, josta ympäristö halutaan varmuuskopioida (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	TPalvelun päätepiste, josta ympäristö halutaan varmuuskopioida (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`BackupLabel` Varmuuskopion selite	(Pakollinen) Varmuuskopioon määritettävä selite.

Power Platform Kopioi ympäristö

Kopioi ympäristön kohdeympäristöön. Käytettävissä on kahdenlaisia kopioita: täysi ja minimaalinen. Täysi kopio sisältää sekä tietoja että ratkaisun metatietoja (mukautuksia), kun taas minimaalinenk opio sisältää vain ratkaisun metatietoja eikä varsinaisia tietoja.

YAML-katkelma (kopioi ympäristö)

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

Parametrit (kopioi ympäristö)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Lähdeympäristön palvelun päätepiste, josta haluat kopioida (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Lähdeympäristön palvelun päätepiste, josta haluat kopioida (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`TargetEnvironmentUrl` Kohdeympäristö URL-osoite	(Pakollinen) Sen kohdeympäristön URL-osoite, johon kopioidaan.
`CopyType` Kopiointityyppi	Kopiointityyppi: FullCopy tai MinimalCopy
`OverrideFriendlyName` Ohita lyhyt nimi	Muuta kohdeympäristön lyhyttä nimeä (tosi\|epätosi).
`FriendlyName` Kutsumanimi	Kohdeympäristön lyhyt nimi.
`DisableAdminMode` Järjestelmänvalvojan tilan poistaminen käytöstä	Poistetaanko järjestelmänvalvojan tila käytöstä (tosi\|epätosi).

Power Platform – Ympäristön palauttaminen

Palauttaa ympäristön määritettyyn varmuuskopioon.

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

Parametrit (Restore-env)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformEnvironment` Power Platform -ympäristön URL	Lähdeympäristön palvelun päätepiste, josta haluat palauttaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Lähdeympäristön palvelun päätepiste, josta haluat palauttaa (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`RestoreLatestBackup` Viimeisin palautettava varmuuskopio	Tieto siitä, palautetaanko uusin varmuuskopio vai annetaanko RestoreTimeStamp (true\|false).
`RestoreTimeStamp` Varmuuskopion päivämäärä ja aika (DateTime)	Varmuuskopion DateTime-arvo muodossa "mm/dd/yyyy hh:mm" TAI merkkijono "latest".
`TargetEnvironmentUrl` Kohdeympäristö URL-osoite	(Pakollinen) Sen kohdeympäristön URL-osoite, joka palautetaan.
`FriendlyName` Palautetun ympäristön nimi	(Valinnainen) Palautetun ympäristön nimi.
`DisableAdminMode` Järjestelmänvalvojan tilan poistaminen käytöstä	Poistetaanko järjestelmänvalvojan tila käytöstä (tosi\|epätosi).

Vie Dataverse -tiedot

Vie tiedot ympäristöstä annettuun rakenteeseen.

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

Parametrit (exportdata-env)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, josta haluat viedä tietoja (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`SchemaFile` Rakenteen XML-tiedoston nimi	Rakenteen XML-tiedoston nimi. Se voidaan luoda määrityksen vientityökalun avulla.
`DataFile` Datatiedoston nimi	Vietävien tietojen tiedostonimi (zip-tiedosto).
`Overwrite` Sisällön korvaaminen	Power Pages -sivuston korvattava sisältö (tosi\|epätosi).

Dataverse-tietojen tuominen

Tuo tiedot ympäristöön.

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

Parametrit (importdata-env)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, josta haluat tuoda tietoja (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`DataFile` Datatiedoston nimi	Tuotavan pakatun zip-tietotietueen tiedostonimi tai kansio sekä tuotavat data-schema.xml- ja data.xml-tiedostot.

Power Pages management -tehtävät

Tehtävät Power Pages -sivustossa työskentelyä varten.

Power Platform Lataa PAPortal

Lataa Power Pages -sivuston sisältö nykyisestä Dataverse-ympäristöstä.

YAML-katkelma (download-paportal)

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

Parametrit (download-paportal)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, josta haluat ladata sisältöä (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`WebsiteId` Portaalisivuston tunnus	Ladattavan Power Pages -sivuston tunnus.
`Overwrite` Sisällön korvaaminen	Power Pages -sivuston korvattava sisältö (tosi\|epätosi).
`ModelVersion` Sivuston tietomalli	Ilmaisee, käytetäänkö ladattavissa sivustotiedoissa vakiomuotoista (`1`) vai parannettua tietomallia (`2`). Oletusarvo on 1.

Power Platform Lataa PAPortal

Lataa Power Pages -sivustojen sisältöä nykyiseen Dataverse-ympäristöön.

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

Parametrit (upload-paportal)

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, johon haluat ladata tietoja (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`UploadPath` Sisältöpolun lataaminen	Polku, josta Power Pages -sivuston sisältö ladataan palvelimeen.
`ModelVersion` Sivuston tietomalli	Ilmaisee, käytetäänkö ladattavissa sivustotiedoissa vakiomuotoista (`1`) vai parannettua tietomallia (`2`). Oletusarvo on 1.

Power Platform -tehtävien hakemisto (esiversio)

Nämä tehtävät suorittavat hakemistolle toimintoja Power Platformissa ja sisältävät seuraavat asiat.

Muistiinpano

Tällä hetkellä Power Platformin hakemistotehtävät ovat esiversio-julkaisu.

Hakemistokohteen asentaminen

Asenna Catalog-nimike kohdeympäristöön.

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, johon haluat ladata tietoja (esimerkiksi `https://powerappsbuildtools.crm.dynamics.com`). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`Environment` Kohdeympäristö URL-osoite	(Pakollinen) Tämän tehtävän kohteena oleva ympäristön URL-osoite.
`CatalogItemId` Asennettavan hakemistokohteen tunnus	(Pakollinen) Kohdeympäristöön asennettava hakemistokohde.
`TargetEnvironmentUrl` Kohdeympäristö URL-osoite	(Pakollinen) Hakemistokohteen asennuksen kohdeympäristön URL-osoite (kuten https://YourOrg.crm.dynamics.com).
`PollStatus` Kyselyn tilan tarkistaminen	(Valinnainen) Kysely pyynnön tilan (tosi\|epätosi) tarkastamiseksi.

Parametrit (catalog-install)

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

Hakemiston hyväksynnän lähettäminen

Lähetä Catalog-hyväksymispyyntö.

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, johon haluat ladata tietoja (esimerkiksi https://powerappsbuildtools.crm.dynamics.com). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`Environment` Kohdeympäristö URL-osoite	(Pakollinen) Tämän tehtävän kohteena oleva ympäristön URL-osoite.
`CatalogSubmissionFile` Hakemiston lähetystiedosto	(Pakollinen) Määritä hakemiston lähetystiedoston polku ja tiedostonimi.
`UsePackageSolutionZipFile` Tiedostotyyppi	Tiedostotyyppi: paketti tai ratkaisun zip-tiedosto.
`SolutionZipFile` Ratkaisun zip-tiedoston nimi	Määritä ratkaisun zip-tiedoston polku ja tiedostonimi.
`PollStatus` Kyselyn tilan tarkistaminen	(Valinnainen) Kysely pyynnön tilan (tosi\|epätosi) tarkastamiseksi.

Parametrit (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

Hakemistopyynnön tila

Nouda hakemiston asennus-/lähetyspyyntö.

Parametrit	Kuvaus
`authenticationType` Todennustyyppi	(Pakollinen SPN:lle) Määritä joko käyttäjänimelle/salasanayhteydelle PowerPlatformEnvironment- tai PowerPlatformSPN-yhteys palvelun pää- tai asiakassalaisuusyhteydelle.
`PowerPlatformSPN` Power Platform -Palvelupäällikkö	Ympäristön palvelun päätepiste, johon haluat ladata tietoja (esimerkiksi https://powerappsbuildtools.crm.dynamics.com). Määritetty kohdassa Palveluyhteydet kohdassa Projektiasetukset käyttäen yhteystyyppiä Power Platform.
`Environment` Kohdeympäristö URL-osoite	(Pakollinen) Tämän tehtävän kohteena oleva ympäristön URL-osoite.
`TrackingId` Pyynnön seurantatunnus	(Pakollinen) Pyynnön seurantatunnus.
`RequestType` Pyynnön tyyppi	(Pakollinen) Pyyntötyyppi. (Arvot: Asenna \| Lähetä).

Parametrit (catalog-status)

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

Luo ja vapauta putket

Nyt kun olemme tunnistaneet, mitä voidaan tehdä käyttämällä koontityökaluja, katsotaanpa, miten näitä työkaluja voi käyttää koonti- ja julkaisuputkissa. Alla on esitetty käsitteellinen yleiskuva. Seuraavaksi tarkastellaan joitakin putkitoteutuksen tietoja alla olevien aliosien kehitystyökalutehtävien avulla.

Jos haluat lisätietoja näiden putkien luomisesta ja todella luoda putkia Microsoft Power Platform Build Tools -työkalujen avulla, suorita Build Tools -työkalujen laboratoriot, jotka voit ladata GitHubista.

Lisätietoja Azure-putkista: Azure-putkien käyttäminen

Koontijakso: Vie ratkaisu kehitysympäristöstä (DEV)

Seuraavassa kuvassa esitetään koontityökalutehtävät, joita voi lisätä putkeen, joka vie ratkaisun kehitysympäristöstä.

Ratkaisun vienti kehitysympäristöstä (DEV)

Koontijakso: Hallitun ratkaisun koonti

Seuraavassa kuvassa esitetään koontityökalutehtävät, joita voi lisätä putkeen, joka kokoaa hallitun ratkaisun.

Hallitun ratkaisun koonti

Julkaisuputki: Ota käyttöön tuotantoympäristössä (PROD)

Seuraavassa kuvassa esitetään koontityökalutehtävät, joita voi lisätä putkeen, joka ottaa käyttöön tuotantoympäristössä.

Käyttöönotto tuotantoympäristössä (PROD)

Katso myös

Azure DevOpsin Microsoft Power Platform Build Tools

Jaa

Microsoft Power Platform Build Tools -tehtävät

Avustajatehtävä

Power Platform -työkalun asennusohjelma

YAML-katkelma (asennusohjelma)

Parametrit (asennusohjelma)

Power Platform WhoAmI

YAML-katkelma (WhoAmI)

Parametrit (WhoAmI)

Laaduntarkastus

Power Platform Checker

YAML-katkelma (Checker)

Parametrit (Checker)

Ratkaisutehtävät

Power Platform Tuo ratkaisu

YAML-katkelma (Tuo)

Parametrit (Tuo)

Power Platform Ratkaisun osien lisääminen

YAML-katkelma (Lisää)

Parametrit (Lisää)

Power Platform Ota ratkaisun päivitys käyttöön

YAML-katkelma (päivitys)

Parametrit (päivitys)

Power Platform -ratkaisun vieminen

YAML-katkelma (Vie)

Parametrit (Vie)

Power Platform -paketin purkuratkaisu

YAML-katkelma (Pura pakkaus)

Parametrit (Pura pakkaus)

Power Platform -pakettiratkaisu

YAML-katkelma (Pakkaa)

Parametrit (Pakkaa)

Power Platform Ratkaisun poistaminen

YAML-katkelma (Poista)

Parametrit (Poista)

Power Platform -mukautusten julkaiseminen

YAML-katkelma (Julkaise)

Parametrit (julkaise)

Power Platformissa määritetty ratkaisuversio

YAML-katkelma (versio)

Parametrit (versio)

Power Platform – Määritä yhteysmuuttujat

YAML-katkelma (SetConnectionVariables)

Parametrit (SetConnectionVariables)

Power Platform -paketin käyttöönotto

YAML-katkelma (Käyttöönotto)

Parametrit (Ota käyttöön)

Ympäristönhallintatehtävät

Power Platformin ympäristönluonti

YAML katkelma (Luo ympäristö)

Parametrit (Luo ympäristö)

Power Platform -ympäristön poisto

YAML-katkelma (Poista ympäristö)

Parametrit (Poista ympäristö)

Power Platform – käyttäjän määrittäminen

YAML-katkelma (AssignUser-env)

Parametrit (AssignUser-env)

Power Platform – Palauta ympäristön oletusasetukset

YAML-katkelma (Reset-env)

Parametrit (Reset-env)

Power Platformin ympäristön varmuuskopiointi

YAML-katkelma (varmuuskopioi ympäristö)

Parametrit (Varmuuskopioi ympäristö)

Power Platform Kopioi ympäristö

YAML-katkelma (kopioi ympäristö)

Parametrit (kopioi ympäristö)

Power Platform – Ympäristön palauttaminen

YAML-katkelma (Restore-env)

Parametrit (Restore-env)

Vie Dataverse -tiedot

YAML-katkelma (exportdata-env)

Parametrit (exportdata-env)

Dataverse-tietojen tuominen

YAML-katkelma (importdata-env)

Parametrit (importdata-env)

Power Pages management -tehtävät

Power Platform Lataa PAPortal

YAML-katkelma (download-paportal)

Parametrit (download-paportal)

Power Platform Lataa PAPortal