Jaa

Microsoft Power Platform Build Tools -tehtävät

  • Artikkeli

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@2
  displayName: 'Power Platform Tool Installer'

# 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

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

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

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 Palveluyhteydet Power 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@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
    ConvertToManaged: 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

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

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

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 tarjoavat 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@2
  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@2
  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@2
  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@2
  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@2
  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@2
  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 sallii lisäympäristöjen luomisen. Lisätietoja kapasiteetin tarkastelemiseen: Kapasiteettisivun tiedot.

YAML katkelma (Luo ympäristö)

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

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 syötät jo käytössä olevan toimialuenimen, tehtävä lisää toimialuenimeen numeerisen arvon, 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@2
  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@2
  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@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'
    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

Microsoft Power Platform Rakenna työkaluja Azure DevOps