Zadaci Microsoft Power Platform Build Tools

U sljedećim su odjeljcima opisani dostupni zadaci međuverzije. Nakon toga prikazujemo nekoliko primjera Azure Pipelines koriste te zadatke. Za informacije o alatima za izgradnju i kako ih preuzeti, pogledajte Microsoft Power Platform Build Tools za Azure Pipelines.

Zadatak pomoćnika

U sljedećim su odjeljcima opisani dostupni zadaci pomoći.

Instalacijski program za Power Platform Tool

Dodajte ovaj zadatak jednom prije bilo kojeg drugog zadatka alata za međuverziju platforme Power Platform u međuverziji i izdanju kanala. Ovaj zadatak instalira skup alata specifičnih za Power Platformu koje agent zahtijeva za pokretanje Microsoft Power Platform build zadataka. Ovaj zadatak ne zahtijeva dodatnu konfiguraciju. Ovaj zadatak sadrži parametre za određene verzije svakog alata koje instalira.

Da biste ostali u tijeku s verzijama alata, provjerite odgovaraju li ti parametri verzijama alata potrebnih za pravilno izvođenje kanala.

YAML isječak (instalater)

# 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 (instalater)

Parametri Opis
DefaultVersion
Koristite zadane verzije alata		 Postavite na Istinito za korištenje zadane verzije svih alata, inače na Neistinito. Obavezno (i neistinito) kada odredite bilo koju verziju alata.
AddToolsToPath
Dodajte alate na put		 Dodaje pac CLI varijabli PATH okruženja. Pac CLI možete koristiti iz zadataka skripte bez potrebe za ručnim postavljanjem puta.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Verzija alata		 Konkretna verzija alata za korištenje.

Power Platform WhoAmI

Potvrđuje vezu s uslugom Power Platform okruženja povezivanjem i podnošenjem WhoAmI zahtjeva. Ovaj zadatak može biti korisno uključiti rano u kanal kako bi se provjerila povezivost prije nego što započne obrada.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Neobavezno) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta. Dodatne informacije potražite u odjeljku Okruženje BuildTools.EnvironmentUrlza stvaranje platforme Power Platform
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za okruženje s kojim se želite povezati. Definirana je pod Veze usluge u Postavke projekta. Dodatne informacije potražite u odjeljku Okruženje BuildTools.EnvironmentUrlza stvaranje platforme Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje s kojim se želite povezati. Definirana je pod Veze usluge u Postavke projekta.

Provjera kvalitete

U sljedećem odjeljku nalaze se dostupni zadaci za provjeru kvalitete rješenja.

Provjera platforme Power Platform

Ovaj zadatak pokreće statičnu analizu na vašim rješenjima u odnosu na skup pravila najboljih praksi radi prepoznavanja problematičnih uzoraka koje nehotice možete predstaviti prilikom izgradnje rješenja.

YAML isječak (provjeritelj)

# 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 (provjeritelj)

Parametri Opis
PowerPlatformSPN
Servisna veza		 (Obavezno) Da biste koristili alat za provjeru servisa Power Platform, potrebna vam je veza s licenciranim Microsoft Power Platform okruženjem. Definirajte veze servisa u vezama servisaProject postavke pomoću vrste veze dodatka Power Platform. Dodatne informacije potražite u odjeljku Okruženje BuildTools.EnvironmentUrlza stvaranje platforme Power Platform.

Napomena: zadatak provjere podržava načine provjere autentičnosti upravitelja servisa i korisničkog imena/lozinke. Dodatne informacije o konfiguriranju upravitelja servisa za ovaj zadatak potražite u članku Konfiguriranje veza upravitelja servisa za okruženja servisa Power Platform.
UseDefaultPACheckerEndpoint
Koristite zadanu krajnju točku Power Platform provjeritelja		 Prema zadanim postavkama (true), zemljopisna lokacija usluge provjere koristi istu zemljopisnu lokaciju kao i okruženje s kojim se povezujete.
CustomPACheckerEndpoint
Prilagođena krajnja točka PAC provjeritelja		 Obavezno kada je UseDefaultPACheckerEndpointneistinito. Navedite drugi zemljopisni naziv koji želite koristiti, https://japan.api.advisor.powerapps.com. primjerice Popis dostupnih zemljopisnih oznaka potražite u članku Korištenje API-ja alata za provjeru platforme Power.
FileLocation
Lokacija datoteka za analizu		 Obavezno prilikom referenci na datoteku s URL-a za potpis zajedničkog pristupa sasUriFile

