Naloge Microsoft Power Platform Build Tools

V spodnjih razdelkih so opisana opravila delovne različice, ki so na voljo. Pozneje predstavimo nekaj primerov, Azure Pipelines uporabljajo ta opravila. Za informacije o orodjih za gradnjo in kako jih prenesti glejte Microsoft Power Platform Build Tools for Azure Pipelines.

Opravilo pomočnika

V spodnjih razdelkih so opisana opravila, ki so na voljo za pomoč uporabnikom.

Nameščanje orodij v storitvi Power Platform

To opravilo dodajte enkrat pred vsa druga opravila orodij za ustvarjanje platforme Power Platform v cevovodih za gradnjo in izdajo. Ta naloga namesti nabor orodij, specifičnih za Power Platform, ki jih agent potrebuje za izvajanje nalog gradnje Microsoft Power Platform. Ta naloga po dodajanju ne zahteva dodatne konfiguracije. To opravilo vsebuje parametre za določene različice vsakega od orodij, ki jih namesti.

Če želite biti na tekočem z različicami orodij, se prepričajte, da ti parametri ustrezajo različicam orodij, ki so potrebna za pravilno delovanje cevovoda.

Izrezek YAML (namestitveni program)

# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'

# Installs default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    DefaultVersion: false
    XrmToolingPackageDeploymentVersion: 3.3.0.928

Parametri (namestitveni program)

Parametri Description
DefaultVersion
Uporaba privzetih različic orodja		 Nastavite true, če želite uporabiti privzeto različico vseh orodij, sicer pa false. Zahtevano ( in neresnično), ko določite katero koli različico orodja.
AddToolsToPath
Dodajanje orodij na pot		 Doda pac CLI spremenljivki PATH okolja. Pac CLI lahko uporabite iz skriptnih opravil, ne da bi vam bilo treba ročno nastaviti pot.
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@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'

Parametri (WhoAmI)

Parametri Description
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. Če želite več informacij, glejte razdelek BuildTools.EnvironmentUrlUstvarjanje okolja platforme Power
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. Če želite več informacij, glejte razdelek BuildTools.EnvironmentUrlUstvarjanje okolja platforme Power
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 na voljo naloge za preverjanje kakovosti rešitve.

Preverjevalnik Power Platform

To opravilo izvede statično analizo preverjanja rešitev v skladu z naborom pravil najboljše prakse za prepoznavanje morebitnih težavnih vzorcev, ki jih lahko nenamerno uvedete pri ustvarjanju rešitve.

Izrezek YAML (preverjevalnik)

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

Parametri (preverjevalnik)

Parametri Description
PowerPlatformSPN
Povezava storitve		 (Zahtevano) Če želite uporabljati preverjevalnik platforme Power Platform, potrebujete povezavo z licenciranim Microsoft Power Platform okolje. Določite povezave storitev v povezavah storitve v razdelku Project nastavitve z vrsto povezave Power Platform. Če želite več informacij, glejte razdelek BuildTools.EnvironmentUrlUstvarjanje okolja platforme Power.

Opomba: Opravilo preverjevalnika podpira glavno ime storitve in načine preverjanja pristnosti uporabniškega imena/gesla. Če želite več informacij o konfiguriranju upravnikov varnosti storitve za to opravilo, glejte Konfiguracija glavnih povezav storitve za okolja platforme 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. Navedite drugo geografijo, ki jo želite uporabiti, https://japan.api.advisor.powerapps.com. na primer Seznam razpoložljivih geografskih podatkov najdete v članku Uporaba API-ja preverjevalnika platforme Power.
FileLocation
Lokacija datotek za analizo		 Zahtevano pri sklicevanju na datoteko iz URL-ja s podpisom za dostop v skupni rabi (SAS sasUriFile).

