Opravila z orodji Microsoft Power Platform Build Tools

  • Članek

Razpoložljiva opravila za graditev so opisana v naslednjih razdelkih. Nato predstavimo nekaj primerov Azure Pipelines, ki uporabljajo te naloge. Za informacije o orodjih za gradnjo in o tem, kako jih prenesti, glejte Microsoft Power Platform Orodja za gradnjo za cevovode Azure.

Opravilo pomočnika

V nadaljevanju so opisane razpoložljive naloge pomočnika.

Nameščanje orodij v storitvi Power Platform

To opravilo je treba dodati enkrat pred katerim koli drugim opravilom orodij Build Tools v storitvi Power Platform v prodajnih lijakih za graditev in izdajo. To opravilo namesti nabor posebnih orodij za Power Platform, ki jih posrednik potrebuje za izvajanje opravil za graditev storitve Microsoft Power Platform. Ta naloga ne zahteva dodatne konfiguracije, ko je dodana. Ta naloga vsebuje parametre za posamezne različice vsakega od orodij, ki se nameščajo.

Če želite, da se orodja sproti posodabljajo, se prepričajte, da ti parametri ustrezajo različicam orodij, ki so potrebna za pravilno delovanje prodajnega lijaka.

Izrezek YAML (namestitveni program)

# 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

Parametri (namestitveni program)

Parametri Opis
DefaultVersion
Uporaba privzetih različic orodja		 Nastavite true, če želite uporabiti privzeto različico vseh orodij, sicer pa false. Obvezno (in false), ko so določene različice orodja.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Različica orodja		 Posebna različica orodja za uporabo.

Zahteva WhoAmI v storitvi Power Platform

Preverja povezavo okolja storitve Power Platform s povezovanjem in pošiljanjem zahteve WhoAmI. To opravilo je koristno v prodajnem lijaku vključiti zgodaj, da zagotovite povezavo še pred začetkom obdelave.

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

Parametri (WhoAmI)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Neobvezno) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Končna točka storitve za okolje, s katerim se povezujete. Določeno pod možnostjo Povezave storitve v možnosti Nastavitve projekta. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Končna točka storitve za okolje, s katerim se povezujete. Določeno pod možnostjo Povezave storitve v možnosti Nastavitve projekta.

Preverjanje kakovosti

V naslednjem razdelku so razpoložljive naloge za preverjanje kakovosti rešitve.

Power Platform Checker

Ta naloga izvede preverjanje statične analize vaših rešitev glede na nabor pravil najboljše prakse, da prepozna morebitne problematične vzorce, ki ste jih morda nenamerno vnesli pri gradnji svoje rešitve.

Izrezek YAML (preverjevalnik)

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

Parametri (preverjevalnik)

Parametri Opis
PowerPlatformSPN
Povezava storitve		 (Obvezno) Povezava z okoljem Microsoft Power Platform licenco je potrebna za uporabo preverjevalnika za Power Platform. Povezave storitve so opredeljene v možnosti Povezave storitve v možnosti Nastavitve projekta, pri čemer je uporabljena vrsta povezave Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl pod Power Platform Ustvari okolje

Opomba: Za nalogo preverjalnika sta na voljo principal storitve in metode preverjanja pristnosti uporabniškega imena/gesla. Za več informacij o konfiguriranju glavnih imen storitev, ki se bodo uporabljala s tem opravilom, glejte Konfiguriranje povezav glavnega imena storitve za okolja Power Platform.
UseDefaultPACheckerEndpoint
Uporaba privzete končne točke preverjevalnika Power Platform		 Privzeto (true) geografska lokacija storitve preverjanja uporablja isto geografsko lokacijo kot okolje, s katerim se povezujete.
CustomPACheckerEndpoint
Končna točka preverjevalnika PAC po meri		 Obvezno, ko je UseDefaultPACheckerEndpointfalse. Za uporabo lahko določite drugo geografsko lokacijo, na primer https://japan.api.advisor.powerapps.com. Za seznam razpoložljivih geografskih območij glejte Uporaba Power Platform Checker API.
FileLocation
Lokacija datotek za analizo		 Zahtevano pri sklicevanju na datoteko iz URL-ja podpisa v skupni rabi (SAS) sasUriFile.