(SAS).Napomena: referencirate izvezenu datoteku rješenja, a ne raspakirane izvorne datoteke u spremištu. Možete analizirati i upravljane i neupravljane datoteke rješenja.
FilesToAnalyzeSasUri
SAS datoteke za analizu		 Obavezno kada je FileLocation postavljeno na sasUriFile. Unesite URI SAS-a. Možete dodati više URI-ja saS-a zarezom (,) ili točkom sa zarezom (;) odvojenih popisa.
FilesToAnalyze
Lokalne datoteke za analizu		 Obavezno kada se SAS datoteke ne analiziraju. Navedite putanju i ime datoteke komprimiranih datoteka koje treba analizirati. Možete koristiti zamjenske znakove. Na primjer, enter **\*.zip za sve zip datoteke u svim podmapama.
FilesToExclude
Lokalne datoteke za isključenje		 Navedite nazive datoteka koje će se izuzeti iz analize. Ako navedete više datoteka, koristite zarez (,) ili točku sa zarezom (;) odvojen popis. Popis može sadržavati puni naziv datoteke ili naziv s početnim ili završnim zamjenskim znakovima, kao što su *jquery ili form.js.
RulesToOverride
Pravila za nadjačavanje		 JSON niz koji sadrži pravila i razine za nadjačavanje. Prihvaćene vrijednosti za OverrideLevel su: Kritično, Visoko, Srednje, Nisko, Informativno. Primjer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Skup pravila		 (Obvezno) Navedite skup pravila koji će primijeniti. Dostupna su da sljedeća skupa pravila:
  • Alat za provjeru rješenja: ovaj skup pravila isti je onaj koji se pokreće s Power Apps za stvaranje rješenja.
  • Marketplace: Prošireni skup pravila koji se koristi za certifikaciju prijave prije nego što se može objaviti na Marketplaceu.
ErrorLevel
Razina pogreške		 U kombinaciji s parametrom praga pogreške, ta vrijednost definira ozbiljnost dopuštenih pogrešaka i upozorenja. Podržane vrijednosti praga su <level>IssueCount gdje je level=Critical, High, Medium, Low i Informational.
ErrorThreshold
Granična vrijednost pogreške		 Definira broj pogrešaka (>=0) određene razine koje su dopuštene da provjeritelj da prolaz rješenjima koja se provjeravaju.
FailOnPowerAppsCheckerAnalysisError
Neuspjelo prilikom pogreške		 Kada je vrijednost true, ne uspijeva ako se Power Apps provjera vraća kao Neuspješna ili FinishedWithErrors.
ArtifactDestinationName
Naziv DevOps artefakta		 Specificirajte ime Azure Artifacts za .sarif datoteku checker.

Zadaci rješenja

Ovaj skup zadataka automatizira akcije rješenja. Zadaci okruženja opisani u nastavku ovog odjeljka koji stvaraju, kopiraju ili vraćaju okruženje prepisuju veze usluge s novostvorenim okruženjima. Pomoću tih zadataka možete izvršavati zadatke rješenja u okruženjima koja stvarate na zahtjev.

Uvoz rješenja Power Platform