Opomba: Sklic na izvoženo datoteko rešitve in ne izpakiranih izvornih datotek v skladišču. Analizirate lahko upravljane in neupravljane datoteke rešitev.
FilesToAnalyzeSasUri
Datoteke SAS za analiziranje		 Obvezno, ko je FileLocation nastavljeno na sasUriFile. Vnesite URI za SAS. Z vejico (,) ali podpičjem (na ločenem seznamu) lahko ;) VEČ URI-jev SAS.
FilesToAnalyze
Lokalne datoteke za analiziranje		 Zahtevano, kadar datoteke SAS niso analizirane. Navedite pot in ime datoteke za stisnjene datoteke za analizo. Uporabite lahko nadomestne znake. Na primer, vnesite **\*.zip za vse zip datoteke v vseh podmapah.
FilesToExclude
Lokalne datoteke za izključitev		 Navedite imena datotek, ki jih želite izključiti iz analize. Če določite več kot eno datoteko, uporabite vejico (,) ali podpičje (;) ločen seznam. Ta seznam lahko vključuje polno ime datoteke ali ime z začetnimi ali končnimi nadomestnimi znaki, kot je *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 naboru, ki se izvaja s portala Power Apps maker.
  • Marketplace: Razširjen nabor pravil, ki se uporablja za potrditev prijave, preden je lahko objavljena na Marketplace.
ErrorLevel
Raven napak		 V kombinaciji s parametrom praga napake ta vrednost določa resnost dovoljenih napak in opozoril. 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		 Če je vrednost »true«, Power Apps »Preverjevalnik« vrne »Ni uspelo« ali »FinishedWithErrors«.
ArtifactDestinationName
Ime artefakta DevOps		 Določite ime Azure Artifacts za datoteko .sarif checker.

Opravila rešitve

Ta nabor opravil avtomatizira dejanja rešitve. Okoljska opravila, opisana v nadaljevanju tega razdelka, ki ustvarjajo, kopirajo ali obnavljajo okolje, prepišejo storitvene povezave z novo ustvarjenimi okolji. S temi opravili lahko izvajate opravila rešitev v okoljih, ki jih ustvarite 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@2
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
  displayName: 'Power Platform Import Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    AsyncOperation: true
    MaxAsyncWaitTime: 60
    PublishWorkflows: false