Opomba: pomembno je, da se sklicujete na izvoženo datoteko rešitve in ne na nepakirane izvorne datoteke v vašem repozitoriju. Analizirati je mogoče datoteke upravljanih in neupravljanih rešitev.
FilesToAnalyzeSasUri
Datoteke SAS za analiziranje		 Obvezno, ko je FileLocation nastavljeno na sasUriFile. Vnesite URI za SAS. Če želite dodati več kot en SAS URI, uporabite seznam, ločen z vejico (,) ali podpičjem (;).
FilesToAnalyze
Lokalne datoteke za analiziranje		 Zahtevano, če datoteke SAS niso analizirane. Navedite pot in ime datoteke za stisnjene datoteke za analizo. Uporabite lahko nadomestne znake. Vnesite na primer **\*.zip za vse datoteke zip v vseh podmapah.
FilesToExclude
Lokalne datoteke za izključitev		 Določite imena datotek, ki jih želite izključiti iz analize. Če jih je več, navedite seznam, ločen z vejico (,) ali s podpičjem (;). Ta seznam lahko vključuje polno ime datoteke ali ime z vodilnimi ali končnimi nadomestnimi znaki, kot sta *jquery ali form.js
RulesToOverride
Pravila za preglasitev		 Polje JSON, ki vsebuje pravila in ravni za preglasitev. Sprejete vrednosti za OverrideLevel so: kritično, visoko, srednje, nizko, informativno. Primer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Nabor pravil		 (Obvezno) Določite, kateri niz pravil naj se uporabi. Na voljo sta naslednja dva niza pravil:
  • Preverjevalnik rešitev: Ta nabor pravil je enak tistemu, ki se izvaja s portala Power Apps izdelovalca.
  • AppSource: Razširjen nabor pravil, ki se uporablja za potrjevanje aplikacije, preden se lahko objavi v AppSource.
ErrorLevel
Raven napak		 V kombinaciji z napako parameter praga določa resnost napak in opozoril, ki so dovoljena. Podprte so mejne vrednosti <level>IssueCount, kjer je raven = kritična, visoka, srednja, nizka in informativna.
ErrorThreshold
Prag napake		 Določa število napak (>=0) določene ravni, ki so dovoljene, da preverjevalnik prenese rešitve, ki se preverjajo.
FailOnPowerAppsCheckerAnalysisError
Neuspeh ob napaki		 Ko je nastavljeno na true, ne uspe, če se analiza preverjevalnika Power Apps vrne kot Failed ali FinishedWithErrors.
ArtifactDestinationName
Ime artefakta DevOps		 Podajte ime artefaktov Azure za datoteko .sarif za preverjanje.

Opravila rešitve

Ta nabor opravil lahko avtomatizira dejanja rešitve. Naloge okolja, opisane kasneje v tem razdelku, ki ustvarjajo, kopirajo ali obnavljajo okolje, prepišejo storitvene povezave z novo ustvarjenimi okolji. Te naloge omogočajo izvajanje nalog rešitve v okoljih, ki so ustvarjena na zahtevo.

Uvoz rešitve v storitvi Power Platform

Uvozi rešitev v ciljno okolje.

Izrezek YAML (uvoz)

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