Uvozi rješenje u ciljno okruženje.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge u koju želite uvesti rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge u koju želite uvesti rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionInputFile
Datoteke ulaza rješenja		 (Obavezno) Put i naziv datoteke rješenja .zip datoteke za uvoz u ciljno okruženje (na primjer, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

Napomena: Varijable vam pružaju praktičan način za dobivanje ključnih bitova podataka u različite dijelove vašeg kanala. Pogledajte Korištenje unaprijed definiranih varijabli za opsežni popis.
HoldingSolution
Uvoz kao spremljeno rješenje		 Napredni parametar (istinito|neistinito) koji se koristi kada je rješenje potrebno nadograditi. Ovaj parametar sadrži rješenje u Dataverse, ali ne nadograđuje rješenje sve dok se ne pokrene zadatak Primijeni nadogradnju rješenja.
OverwriteUnmanagedCustomizations
Prebrišite neupravljane prilagodbe		 Navedite želite li prebrisati neupravljane prilagodbe (istinito|neistinito).
SkipProductUpdateDependencies
Preskočite ovisnosti ažuriranja proizvoda		 Navedite treba li preskočiti provedbu ovisnosti povezanih s ažuriranjima proizvoda (istinito|neistinito).
ConvertToManaged
Pretvaranje u upravljano		 Zastario. Sustav će pretvoriti neupravljane komponente rješenja u upravljane kada uvezete upravljano rješenje.
AsyncOperation
Asinkroni uvoz		 Ako je odabrano (istinito), operacija uvoza izvest će se asinkrono. Ovo se preporučuje za veća rješenja jer će se ovaj zadatak automatski zaustaviti nakon 4 minute. Odabirom asinkronog slat će se upiti i čekati dok se ne dosegne MaxAsyncWaitTime (istinito|neistinito).
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; Zadano je 60 minuta (1 sat), isto kao i Azure DevOps zadani za zadatke.
PublishWorkflows
Aktivirajte procese nakon uvoza		 Navedite trebaju li se neki procesi (tokovi rada) u rješenju aktivirati nakon uvoza (istinito|neistinito).
UseDeploymentSettingsFile
Korištenje datoteke postavki uvođenja		 Reference veze i vrijednosti varijabli okruženja mogu se postaviti korištenjem datoteke postavki implementacije (istinito|neistinito).
DeploymentSettingsFile
Datoteka postavki uvođenja		 (Obavezno kada je UseDeploymentSettingsFile=istinito) Putanja i naziv datoteke datoteke postavki uvođenja.

Power Platform Dodavanje komponente rješenja

Dodaje komponentu rješenja neupravljanom rješenju.

YAML isječak (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 Opis
ComponentId
ID komponente otopine		 Naziv sheme ili ID komponente za dodavanje ciljnom rješenju.
ComponentType
URL okruženja Power Platform		 Vrijednost koja predstavlja komponentu rješenja koju dodajete. Pogledajte Korištenje unaprijed definiranih tipova komponenti za opsežan popis vrijednosti komponenti.
SolutionUniqueName
Naziv rješenja		 Jedinstveni naziv rješenja.
AddRequiredComponents
Sve komponente potrebne za drugu otopinu ovisno o komponenti otopine		 (Nije obavezno) Označava trebaju li se u neupravljano rješenje dodati i druge komponente rješenja koje zahtijeva komponenta rješenja koju dodajete.
Environment
URL ili ID okruženja		 (Nije obavezno) URL ili ID okruženja ciljnog okruženja.

Power Platform Primijeni nadogradnju rješenja

Nadograđuje rješenje koje je uvezeno kao spremljeno rješenje.

YAML isječak (nadogradnja)

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

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge u koju želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge u koju želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obavezno) Naziv rješenja za primjenu nadogradnje. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.
AsyncOperation
Asinkrona nadogradnja		 Ako je odabrano (istinito), operacija nadogradnje izvest će se kao asinkroni skupni posao. Odabirom asinkronog slat će se upiti i čekati dok se ne dosegne MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; Zadano je 60 minuta (1 sat), isto kao i Azure DevOps zadani za zadatke.

Napomena

Varijable vam daju prikladan način za dobivanje ključnih bita podataka u različitim dijelovima kanala. Pogledajte Korištenje unaprijed definiranih varijabli za opsežni popis. Možete unaprijed popuniti podatke o referenci veze i varijablama okruženja za ciljno okruženje dok uvozite rješenje s pomoću datoteke postavki implementacije.

Više informacija: Popunjavanje referenci veze i varijabli okruženja unaprijed za automatizirane implementacije

Izvoz rješenja Power Platform

Izvozi rješenje iz izvornog okruženja.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge u koju želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge u koju želite nadograditi rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obvezno) Naziv rješenja koje treba izvesti. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.
SolutionOutputFile
Datoteke izlaza rješenja		 (Obavezno) Put i naziv datoteke solution.zip u koju želite izvesti izvorno okruženje (na primjer, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ).