Parametri (uvoz)

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		 Končna točka storitve, 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		 Končna točka storitve, 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 rešitve .zip, ki jo želite uvoziti v ciljno okolje (na primer $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Opomba: Spremenljivke vam omogočajo priročen način za vnos ključnih podatkov v različne dele vašega prodajnega procesa. 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		 Zastarelo. Sistem bo neupravljane komponente rešitve pretvoril v upravljane, ko uvozite upravljano rešitev.
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		 Največji čas čakanja v minutah za asinhrono operacijo; privzeto je 60 minut (1 uro), enako kot privzeto v Azure DevOps za naloge.
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 Dodaj komponento rešitve

Doda komponento rešitve neupravljani rešitvi.

Odrezek YAML (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. Za celovit seznam vrednosti komponent glejte poglavje *Uporaba vnaprej določenih tipov komponent*. ...
SolutionUniqueName
Ime rešitve		 Edinstveno ime rešitve.
AddRequiredComponents
Vse komponente, potrebne iz druge rešitve, ki so odvisne od komponente rešitve		 (Neobvezno) Označuje, ali je treba neupravljani rešitvi dodati tudi druge komponente rešitve, ki jih zahteva komponenta rešitve, ki jo dodajate.
Environment
URL ali ID okolja		 (Neobvezno) URL ali ID okolja 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@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

Parametri (nadgradnja)

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		 Končna točka storitve, 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		 Končna točka storitve, 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		 Največji čas čakanja v minutah za asinhrono operacijo; privzeto je 60 minut (1 uro), enako kot privzeto v Azure DevOps za naloge.

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

Parametri (izvoz)

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		 Končna točka storitve, 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		 Končna točka storitve, 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 vam omogočajo priročen način za vnos ključnih podatkov v različne dele vašega prodajnega procesa. 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		 Največji čas čakanja v minutah za asinhrono operacijo; privzeto je 60 minut (1 uro), enako kot privzeto v Azure DevOps za naloge.
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
Izvozi nastavitve sinhronizacije Outlook		 Izvoz nastavitev sinhronizacije 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@2
  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 Description
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@2
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Parametri (pakiranje)

Parametri Description
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@2
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Parametri (izbris)

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		 Končna točka storitve, iz katere ž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		 Končna točka storitve, iz katere ž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@2
  displayName: 'Power Platform Publish Customizations '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '

Parametri (objava)

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		 Končna točka storitve, 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		 Končna točka storitve, 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@2
  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 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		 Končna točka storitve, 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		 Končna točka storitve, 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 mogoče številko različice trdo zakodirati v cevovodu, je priporočljivo uporabiti Azure DevOps spremenljivko, 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 Nastavitev spremenljivk povezave

Nastavi PowerPlatformSetConnectionVariables.BuildTools.* spremenljivke, ki omogočajo dostop do skriptnih opravil po meri za uporabo storitvene povezave kot enega samega vira resnice.

Nastavljene so naslednje spremenljivke:

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

Odrezek YAML (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		 Končna točka storitve, 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		 Določa najdaljši čas v minutah, ki ga je dovoljeno izvesti opravilo, preden ga strežnik prekliče. Ničelna vrednost pomeni neskončno časovno omejitev.
retryCountOnTaskFailure
Število ponovnih poskusov, če naloga ni uspela		 Določa število ponovnih poskusov za to nalogo, ki se bodo zgodili v primeru neuspeha naloge. Ni podprto za naloge brez agenta.
ApplicationId
ID aplikacije za prijavo		 (Obvezno za uporabniško ime/geslo) ID aplikacije, ki se uporablja za prijavo (glejte dodatno opombo spodaj).
RedirectUri
URI preusmeritve določene aplikacije		 (Obvezno za uporabniško ime/geslo) URI preusmeritve določene aplikacije. Potrebno pri določanju ID-ja aplikacije. (Glejte dodatno opombo spodaj).

opomba,

Pri uporabi overjanja z uporabniškim imenom/geslom bosta potrebna ID aplikacije in URI preusmeritve. Ta dokument o overjanju z uporabo oauth vsebuje razlago, zakaj morate ustvariti registracijo aplikacije za overjanje . Dataverse Ko se povežete z uporabo preverjanja 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@2
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parametri (uvajanje)

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		 Končna točka storitve, v katero želite namestiti 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		 Končna točka storitve, v katero želite namestiti 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		 Največji čas čakanja v minutah za asinhrono operacijo; privzeto je 60 minut (1 uro), enako kot privzeto v Azure DevOps za naloge.

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 mogoče zagotoviti le, če vaša licenca ali zmogljivost omogoča 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@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

Parametri (Create-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		 Končna točka storitve, 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		 Končna točka storitve, 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, naloga doda številsko vrednost imenu domene, začenši z 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@2
  displayName: 'Power Platform Delete Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'

Parametri (Delete-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		 Končna točka storitve, iz katere ž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		 Končna točka storitve, iz katere ž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čeno varnostno vlogo.

Odrezek YAML (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		 Končna točka storitve 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 uporabniško ime za dodelitev ciljnemu okolju.
Role
Ime ali ID varnostne vloge		 Ime ali ID varnostne vloge, ki bo dodeljen uporabniku.
ApplicationUser
Power Platform uporabniško ime aplikacije		 Določa, ali je vhodni uporabnik uporabnik aplikacije (true|false).

Power Platform Ponastavi okolje

Ponastavi okolje.

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

Parametri (Ponastavi 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.
PowerPlatformEnvironment
URL okolja storitve Power Platform		 Končna točka storitve, 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		 Končna točka storitve, 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@2
  displayName: 'Power Platform Backup Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    BackupLabel: 'Full backup - $(Build.BuildNumber)'

Parametri (Backup-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		 Končna točka storitve, 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		 Končna točka storitve, 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@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

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

Parametri (Copy-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		 Končna točka storitve 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		 Končna točka storitve 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.
SkipAuditData
Preskoči podatke revizije		 Ali naj se med kopiranjem preskočijo podatki revizije. (pravilno|napačno).
MaxAsyncWaitTime
Najdaljši čas čakanja		 Največji čas čakanja v minutah za asinhrono operacijo; privzeto je 60 minut (1 uro), enako kot privzeto v Azure DevOps za naloge.

Power Platform Obnovi okolje

Obnovi okolje na dano varnostno kopijo.

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

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		 Končna točka storitve 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		 Končna točka storitve 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 naj se obnovi najnovejša varnostna kopija ali naj se navede 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 ciljnega okolja, ki ga želite obnoviti.
FriendlyName
Ime obnovljenega okolja		 (Neobvezno) Ime obnovljenega okolja.
DisableAdminMode
Onemogočanje skrbniškega načina		 Ali je treba onemogočiti skrbniški način (true|false).

Izvoz podatkov Dataverse

Izvozite podatke iz okolja s podano shemo.

Odrezek YAML (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		 Končna točka storitve 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 sheme XML. Ustvariti ga je mogoče z orodjem za migracijo konfiguracije.
DataFile
Ime podatkovne datoteke		 Ime datoteke za podatke za izvoz (zip datoteka).
Overwrite
Prepisovanje vsebine		 Power Pages vsebina na spletni strani za prepisovanje (res|napačno).

Uvoz podatkov Dataverse

Uvozite podatke v okolje.

Odrezek YAML (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		 Končna točka storitve za okolje, iz 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 podatkovno datoteko (zip), ki jo želite uvoziti, ali mapa s datotekama data-schema.xml in data.xml, ki ju želite uvoziti.

Naloge upravljanja Power Pages

Naloge za delo s spletno stranjo Power Pages.

Power Platform - prenos PAPortal

Prenos vsebine spletnega mesta Power Pages iz trenutnega okolja Dataverse.

Odrezek YAML (prenos-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

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		 Končna točka storitve 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		 ID spletne strani Power Pages za prenos.
Overwrite
Prepisovanje vsebine		 Power Pages vsebina na spletni strani za prepisovanje (res|napačno).
ModelVersion
Model podatkov spletnega mesta		 Označuje, ali bodo podatki spletnega mesta, ki bodo naloženi, uporabljali standardni (1) ali izboljšan podatkovni model (2). Privzeta vrednost je '1'.

Power Platform - nalaganje PAPortal

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

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

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		 Končna točka storitve 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 nalaganja vsebine		 Pot, od koder bo vsebina spletne strani Power Pages naložena.
ModelVersion
Model podatkov spletnega mesta		 Označuje, ali bodo podatki spletnega mesta, ki bodo naloženi, uporabljali standardni (1) ali izboljšan podatkovni model (2). Privzeta vrednost je '1'.

Katalog za opravila (predogled) Power Platform

Ta opravila izvajajo dejanja v katalogu v Power Platform in vključujejo naslednje.

opomba,

Trenutno so naloge katalogizacije za Power Platform predogledna izdaja.

Namestitev artikla iz 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		 Končna točka storitve 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 artikla v katalogu, ki ga je treba namestiti		 (Obvezno) Element kataloga, ki ga je treba namestiti v ciljno okolje.
TargetEnvironmentUrl
URL ciljnega okolja		 (Obvezno) URL ciljnega okolja za namestitev elementa kataloga (na primer »https://YourOrg.crm.dynamics.com«).
PollStatus
Preveri stanje ankete		 (Neobvezno) Anketa za preverjanje stanja vaše zahteve (true|false).

Parametri (namestitev kataloga)

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

Pošlji 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		 Končna točka storitve 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) Navedite pot in ime 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 z rešitvijo.
PollStatus
Preveri stanje ankete		 (Neobvezno) Anketa za preverjanje stanja vaše zahteve (true|false).

Parametri (oddaja kataloga)

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

Stanje zahteve za katalog

Pridobite stanje 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		 Končna točka storitve 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 | Pošlji).

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 cevovodov in dejansko dejansko avtorstvo cevovodov z uporabo Microsoft Power Platform Build Tools, opravite build tools labs, ki ga lahko prenesete iz GitHub.

Več informacij o Azure Pipelines: Uporabi 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 upravljano 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 Orodja za gradnjo za Azure DevOps

  • Last updated on