Parametri (uvoz)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, v katero želite uvoziti rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, v katero želite uvoziti rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
SolutionInputFile
Vhodna datoteka rešitve		 (Obvezno) Pot in ime datoteke .zip rešitve za uvoz v ciljno okolje (na primer $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Opomba: Spremenljivke podajajo priročen način za vključevanje ključnih drobcev podatkov v različne dele prodajnega lijaka. Glejte Uporabite vnaprej določenih spremenljivk za celovit seznam.
HoldingSolution
Uvoz kot zadrževalna rešitev		 Predhodni parameter (true|false), ki se uporablja, ko je treba rešitev nadgraditi. Ta parameter gosti rešitev v storitvi Dataverse, vendar rešitve ne nadgradi, dokler se ne izvede opravilo »Uporabi nadgradnjo rešitve«.
OverwriteUnmanagedCustomizations
Prepis neupravljanih prilagoditev		 Določite, ali želite prepisati neupravljane prilagoditve (true|false).
SkipProductUpdateDependencies
Preskok odvisnosti posodobitev izdelka		 Določite, ali naj se uveljavljanje odvisnosti, povezanih s posodobitvami izdelkov, preskoči (true|false).
ConvertToManaged
Pretvorba v upravljano		 Določite, ali želite rešitev uvoziti kot upravljano rešitev (true|false).
AsyncOperation
Asinhroni uvoz		 Če je izbrano (true), bo operacija uvoza izvedena asinhrono. To je priporočljivo za večje rešitve, saj se to opravilo v nasprotnem primeru samodejno prekine po 4 minutah. Če izberete asinhrono, bo preverilo status in počakalo, dokler ni dosežen MaxAsyncWaitTime (true|false).
MaxAsyncWaitTime
Najdaljši čas čakanja		 Najdaljši čas čakanja v minutah za asinhrono operacijo; privzeto je 60 min (1 h), enako kot privzeto Azure DevOps za opravila.
PublishWorkflows
Aktivacija procesov po uvozu		 Določite, ali naj se po uvozu v rešitvi aktivirajo kateri koli procesi (poteki dela) (true|false).
UseDeploymentSettingsFile
Uporaba datoteke z nastavitvami uvajanja		 Sklice na povezave in vrednosti spremenljivk okolja lahko nastavite z uporabo datoteke z nastavitvami uvajanja (true|false).
DeploymentSettingsFile
Datoteka z nastavitvami uvajanja		 (Obvezno, ko je UseDeploymentSettingsFile=true) Pot in ime datoteke z nastavitvami uvajanja.

Power Platform Dodajte komponento rešitve

Doda komponento rešitve neupravljani rešitvi.

YAML izrezek (Dodaj)

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

Parametri (dodaj)

Parametri Description
ComponentId
ID komponente rešitve		 Ime sheme ali ID komponente, ki jo želite dodati ciljni rešitvi.
ComponentType
URL okolja storitve Power Platform		 Vrednost, ki predstavlja komponento rešitve, ki jo dodajate. Glejte Uporaba vnaprej določenih vrst komponent za izčrpen seznam vrednosti komponent.
SolutionUniqueName
Ime rešitve		 Enolično ime rešitve.
AddRequiredComponents
Vse komponente, ki jih zahteva druga rešitev, so odvisne od komponente rešitve		 (Izbirno) Označuje, ali je treba v neupravljano rešitev dodati tudi druge komponente rešitve, ki jih zahteva komponenta rešitve, ki jo dodajate.
Environment
URL ali ID okolja		 (Izbirno) URL okolja ali ID ciljnega okolja.

Uporabi nadgradnjo rešitve Power Platform

Nadgradi rešitev, ki je bila uvožena kot zadrževalna rešitev.

Izrezek YAML (nadgradnja)

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

Parametri (nadgradnja)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, v katero želite nadgraditi rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, v katero želite nadgraditi rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
SolutionName
Ime rešitve		 (Obvezno) Ime rešitve za uporabo nadgradnje. Vedno uporabite rešitev Ime, in ne Prikazano ime.
AsyncOperation
Asinhrona nadgradnja		 Če je izbrano (true), bo operacija nadgradnje izvedena kot asinhrono paketno opravilo. Če izberete asinhrono, bo preverilo status in počakalo, dokler ni dosežen MaxAsyncWaitTime.
MaxAsyncWaitTime
Najdaljši čas čakanja		 Najdaljši čas čakanja v minutah za asinhrono operacijo; privzeto je 60 min (1 h), enako kot privzeto Azure DevOps za opravila.

opomba,

Spremenljivke podajajo priročen način za vključevanje ključnih drobcev podatkov v različne dele prodajnega lijaka. Glejte Uporabite vnaprej določenih spremenljivk za celovit seznam. Informacije o sklicu na povezavo in spremenljivkah okolja za ciljno okolje lahko izpolnite vnaprej, in sicer med uvozom rešitve z datoteko z nastavitvami uvajanja.

Več informacij: Predhodno izpolnjevanje sklicev na povezave in spremenljivk okolja za samodejno uvajanje

Izvoz rešitve v storitvi Power Platform

Izvozi rešitev iz izvornega okolja.

Izrezek YAML (izvoz)

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

Parametri (izvoz)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, v katero želite nadgraditi rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, v katero želite nadgraditi rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
SolutionName
Ime rešitve		 (Obvezno) Ime rešitve za izvoz. Vedno uporabite rešitev Ime, in ne Prikazano ime.
SolutionOutputFile
Izhodna datoteka rešitve		 (Obvezno) Pot in ime datoteke solution.zip, v katero želite izvoziti izvorno okolje (na primer $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Opomba: Spremenljivke podajajo priročen način za vključevanje ključnih drobcev podatkov v različne dele prodajnega lijaka. Glejte Uporabite vnaprej določenih spremenljivk za celovit seznam.
AsyncOperation
Asinhroni izvoz		 Če je izbrano (true), bo operacija izvoza izvedena kot asinhrono paketno opravilo. Če izberete asinhrono, bo preverilo status in počakalo, dokler ni dosežen MaxAsyncWaitTime.
MaxAsyncWaitTime
Najdaljši čas čakanja		 Najdaljši čas čakanja v minutah za asinhrono operacijo; privzeto je 60 min (1 h), enako kot privzeto Azure DevOps za opravila.
Managed
Izvozi kot upravljano		 Če je izbrano (true), izvozite rešitev kot upravljano rešitev; sicer izvozite kot neupravljano rešitev.
ExportAutoNumberingSettings
Izvoz nastavitev samodejnega oštevilčenja		 Izvoz nastavitev samodejnega oštevilčenja (true|false).
ExportCalendarSettings
Izvoz nastavitev koledarja		 Izvoz nastavitev koledarja (true|false).
ExportCustomizationSettings
Izvoz nastavitev prilagajanja		 Izvoz nastavitev za prilagoditev (true|false).
ExportEmailTrackingSettings
Izvoz nastavitev sledenja e-pošti		 Izvoz nastavitev za sledenje e-pošti (true|false).
ExportGeneralSettings
Izvoz splošnih nastavitev		 Izvoz splošnih nastavitev (true|false).
ExportIsvConfig
Izvoz konfiguracije ISV		 Izvoz konfiguracije ISV (true|false).
ExportMarketingSettings
Izvoz nastavitev za trženje		 Izvoz nastavitev za trženje (true|false).
ExportOutlookSynchronizationSettings
Izvoz nastavitev sinhronizacije s programom Outlook		 Izvoz nastavitev sinhronizacije s programom Outlook (true|false).
ExportRelationshipRoles
Izvoz vlog odnosa		 Izvoz vlog odnosov (true|false).
ExportSales
Izvozna prodaja		 Izvoz podatkov o prodaji (true|false).

Razpakiranje rešitve v storitvi Power Platform

Vzame datoteko s stisnjeno rešitvijo in jo razstavi na več datotek XML in drugih datotek, da lahko sistem za upravljanje izvorne kode lažje prebere in upravlja te datoteke.

Izrezek YAML (razpakiranje)

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

Parametri (razpakiranje)

Parametri Opis
SolutionInputFile
Vhodna datoteka rešitve		 (Obvezno) Pot in ime datoteke za datoteko solution.zip za razpakiranje.
SolutionTargetFolder
Ciljna mapa za razpakiranje rešitve		 (Obvezno) Pot in ciljna mapa, v katero želite razpakirati rešitev.
SolutionType
Vrsta rešitve		 (Obvezno) Vrsta rešitve, ki jo želite razpakirati. Možnosti vključujejo: Neupravljano (priporočljivo), Upravljano in Oboje.

Pakiranje rešitve v storitvi Power Platform

Zapakira rešitev, ki je prikazana v upravljanju izvorne kode, v datoteko solution.zip, ki jo je mogoče uvoziti v drugo okolje.

Izrezek YAML (pakiranje)

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

Parametri (pakiranje)

Parametri Opis
SolutionOutputFile
Izhodna datoteka rešitve		 (Obvezno) Pot in ime datoteke za datoteko solution.zip, v katero zapakirate rešitev.
SolutionSourceFolder
Izvorna mapa rešitve za pakiranje		 (Obvezno) Pot in izvorna mapa rešitve za pakiranje.
SolutionType
Vrsta rešitve		 (Obvezno) Vrsta rešitve, ki jo želite zapakirati. Možnosti vključujejo: Upravljano (priporočljivo), Neupravljano in Oboje.

Brisanje rešitve Power Platform

Izbriše rešitev v ciljnem okolju.

Izrezek YAML (izbris)

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'

Parametri (izbris)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite izbrisati rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite izbrisati rešitev (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
SolutionName
Ime rešitve		 (Obvezno) Ime rešitve za izbris. Vedno uporabite rešitev Ime, in ne Prikazano ime.

Objavljanje prilagoditev v storitvi Power Platform

Objavi vse prilagoditve v okolju.

Izrezek YAML (objava)

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

Parametri (objava)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite objaviti prilagoditve (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite objaviti prilagoditve (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform

Nastavitev različice rešitve v storitvi Power Platform

Posodobi različico rešitve.

Izrezek YAML (različica)

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

Parametri (različica)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite nastaviti različico rešitve (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite nastaviti različico rešitve (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
SolutionName
Ime rešitve		 (Obvezno) Ime rešitve za nastavitev različice. Vedno uporabite rešitev Ime, in ne Prikazano ime.
SolutionVersionNumber
Številka različice rešitve		 (Obvezno) Številka različice, ki jo želite nastaviti.

Čeprav je številko različice mogoče fiksno kodirati v prodajnem lijaku, je priporočljivo uporabiti spremenljivko prodajnega lijaka Azure DevOps, kot je BuildId. To ponuja možnosti za določitev natančne oblike številke različice v zavihku »Možnosti«, na primer: (leto: yyyy) $–(mesec: MM) $–(dan: dd) $–(rev: rr) $–3

To definicijo lahko nato uporabi opravilo različice nastavitve rešitve z nastavitvijo lastnosti številke različice z: $(Build.BuildId) namesto zakodiranja 20200824.0.0.2.

Druga možnost je, da je izhodni skript vstavljenega opravila PowerShell $(Get-Date -Format yyyy.MM.dd.HHmm) nastavljen na prazno spremenljivko z imenom SolutionVersion kot Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"). Nastavite različico rešitve kot $(SolutionVersion).

Power Platform Nastavite spremenljivke povezave

Nastavi spremenljivke BuildTools.* za zagotavljanje dostopa do nalog skripta po meri za uporabo storitvene povezave kot enega vira resnice.

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

Parametri (SetConnectionVariables)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite nastaviti spremenljivke povezave. Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
timeoutInMinutes
Časovna omejitev		 Podaja najdaljši čas v minutah, ki ga lahko opravilo izvede, preden ga strežnik prekliče. Vrednost nič pomeni neskončno časovno omejitev.
retryCountOnTaskFailure
Število ponovnih poskusov, če opravilo ni uspelo		 Podaja število ponovnih poskusov za to opravilo, ki se bo zgodilo v primeru neuspešnega opravila. Ni podprto za opravila brez agentov.
ApplicationId
ID aplikacije za prijavo		 (Zahtevano za uporabniško ime/geslo) ID aplikacije za prijavo (Glejte dodatno opombo spodaj).
RedirectUri
Preusmeritev URI določene aplikacije		 (Zahtevano za uporabniško ime/geslo) URI preusmeritve navedene aplikacije. Potreben pri podajanju ID-ja aplikacije. (Glejte dodatno opombo spodaj).

opomba,

Pri uporabi vrste preverjanja pristnosti z uporabniškim imenom/geslom bosta potrebna ID aplikacije in Uri preusmeritve. Ta avtentikacija oauth dokument vsebuje razlago, zakaj morate ustvariti registracijo aplikacije za preverjanje pristnosti Dataverse. Ko se povežete s preverjanjem pristnosti z uporabniškim imenom/geslom, se povezava obnaša kot aplikacija, ki se povezuje v imenu uporabnika Dataverse.

Uvedba paketa v storitvi Power Platform

Uvede paket v okolje. Uvajanje paketa vam v nasprotju z uvajanjem ene datoteke rešitve zagotavlja možnost, da v okolje uvedete več rešitev, podatkov in kode.

Izrezek YAML (uvajanje)

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

Parametri (uvajanje)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, v katero želite razmestiti paket (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, v katero želite razmestiti paket (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform. Več informacij: glejte BuildTools.EnvironmentUrl v razdelku Ustvarjanje okolja Power Platform
PackageFile
Datoteka paketa		 (Obvezno) Pot in ime datoteke zbira paketne datoteke (.dll).
MaxAsyncWaitTime
Najdaljši čas čakanja		 Najdaljši čas čakanja v minutah za asinhrono operacijo; privzeto je 60 min (1 h), enako kot privzeto Azure DevOps za opravila.

Opravila upravljanja okolja

Avtomatizirajte skupna opravila upravljanja življenjskega cikla okolja (ELM).

Ustvarjanje okolja v storitvi Power Platform

Ustvari novo okolje. Ustvarjanje novega okolja tudi samodejno ustvari BuildTools.EnvironmentUrl.

Pomembno

Ko je nastavljeno, bo BuildTools.EnvironmentUrl uporabljen kot privzeta povezava storitve za nadaljnja opravila v prodajnem lijaku. Vsako opravilo, opisano v tem članku, uporablja končno točko iz povezave storitve samo, ko BuildTools.EnvironmentUrl ni nastavljen.

Novo okolje je lahko omogočeno samo, če vaša licenca ali zmogljivost omogočata ustvarjanje dodatnih okolij. Za več informacij o tem, kako si ogledate zmogljivosti, glejte Podrobnosti strani o zmogljivosti.

Izrezek YAML (Create-env)

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

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

Parametri (Create-env)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite ustvariti okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite ustvariti okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
DisplayName
Prikazno ime		 (Obvezno) Prikazno ime okolja je ustvarjeno.
LocationName
Območje uvajanja		 (Obvezno) Območje, v katerem je treba ustvariti okolje.
EnvironmentSku
Vrsta okolja		 (Obvezno) Vrsta primerka za uvajanje. Možnosti so Preskusno okolje, Proizvodnja, Preskus in SubscriptionBasedTrial.
AppsTemplate
Aplikacije		 Za vrsto okolja brez preskusa so podprte aplikacije D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation in D365_Sales.
CurrencyName
Valuta		 (Obvezno) Osnovna valuta za ustvarjeno okolje. Po tem ko je okolje ustvarjeno, valute ni mogoče posodobiti.
LanguageName
Language		 (Obvezno) Osnovni jezik v okolju.
DomainName
Ime domene		 (Obvezno) To je niz, specifičen za okolje, ki oblikuje del URL-ja. Na primer, za okolje z naslednjim URL-jem: https://powerappsbuildtasks.crm.dynamics.com/ bi bilo ime domene »powerappsbuildtasks«.

Opomba: če vnesete ime domene, ki je že v uporabi, opravilo pripne številsko vrednost imenu domene, z začetkom pri 0. Za zgornji primer lahko URL postanehttps://powerappsbuildtasks0.crm.dynamics.com/.

Izbris okolja v storitvi Power Platform

Izbriše okolje.

Izrezek YAML (Delete-env)

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

Parametri (Delete-env)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite izbrisati okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite izbrisati okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.

Power Platform Dodeli uporabnika

Dodelite uporabnika ciljnemu okolju z določenim varnostna vloga.

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

Parametri (AssignUser-env)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, ki mu želite dodeliti uporabnika (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
User
Power Platform uporabniško ime		 Microsoft Entra ID objekta ali glavno ime uporabnika za dodelitev ciljnemu okolju.
Role
Varnostna vloga ime ali ID		 Varnostna vloga ime ali ID, ki se dodeli uporabniku.
ApplicationUser
Power Platform uporabniško ime aplikacije		 Podaja, ali je vhodni uporabnik uporabnik aplikacije (true|false).

Power Platform Ponastavi okolje

Ponastavi okolje.

YAML izrezek (Ponastavi-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'

Parametri (Reset-env)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite ponastaviti okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite ponastaviti okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.

Varnostno kopiranje okolja v storitvi Power Platform

Varnostno kopira okolje.

Izrezek YAML (Backup-env)

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

Parametri (Backup-env)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka, za katero želite varnostno kopirati okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka, za katero želite varnostno kopirati okolje (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
BackupLabel
Oznaka varnostnega kopiranja		 (Obvezno) Oznaka, ki bo dodeljena varnostni kopiji.

Kopiranje okolja v storitvi Power Platform

Kopira okolje v ciljno okolje. Na voljo sta dve vrsti kopij: polna in minimalna. Polna kopija vključuje podatke in metapodatke rešitve (prilagoditve), medtem ko minimalna kopija vključuje samo metapodatke rešitve in ne dejanskih podatkov.

Izrezek YAML (Copy-env)

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

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

Parametri (Copy-env)

Parametri Opis
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka za izvorno okolje, iz katerega želite kopirati (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za izvorno okolje, iz katerega želite kopirati (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
TargetEnvironmentUrl
URL ciljnega okolja		 (Obvezno) URL za ciljno okolje, v katerega želite kopirati.
CopyType
Vrsta kopije		 Vrsta kopije za uporabo: FullCopy ali MinimalCopy
OverrideFriendlyName
Preglasitev prijaznega imena		 Sprememba prijaznega imena ciljnega okolja v drugo ime (true|false).
FriendlyName
Prijazno ime		 Prijazno ime ciljnega okolja.
DisableAdminMode
Onemogočanje skrbniškega načina		 Ali je treba onemogočiti skrbniški način (true|false).

Power Platform Obnovi okolje

Obnovi okolje na dano varnostno kopijo.

YAML izrezek (Obnovi-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'

Parametri (Restore-env)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Storitev končna točka za izvorno okolje, iz katerega želite obnoviti (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za izvorno okolje, iz katerega želite obnoviti (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
RestoreLatestBackup
Najnovejša varnostna kopija za obnovitev		 Ali želite obnoviti zadnjo varnostno kopijo ali zagotoviti RestoreTimeStamp (true|false).
RestoreTimeStamp
Datum in čas varnostne kopije		 Datum in ura varnostne kopije v obliki »mm/dd/llll hh:mm« ALI niz »najnovejši«.
TargetEnvironmentUrl
URL ciljnega okolja		 (Obvezno) URL za ciljno okolje, ki ga želite obnoviti.
FriendlyName
Ime obnovljenega okolja		 (Izbirno) Ime obnovljenega okolja.
DisableAdminMode
Onemogočanje skrbniškega načina		 Ali je treba onemogočiti skrbniški način (true|false).

Izvoz Dataverse podatkov

Izvozite podatke iz okolja s podano shemo.

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

Parametri (exportdata-env)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, iz katerega želite izvoziti podatke (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
SchemaFile
Ime datoteke XML sheme		 Ime datoteke XML sheme. Ustvarite ga lahko z orodjem za selitev konfiguracije.
DataFile
Ime podatkovne datoteke		 Ime datoteke za podatke za izvoz (datoteka zip).
Overwrite
Prepisovanje vsebine		 Power Pages vsebino spletne strani, ki jo želite prepisati (true|false).

Uvoz Dataverse podatkov

Uvozite podatke v okolje.

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

Parametri (importdata-env)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, v katerega želite uvoziti podatke (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
DataFile
Ime podatkovne datoteke		 Ime datoteke za stisnjeno zip) podatkovno datoteko za uvoz ali mapo z data-schema.xml in data.xml za uvoz.

Power Pages vodstvene naloge

Naloge za delo s Power Pages spletno stranjo.

Power Platform - prenos PAPortal

Prenos vsebine spletnega mesta Power Pages iz trenutnega okolja Dataverse.

YAML izrezek (portal za prenos)

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

Parametri (download-paportal)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, iz katerega želite prenesti vsebino (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
WebsiteId
ID spletnega mesta portala		 Power Pages ID spletnega mesta za prenos.
Overwrite
Prepisovanje vsebine		 Power Pages vsebino spletne strani, ki jo želite prepisati (true|false).
ModelVersion
Podatkovni model mesta		 Označuje, ali bodo podatki mesta, ki bodo naloženi, uporabljali standardni (1) ali izboljšan podatkovni model (2). Privzeta vrednost je '1'.

Power Platform - nalaganje PAPortal

Naloži Power Pages vsebino spletne strani v trenutno Dataverse okolje.

YAML izrezek (portal za nalaganje)

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'

Parametri (upload-paportal)

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, v katerega želite naložiti vsebino (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
UploadPath
Pot do naložene vsebine		 Pot, od koder bo Power Pages naložena vsebina spletnega mesta.
ModelVersion
Podatkovni model mesta		 Označuje, ali bodo podatki mesta, ki bodo naloženi, uporabljali standardni (1) ali izboljšan podatkovni model (2). Privzeta vrednost je '1'.

Katalog Power Platform nalog (predogled)

Te naloge izvajajo dejanja proti katalogu v Power Platform in vključujejo naslednje.

opomba,

Trenutno so naloge kataloga za Power Platform predogled izdaja.

Namestite element kataloga

Namestite element kataloga v ciljno okolje.

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, v katerega želite naložiti vsebino (na primer https://powerappsbuildtools.crm.dynamics.com). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
Environment
URL ciljnega okolja		 (Obvezno) URL okolja, na katerega cilja ta naloga.
CatalogItemId
ID elementa kataloga, ki bo nameščen		 (Obvezno) Element kataloga, ki bo nameščen v ciljnem okolju.
TargetEnvironmentUrl
URL ciljnega okolja		 (Obvezno) Url ciljnega okolja za namestitev elementa kataloga v (na primer, "https://YourOrg.crm.dynamics.com").
PollStatus
Preverite status ankete		 (Izbirno) Anketa za preverjanje stanja vaše zahteve (true|false).

Parametri (katalog-namestitev)

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

Predložite odobritev kataloga

Pošljite zahtevo za odobritev kataloga.

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, v katerega želite naložiti vsebino (na primer »https://powerappsbuildtools.crm.dynamics.com«). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
Environment
URL ciljnega okolja		 (Obvezno) URL okolja, na katerega cilja ta naloga.
CatalogSubmissionFile
Datoteka za oddajo kataloga		 (Obvezno) Določite pot in ime datoteke datoteke za oddajo kataloga.
UsePackageSolutionZipFile
Vrsta datoteke		 Vrsta datoteke: zip datoteka paketa ali rešitve.
SolutionZipFile
Ime zip datoteke rešitve		 Določite pot in ime datoteke zip datoteke rešitve.
PollStatus
Preverite status ankete		 (Izbirno) Anketa za preverjanje stanja vaše zahteve (true|false).

Parametri (katalog-oddaja)

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

Status zahteve za katalog

Pridobite status zahteve za namestitev/oddajo kataloga.

Parametri Description
authenticationType
Vrsta preverjanja pristnosti		 (Obvezno za SPN) Določite katero koli PowerPlatformEnvironment za povezavo z uporabniškim imenom/geslom ali PowerPlatformSPN za skrivno povezavo glavno ime storitve/odjemalec.
PowerPlatformSPN
Glavno ime storitve Power Platform		 Storitev končna točka za okolje, v katerega želite naložiti vsebino (na primer »https://powerappsbuildtools.crm.dynamics.com«). Določeno pod možnostjo Povezave storitve v razdelku Nastavitve projekta z uporabo vrste povezave storitve Power Platform.
Environment
URL ciljnega okolja		 (Obvezno) URL okolja, na katerega cilja ta naloga.
TrackingId
Zahtevajte ID za sledenje		 (Obvezno) Zahtevajte ID za sledenje.
RequestType
Vrsta zahteve		 (Obvezno) Vrsta zahteve. (Vrednosti: Namesti | Predloži).

Parametri (status kataloga)

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

Graditev in sprostitev prodajnih lijakov

Zdaj ko smo prepoznali, kaj je mogoče narediti z orodji za graditev, si oglejmo, kako lahko ta orodja uporabite za graditev in sprostitev prodajnih lijakov. Spodaj je prikazan konceptualni pregled. Oglejmo si nekaj podrobnosti uvajanja prodajnega lijaka z uporabo opravil orodij za graditev v podrazdelkih, ki sledijo.

Če želite izvedeti več o ustvarjanju teh prodajnih lijakov in dejansko izvesti praktično ustvarjanje prodajnega lijaka z uporabo orodij za graditev Microsoft Power Platform, opravite preizkus za orodja, ki ga lahko prenesete iz storitve GitHub.

Več informacij o Azure Pipelines: Uporabite Azure Pipelines

Prodajni lijak za graditev: Izvoz rešitve iz razvojnega okolja (DEV)

Naslednja slika prikazuje opravila orodja za graditev, ki jih lahko dodate v prodajni lijak, ki izvozi rešitev iz razvojnega okolja.

Izvoz rešitve iz razvojnega okolja (DEV).

Prodajni lijak za graditev: Graditev upravljane rešitve

Naslednja slika prikazuje opravila orodja za graditev, ki jih lahko dodate v prodajni lijak, ki zgradi upravljano rešitev.

Zgradite upravljana rešitev.

Sprostitev prodajnega lijaka: Uvedba v produkcijsko okolje (PROD)

Naslednja slika prikazuje opravila orodja za graditev, ki jih lahko dodate v prodajni lijak, ki uvaja v produkcijsko okolje.

Namestitev v produkcijsko okolje (PROD).

Glejte tudi

Microsoft Power Platform Build Tools za Azure DevOps