Napomena: Varijable vam pružaju praktičan način za dobivanje ključnih bitova podataka u različite dijelove vašeg kanala. Pogledajte Korištenje unaprijed definiranih varijabli za opsežni popis.
AsyncOperation
Asinkroni izvoz		 Ako je odabrano (istinito), operacija izvoza izvest će se kao asinkroni skupni posao. Odabirom asinkronog slat će se upiti i čekati dok se ne dosegne MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; Zadano je 60 minuta (1 sat), isto kao i Azure DevOps zadani za zadatke.
Managed
Izvezi kao upravljano		 Ako je odabrano (istinito), izvezite rješenje kao upravljano rješenje; inače izvezite kao neupravljano rješenje.
ExportAutoNumberingSettings
Izvezite postavke automatskog numeriranja		 Izvezite postavke automatskog numeriranja (istinito|neistinito).
ExportCalendarSettings
Izvezi postavke kalendara		 Izvezite postavke kalendara (istinito|neistinito).
ExportCustomizationSettings
Izvezi postavke prilagođavanja		 Izvezite postavke prilagođavanja (istinito|neistinito).
ExportEmailTrackingSettings
Izvezi postavke praćenja e-pošte		 Izvezite postavke praćenja e-pošte (istinito|neistinito).
ExportGeneralSettings
Izvezi općenite postavke		 Izvezite opće postavke (istinito|neistinito).
ExportIsvConfig
Izvezi ISV konfiguraciju		 Izvezite ISV konfiguraciju (istinito|neistinito).
ExportMarketingSettings
Izvezi marketinške postavke		 Izvezite marketinške postavke (istinito|neistinito).
ExportOutlookSynchronizationSettings
Izvoz Outlook postavki sinkronizacije		 Izvoz Outlook postavki sinkronizacije (true|false).
ExportRelationshipRoles
Izvezi uloge odnosa		 Izvezite uloge odnosa (istinito|neistinito).
ExportSales
Izvozi prodaju		 Izvezite prodaju (istinito|neistinito).

Raspakiranje rješenja Power Platform

Uzima komprimiranu datoteku rješenja i rastavlja je u više datoteka XML tako da sustav kontrole izvora može jednostavnije čitati i upravljati tim datotekama.

YAML isječak (raspakiranje)

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

Parametri Opis
SolutionInputFile
Datoteke ulaza rješenja		 (Obvezno) Navedite putanju i ime datoteke rješenje.zip koje treba raspakirati.
SolutionTargetFolder
Ciljana mapa za raspakiranje rješenja		 (Obvezno) Putanja i ciljana mapa u koju želite raspakirati rješenje.
SolutionType
Vrsta rješenja		 (Obvezno) Vrsta rješenja koje želite raspakirati. Opcije uključuju: Neupravljano (preporučeno), Upravljano i Oboje.

Pakiranje rješenja Power Platform

Pakira rješenje predstavljeno u kontroli izvora u datoteku rješenje.zip koja se može uvesti u drugo okruženje.

YAML isječak (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 Opis
SolutionOutputFile
Datoteke izlaza rješenja		 (Obvezno) Putanja i naziv datoteke rješenje.zip u koju treba zapakirati rješenje.
SolutionSourceFolder
Izvorna mapa rješenja koje treba zapakirati		 (Obvezno) Putanja i izvorna mapa rješenja koje treba zapakirati.
SolutionType
Vrsta rješenja		 (Obvezno) Vrsta rješenja koje želite zapakirati. Opcije uključuju: Upravljano (preporučeno), Neupravljano i Oboje.

Power Platform Izbriši rješenje

Briše rješenje u ciljnom okruženju.

YAML isječak (brisanje)

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

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za koju želite izbrisati rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za koju želite izbrisati rješenje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obvezno) Naziv rješenja za brisanje. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.

Objava prilagodbi Power Platform

Objavljuje sva prilagođavanja u okruženju.

YAML isječak (objavljivanje)

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

Parametri (objavljivanje)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za koju želite objaviti prilagodbe (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za koju želite objaviti prilagodbe (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform

Verzija postavljenog rješenja Power Platform

Ažurira verziju rješenja.

YAML isječak (verzija)

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

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge koju želite postaviti verziju rješenja (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge koju želite postaviti verziju rješenja (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
SolutionName
Naziv rješenja		 (Obavezno) Naziv rješenja za koje se postavlja verzija. Uvijek koristite Naziv rješenje, a ne njegov Zaslonski naziv.
SolutionVersionNumber
Broj verzije rješenja		 (Obvezno) Broj verzije koji želite postaviti.

Iako se broj verzije može hardkodirati u cjevovodu, preporučuje se korištenje varijable Azure DevOps cjevovoda poput BuildId. Ovo pruža mogućnosti za definiranje točnog oblika broja verzije na kartici "Mogućnosti", na primjer: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Ovu se definiciju zatim može koristiti u zadatku Postavi verziju rješenja postavljanjem svojstva Broj verzije sa: $(Build.BuildId) umjesto čvrstog kodiranja 20200824.0.0.2.

Alternativno, izlaz Powershell skripte zadatka u retku $(Get-Date -Format yyyy.MM.dd.HHmm) postavljen na praznu varijablu pod nazivom SolutionVersion kao Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Postavite Verziju rješenja kao $(SolutionVersion).

Power Platform Postavljanje varijabli veze

Postavlja PowerPlatformSetConnectionVariables.BuildTools.* varijable kako bi se prilagođenim skriptnim zadacima omogućio pristup za korištenje servisne veze kao jedinstvenog izvora istine.

Postavljene su sljedeće varijable:

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

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za koju želite postaviti varijable veze. Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
timeoutInMinutes
Vremensko ograničenje		 Određuje maksimalno vrijeme, u minutama, koje zadatak smije izvršiti prije nego što ga poslužitelj otkaže. Nulta vrijednost označava beskonačno vremensko ograničenje.
retryCountOnTaskFailure
Broj ponovljenih pokušaja ako zadatak nije uspio		 Određuje broj ponovljenih pokušaja za ovaj zadatak koji će se dogoditi u slučaju neuspjeha zadatka. Nije podržano za zadatke bez agenta.
ApplicationId
ID aplikacije za prijavu		 (Potrebno za korisničko ime/lozinku) ID aplikacije koji se koristi za prijavu (vidi dodatnu napomenu u nastavku).
RedirectUri
URI preusmjeravanja određene aplikacije		 (Potrebno za korisničko ime/lozinku) Preusmjerite URI navedene aplikacije. Potrebno prilikom određivanja ID-a aplikacije. (Pogledajte dodatnu napomenu u nastavku).

Napomena

Kada koristite vrstu provjere autentičnosti korisničkog imena/lozinke, bit će potrebni ID aplikacije i Uri preusmjeravanja. Ovaj dokument za provjeru autentičnosti sadrži objašnjenje zašto trebate stvoriti registraciju aplikacije za provjeru autentičnosti Dataverse. Kada se povežete pomoću provjere autentičnosti korisničkog imena/lozinke, veza se ponaša kao aplikacija koja se povezuje u ime korisnika Dataverse.

Paket za uvođenje Power Platform

Uvodi paket u okruženje. Uvođenje paketa, za razliku od jedne datoteke rješenja, pruža mogućnost uvođenja više rješenja, podataka i koda u okruženje.

YAML isječak (uvođenje)

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 (uvođenje)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge u koju želite implementirati paket (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge u koju želite implementirati paket (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform. Više informacija: vidi BuildTools.EnvironmentUrl pod stavkom Stvaranje okruženja Power Platform
PackageFile
Datoteka paketa		 (Obavezno) Putanja i naziv datoteke sklopa datoteke paketa (.dll).
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; Zadano je 60 minuta (1 sat), isto kao i Azure DevOps zadani za zadatke.

Zadaci upravljanja okruženjem

Automatizirajte zajedničke zadatke upravljanja životnim ciklusom okruženja (ELM).

Izrada okruženja Power Platform

Stvara novo okruženje. Stvaranje novog okruženja također automatski stvara BuildTools.EnvironmentUrl.

Važno

Kada je postavljeno, BuildTools.EnvironmentUrl će se koristiti kao zadana veza usluge za sljedeće zadatke u kanalu. Svaki zadatak opisan u ovom članku koristi krajnju točku iz veze usluge samo kada BuildTools.EnvironmentUrl nije postavljeno.

Novo okruženje može se dodijeliti samo ako vaša licenca ili kapacitet dopuštaju stvaranje dodatnih okruženja. Za više informacija o tome kako vidjeti kapacitet pogledajte Pojedinosti o stranici kapaciteta.

YAML isječak (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

Parameteri (Create-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge koju želite stvoriti okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge koju želite stvoriti okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
DisplayName
Zaslonski naziv		 (Obavezno) Zaslonski naziv okruženja je stvoren.
LocationName
Regija uvođenja		 (Obavezno) Regija u kojoj se okruženje treba stvoriti.
EnvironmentSku
Vrsta okruženja		 (Obavezno) Vrsta instance za uvođenje. Opcije su Sandbox, Production, Trial i SubscriptionBasedTrial.
AppsTemplate
Aplikacije		 Za neprobni tip okruženja, podržane aplikacije su D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
CurrencyName
Valuta		 (Obavezno) Osnovna valuta za okruženje je stvorena. Valuta se ne može ažurirati nakon stvaranja okruženja.
LanguageName
Jezik		 (Obavezno) Osnovni jezik u okruženju.
DomainName
Naziv domene		 (Obavezno) Ovo je niz specifičan za okruženje koji čini dio URL-a. Na primjer, za okruženje sa sljedećim URL-om: https://powerappsbuildtasks.crm.dynamics.com/, naziv domene bio bi „powerappsbuildtasks”.

Napomena: Ako unesete naziv domene koji se već koristi, zadatak dodaje numeričku vrijednost nazivu domene, počevši od 0. U gornjem primjeru URL može postatihttps://powerappsbuildtasks0.crm.dynamics.com/.

Izbriši okruženje Power Platform

Briše okruženje.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge koju želite izbrisati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge koju želite izbrisati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.

Power Platform Dodijelite korisnika

Dodijelite korisnika ciljnom okruženju s navedenom sigurnosnom ulogom.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje kojem želite dodijeliti korisnika (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
User
Power Platform korisničko ime		 Microsoft Entra ID objekta ili glavno korisničko ime za dodjeljivanje ciljnom okruženju.
Role
Naziv ili ID sigurnosne uloge		 Naziv ili ID sigurnosne uloge koji će se dodijeliti korisniku.
ApplicationUser
Power Platform korisničko ime aplikacije		 Specificira je li ulazni korisnik korisnik aplikacije (true|false).

Power Platform Resetiraj okruženje

Resetira okruženje.

YAML isječak (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 (Reset-env)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za koju želite resetirati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za koju želite resetirati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.

Sigurnosna kopija okruženja Power Platform

Sigurnosno kopira okruženje.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za koju želite sigurnosno kopirati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za koju želite sigurnosno kopirati okruženje (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
BackupLabel
Oznaka sigurnosnog kopiranja		 (Obavezno) Oznaka koja će se dodijeliti sigurnosnoj kopiji.

Kopiranje okruženja Power Platform

Kopira okruženje u ciljno okruženje. Dostupne su dvije vrste kopija: potpuna i minimalna. Potpuna kopija uključuje podatke i metapodatke rješenja (prilagodbe), a minimalna kopija uključuje samo metapodatke rješenja, a ne stvarne podatke.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za izvorno okruženje iz kojeg želite kopirati (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za izvorno okruženje iz kojeg želite kopirati (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
TargetEnvironmentUrl
URL ciljnog okruženja		 (Obavezno) URL ciljnog okruženja u koji želite kopirati.
CopyType
Vrsta kopiranja		 Vrsta kopiranja koje će se obaviti: FullCopy ili MinimalCopy
OverrideFriendlyName
Nadjačaj neslužbeni naziv		 Promijenite prijateljski naziv ciljnog okruženja u drugi naziv (istinito|neistinito).
FriendlyName
Neslužbeni naziv		 Neslužbeni naziv ciljnog okruženja.
SkipAuditData
Preskoči revizijske podatke		 Hoće li se preskočiti podaci nadzora tijekom operacije kopiranja. (true|false).
MaxAsyncWaitTime
Maksimalno vrijeme čekanja		 Maksimalno vrijeme čekanja u minutama za asinkronu operaciju; Zadano je 60 minuta (1 sat), isto kao i Azure DevOps zadani za zadatke.

Power Platform Vratite okruženje

Vraća okruženje na zadanu sigurnosnu kopiju.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformEnvironment
URL okruženja Power Platform		 Krajnja točka usluge za izvorno okruženje iz kojeg želite vratiti (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za izvorno okruženje iz kojeg želite vratiti (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
RestoreLatestBackup
Najnovija sigurnosna kopija za vraćanje		 Želite li vratiti najnoviju sigurnosnu kopiju ili navesti RestoreTimeStamp (true|false).
RestoreTimeStamp
DatumVrijeme sigurnosne kopije		 Datum i vrijeme sigurnosnog kopiranja u formatu „mm/dd/gggg hh:mm” ILI niz „najnovije”.
TargetEnvironmentUrl
URL ciljnog okruženja		 (Obavezno) URL ciljnog okruženja koje želite vratiti.
FriendlyName
Naziv obnovljenog okruženja		 (Nije obavezno) Naziv obnovljenog okruženja.
DisableAdminMode
Onemogućivanje administratorskog načina rada		 Treba li onemogućiti administratorski način rada (istinito|neistinito).

Izvoz Dataverse podataka

Izvezite podatke iz okruženja s navedenom shemom.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje iz kojeg želite izvesti podatke (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
SchemaFile
Naziv XML datoteke sheme		 Naziv XML datoteke sheme. Može se izraditi pomoću alata za migraciju konfiguracije.
DataFile
Naziv podatkovne datoteke		 Naziv datoteke za podatke za izvoz (zip datoteka).
Overwrite
Prepisivanje sadržaja		 Power Pages sadržaj web stranice za prepisivanje (točno|netočno).

Uvoz Dataverse podataka

Uvoz podataka u okruženje.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje koje želite uvesti podatke (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
DataFile
Naziv podatkovne datoteke		 Naziv datoteke za komprimirani zip) podatkovnu datoteku za uvoz ili mapu s data-schema.xml i data.xml za uvoz.

Zadaci upravljanja Power Pages-om

Zadaci za rad s Power Pages web stranicom.

PAPportal Power Platform preuzimanje

Preuzmite sadržaj web-mjesta Power Pages iz trenutnog okruženja programa Dataverse.

YAML isječak (download-paportal)

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

Parametri (download-paportal)

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje iz kojeg želite preuzeti sadržaj (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
WebsiteId
ID web-mjesta portala		 Power Pages ID web stranice za preuzimanje.
Overwrite
Prepisivanje sadržaja		 Power Pages sadržaj web stranice za prepisivanje (točno|netočno).
ModelVersion
Model podataka o lokaciji		 Označava hoće li podaci web-lokacije koji se prenose upotrebljavati standardni (1) ili poboljšani podatkovni model (2). Zadana vrijednost je '1'.

PAPortal Power Platform prijenos

Učitajte sadržaj Power Pages web stranice u trenutno Dataverse okruženje.

YAML isječak (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 Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje u koje želite prenijeti sadržaj (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
UploadPath
Put za prijenos sadržaja		 Put s kojeg će se sadržaj Power Pages web stranice učitavati.
ModelVersion
Model podataka o lokaciji		 Označava hoće li podaci web-lokacije koji se prenose upotrebljavati standardni (1) ili poboljšani podatkovni model (2). Zadana vrijednost je '1'.

Katalog Power Platform zadataka (pretpregled)

Ovi zadaci izvode radnje u odnosu na katalog i Power Platform uključuju sljedeće.

Napomena

Trenutačno su zadaci kataloga izdanje pretpregleda Power Platform .

Instalirajte stavku kataloga

Instalirajte stavku za katalog u ciljno okruženje.

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje u koje želite prenijeti sadržaj (na primjer, https://powerappsbuildtools.crm.dynamics.com). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
Environment
URL ciljnog okruženja		 (Obavezno) URL okruženja koji ovaj zadatak cilja.
CatalogItemId
ID kataloške stavke koji se instalira		 (Obavezno) Stavka kataloga koja će se instalirati u ciljnom okruženju.
TargetEnvironmentUrl
URL ciljnog okruženja		 (Obavezno) URL ciljnog okruženja za instalaciju stavke kataloga (na primjer, "https://YourOrg.crm.dynamics.com").
PollStatus
Provjera statusa ankete		 (Nije obavezno) Anketa za provjeru statusa vašeg zahtjeva (true|false).

Parametri (instalacija 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

Slanje odobrenja kataloga

Pošalji zahtjev za odobrenje za katalog.

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje u koje želite prenijeti sadržaj (na primjer, "https://powerappsbuildtools.crm.dynamics.com"). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
Environment
URL ciljnog okruženja		 (Obavezno) URL okruženja koji ovaj zadatak cilja.
CatalogSubmissionFile
Datoteka za slanje kataloga		 (Obavezno) Navedite put i naziv datoteke za slanje kataloga.
UsePackageSolutionZipFile
Vrsta datoteke		 Vrsta datoteke: zip datoteka paketa ili rješenja.
SolutionZipFile
Naziv zip datoteke rješenja		 Navedite put i naziv datoteke zip datoteke rješenja.
PollStatus
Provjera statusa ankete		 (Nije obavezno) Anketa za provjeru statusa vašeg zahtjeva (true|false).

Parametri (katalog-pošalji)

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 zahtjeva za katalog

Saznajte status zahtjeva za instalaciju/slanje kataloga.

Parametri Opis
authenticationType
Vrsta provjere autentičnosti		 (Obvezno za SPN) Navedite bilo PowerPlatformEnvironment za vezu s korisničkim imenom / lozinkom ili PowerPlatformSPN za upravitelja servisa / tajnu klijenta.
PowerPlatformSPN
Upravitelj usluge platforme Power Platform		 Krajnja točka usluge za okruženje u koje želite prenijeti sadržaj (na primjer, "https://powerappsbuildtools.crm.dynamics.com"). Definirano pod stavkom Veze usluge u odjeljku Postavke projekta korištenjem vrste veze Power Platform.
Environment
URL ciljnog okruženja		 (Obavezno) URL okruženja koji ovaj zadatak cilja.
TrackingId
Zatražite ID za praćenje		 (Obavezno) Zatražite ID za praćenje.
RequestType
Vrsta zahtjeva		 (Obavezno) Vrsta zahtjeva. (Vrijednosti: Instalacija | Pošalji).

Parametri (kataloški status)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools-DEV.catalog-status.PowerPlatforCatalogStatus@2
  displayName: 'Power Platform Catalog Status '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    Environment: '$(BuildTools.EnvironmentUrl)'
    TrackingId: '00000000-0000-0000-0000-000000000002'
    RequestType: Submit

Kanali za izgradnju i izdavanje

Sada kada smo utvrdili što se može učiniti pomoću alata za izgradnju, pogledajmo kako te alate možete primijeniti na kanale za izgradnju i izdavanje. Konceptualni pregled prikazan je u nastavku. Pogledajmo neke detalje implementacije kanala koristeći zadatke alata za izgradnju u sljedećim pododjeljcima.

Za više informacija o stvaranju ovih pipelineova i stvarnom praktičnom kreiranju pipelineova koristeći Microsoft Power Platform Build Tools, završite build tools labs, koje možete preuzeti s GitHub.

Više informacija o Azure Pipelines: Koristite Azure Pipelines

Izgradnja kanala: Izvezite rješenje iz razvojnog okruženja (DEV)

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji izvozi rješenje iz razvojnog okruženja.

Izvezite rješenje iz razvojnog okruženja (DEV).

Izradite kanal: Izradite upravljano rješenje

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji izrađuje upravljano rješenje.

Izgradite upravljano rješenje.

Izdavanje kanala: Uvedite u proizvodno okruženje (PROD)

Sljedeća slika prikazuje zadatke alata za izradu koje možete dodati kanalu koji se primjenjuje na proizvodno okruženje.

Implementacija u proizvodno okruženje (PROD).

Pogledajte i

Microsoft Power Platform Build alati za Azure DevOps

  • Last updated on