Deli putem

Zadaci na platformi Microsoft Power Platform Build Tools

  • Članak

Dostupni razvojni zadaci opisani su u narednim odeljcima. Nakon toga, prikazujemo neke primere Azure Pipelines koji koriste ove zadatke. Za informacije o alatima za izgradnju i kako ih preuzeti, pogledajte Microsoft Power Platform Build Tools for Azure Pipelines.

Zadatak pomagača

Dostupni zadaci pomagača su opisani sledeće.

Power Platform alatka za instalaciju

Ovaj zadatak se obavezno dodaje jednom, pre bilo kog drugog Power Platform Build Tools zadatka, u verziju i kanal objavljivanja. Ovaj zadatak instalira skup alatki specifičnih za Power Platform koje su potrebne agentu za pokretanje Microsoft Power Platform razvojnih zadataka. Ovaj zadatak ne zahteva više konfiguracije kada se doda. Ovaj zadatak sadrži parametre za specifične verzije svakog od alata koji se instaliraju.

Da biste tokom vremena bili u toku sa verzijama alatki, postarajte se da ovi parametri odgovaraju verzijama alatki koje su potrebne da bi kanal pravilno radio.

YAML isečak (Program za instalaciju)

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

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

Parametri (Program za instalaciju)

Parametri Opis
DefaultVersion
Korišćenje podrazumevanih verzija alatki		 Podesite na vrednost tačno da biste koristili podrazumevanu verziju svih alatki, u suprotnom netačno. Obavezno (i netačno) kada su navedene bilo koje verzije alatki.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Verzija alatke		 Određena verzija alatke za korišćenje.

Power Platform WhoAmI

Potvrđuje vezu Power Platform sa servisnim okruženjem povezivanjem i upućivanjem WhoAmI zahteva. Može biti korisno da se ovaj zadatak rano uključi u kanal da biste proverili povezanost pre nego što započne obrada.

YAML iseč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
Tip potvrde identiteta		 (Opcionalno) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge za okruženje sa kojim se povezujete. Definisano je u delu Veze sa uslugom u odeljku Postavke projekta. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge za okruženje sa kojim se povezujete. Definisano je u delu Veze sa uslugom u odeljku Postavke projekta.

Provera kvaliteta

U sledećem odeljku su dostupni zadaci za proveru kvaliteta rešenja.

Power Platform Checker

Ovaj zadatak pokreće proveru statičke analize vaših rešenja u odnosu na skup pravila najbolje prakse kako bi se identifikovali bilo kakvi problematični obrasci koje ste možda nenamerno uveli prilikom izgradnje rešenja.

YAML isečak (Kontrolor)

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

Parametri Opis
PowerPlatformSPN
Veza sa uslugom		 (Obavezno) Veza sa licenciranim Microsoft Power Platform okruženjem je potrebna za upotrebu Power Platform kontrolora. Veze sa uslugom su definisane u odeljku Veze sa uslugom ispod Postavke projekta pomoću tipa veze Power Platform. Više informacija: pogledajte BuildTools.EnvironmentUrl pod Power Platform Kreiraj okruženje

Napomena: Principalna usluga i korisničko ime/lozinka autentifikacije su dostupni za zadatak provere. Za više informacija o tome kako da konfigurišete glavne usluge koje se koriste sa ovim zadatkom, pogledajte Konfigurisanje veza glavne usluge za Power Platform okruženja.
UseDefaultPACheckerEndpoint
Korišćenje krajnje tačke Power Platform kontrolora		 Podrazumevano (true), geografska lokacija servisa za proveru koristi istu geografiju kao i okruženje na koje se povezujete.
CustomPACheckerEndpoint
Krajnja tačka prilagođenog PAC kontrolora		 Obavezno kada UseDefaultPACheckerEndpoint ima vrednost netačno. Možete specificirati drugi geo za korišćenje, na primer https://japan.api.advisor.powerapps.com. Za listu dostupnih geografija, pogledajte Koristite Power Platform API za proveru.
FileLocation
Lokacija fajlova za analizu		 Obavezno kada se upućuje na datoteku iz URL-a sasUriFile potpisa deljenog pristupa (SAS).

Napomena: Važno je da se referuje na izvezeni fajl rešenja a ne na raspakovane izvorne fajlove u vašem spremištu. Možete analizirati datoteke i kompletnih i nekompletnih rešenja.
FilesToAnalyzeSasUri
SAS datoteke za analizu		 Obavezno kada je FileLocation podešeno na sasUriFile. Unesite URI adresu za SAS. Možete dodati više od SAS URI-ja kroz listu razdvojenu zarezom (,) ili tačkom i zarezom (;).
FilesToAnalyze
Lokalne datoteke za analizu		 Potrebno kada se SAS datoteke ne analiziraju. Navedite putanju i naziv datoteke zip datoteka za analizu. Možete da koristite džokere. Na primer, enter **\*.zip za sve zip fajlove u svim subfolderima.
FilesToExclude
Lokalne datoteke za izuzimanje		 Navedite imena datoteka koje treba isključiti iz analize. Ako ima više njih, navedite ih u listi razdvojenoj zarezom (,) ili tačkom i zarezom (;). Ova lista može da sadrži puno ime datoteke ili ime sa džoker znakovima na početku ili na kraju, kao što su *jquery ili form.js
RulesToOverride
Pravila za izmenu		 JSON niz koji sadrži pravila i nivoe za izmenu. Prihvaćene vrednosti za OverrideLevel su: kritično, visoko, srednje, nisko, informativno. Primer: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Skup pravila		 (Obavezno) Navedite koji skup pravila treba da se primenjuje. Dostupna su sledeća dva skupa pravila:
  • Provera rešenja: Ovaj skup pravila je isti onaj koji se pokreće sa portala Power Apps proizvođača.
  • AppSource: Prošireni skup pravila koji se koristi za sertifikaciju aplikacije pre nego što se može objaviti AppSource.
ErrorLevel
Nivo greške		 U kombinaciji sa greškom, parametar praga definiše ozbiljnost grešaka i upozorenja koja su dozvoljena. Podržane vrednosti graničnih vrednosti su <level>IssueCount gde je level=Critical, High, Medium, Low i Informational.
ErrorThreshold
Granična vrednost greške		 Definiše broj grešaka (>=0) navedenog nivoa kojima je dozvoljeno da kontrolor prosledi rešenja koja se proveravaju.
FailOnPowerAppsCheckerAnalysisError
Neuspeh u slučaju greške		 Kada je tačno, neuspeh ako se analiza Power Apps kontrolora vrati kao „Neuspešno“ ili „Završeno sa greškama“.
ArtifactDestinationName
Naziv DevOps artefakta		 Navedite ime Azure Artifacts za datoteku checker .sarif.

Zadaci rešenja

Ovaj skup zadataka može automatizovati radnje rešenja. Zadaci okruženja opisani kasnije u ovom odeljku koji kreiraju, kopiraju ili vraćaju okruženje prepisuju servisne veze sa novostvorenim okruženjima. Ovi zadaci omogućavaju obavljanje zadataka rešenja u odnosu na okruženja koja su stvorena na zahtev.

Power Platform uvoz rešenja

Uvozi rešenje u ciljno okruženje.

YAML iseč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
    ConvertToManaged: true

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

Parametri (Uvoz)

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Servisna krajnja tačka u koju želite da uvezete rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Servisna krajnja tačka u koju želite da uvezete rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
SolutionInputFile
Ulazna datoteka rešenja		 (Obavezno) Putanja i ime datoteke rešenja .zip fajl za uvoz u ciljno okruženje (na primer, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

beleške: Promenljive vam daju pogodan način da dobijete ključne bitove podataka u različite delove vašeg cevovoda. Pogledajte članak Korišćenje unapred definisanih promenljivih da biste videli sveobuhvatnu listu.
HoldingSolution
Uvoz kao slobodno rešenje		 Napredni parametar (true|false) koji se koristi kada rešenje treba da se nadogradi. Ovaj parametar sadrži rešenje na platformi Dataverse, ali ne nadograđuje rešenje dok se ne pokrene zadatak Primena nadogradnje rešenja.
OverwriteUnmanagedCustomizations
Izmena nekompletnih prilagođavanja		 Navedite da li treba izmeniti nekompletna prilagođavanja (true|false).
SkipProductUpdateDependencies
Preskakanje zavisnosti od ažuriranja proizvoda		 Navedite da li treba preskočiti primenu zavisnosti u vezi sa ažuriranjem proizvoda (true|false).
ConvertToManaged
Konvertovanje u kompletno		 Navedite da li treba uvesti kompletno rešenje (true|false).
AsyncOperation
Asinhroni uvoz		 Ako je izabrano (tačno), operacija uvoza će biti izvršena asinhrono. Ovo se preporučuje za veća rešenja, jer će se ovaj zadatak inače automatski zaustaviti nakon 4 minuta. Izbor asinhronog će anketirati i čekati dok se ne dostigne MaxAsyncWaitTime (true|false).
MaxAsyncWaitTime
Maksimalno vreme čekanja		 Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 č), isto kao Azure DevOps podrazumevano za zadatke.
PublishWorkflows
Aktiviranje procesa nakon uvoza		 Navedite da li neki procesi (tokovi posla) u rešenju treba da se aktiviraju nakon uvoza (true|false).
UseDeploymentSettingsFile
Korišćenje datoteke postavki primene		 Reference veze i vrednosti promenljivih okruženja mogu da se podese korišćenjem datoteke za postavke primene (true|false).
DeploymentSettingsFile
Datoteka postavki primene		 (obavezno kada je UseDeploymentSettingsFile=tačno) Putanja i naziv datoteke za postavke primene.

Power Platform Dodaj komponentu rešenja

Dodaje komponentu rešenja neupravljanom rešenju.

IAML iseč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 rešenja		 Naziv šeme ili ID komponente koju treba dodati u ciljno rešenje.
ComponentType
URL adresa Power Platform okruženja		 Vrednost koja predstavlja komponentu rešenja koju dodajete. Pogledajte Upotreba predefinisanih tipova komponenti za sveobuhvatnu listu vrednosti komponenti.
SolutionUniqueName
Naziv rešenja		 Jedinstveno ime rešenja.
AddRequiredComponents
Sve komponente potrebne od drugog rešenja u zavisnosti od komponente rešenja		 (Opciono) Označava da li druge komponente rešenja koje su potrebne od strane komponente rešenja koju dodajete takođe treba dodati u neupravljano rešenje.
Environment
URL ili ID okruženja		 (Opciono) URL okruženja ili ID ciljnog okruženja.

Power Platform Primena nadogradnje rešenja

Nadograđuje rešenje koje je uvezeno kao rešenje za zadržavanje.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge u koju želite da nadogradite rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge u koju želite da nadogradite rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
SolutionName
Ime rešenja		 (Obavezno) Naziv rešenja za primenu nadogradnje. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.
AsyncOperation
Asinhrona nadogradnja		 Ako je izabrano (tačno), operacija nadogradnje će biti izvršena kao asinhroni grupni posao. Izbor asinhronog će anketirati i čekati dok se ne dostigne MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimalno vreme čekanja		 Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 č), isto kao Azure DevOps podrazumevano za zadatke.

Belešku

Promenljive vam daju pogodan način za unos ključnih podataka u različite delove kanala. Pogledajte članak Korišćenje unapred definisanih promenljivih da biste videli sveobuhvatnu listu. Možete unapred da popunite informacije o referencama veza i promenljivim okruženja za ciljno okruženje dok uvozite rešenje pomoću datoteke sa postavkama primene.

Još informacija: Unapred popunjene reference veze i promenljive okruženja za automatizovane primene

Power Platform izvoz rešenja

Izvozi rešenje iz izvornog okruženja.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge u koju želite da nadogradite rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge u koju želite da nadogradite rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
SolutionName
Ime rešenja		 (Obavezno) Naziv rešenja koje se izvozi. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.
SolutionOutputFile
Izlazna datoteka rešenja		 (Obavezno) Putanja i ime datoteke solution.zip fajla za izvoz izvornog okruženja (na primer, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ).

beleške: Promenljive vam daju pogodan način da dobijete ključne bitove podataka u različite delove vašeg cevovoda. Pogledajte članak Korišćenje unapred definisanih promenljivih da biste videli sveobuhvatnu listu.
AsyncOperation
Asinhroni izvoz		 Ako je izabrano (tačno), operacija izvoza će biti izvršena kao asinhroni grupni posao. Izbor asinhronog će anketirati i čekati dok se ne dostigne MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimalno vreme čekanja		 Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 č), isto kao Azure DevOps podrazumevano za zadatke.
Managed
Izvezi kao kompletno		 Ako je izabrano (tačno), izvezite rešenje kao kompletno rešenje; u suprotnom izvezite kao nekompletno rešenje.
ExportAutoNumberingSettings
Izvoz postavki automatskog numerisanja		 Izvoz postavki automatskog numerisanja (true|false).
ExportCalendarSettings
Izvoz postavki kalendara		 Izvoz postavki kalendara (true|false).
ExportCustomizationSettings
Izvoz postavki prilagođavanja		 Izvoz postavki prilagođavanja (true|false).
ExportEmailTrackingSettings
Izvoz postavki praćenja e-pošte		 Izvoz postavki praćenja e-pošte (true|false).
ExportGeneralSettings
Izvoz opštih postavki		 Izvoz opštih postavki (true|false).
ExportIsvConfig
Izvoz konfiguracije ISV		 Izvoz konfiguracije ISV (true|false).
ExportMarketingSettings
Izvoz marketinških postavki		 Izvoz marketinških postavki (true|false).
ExportOutlookSynchronizationSettings
Izvoz postavki Outlook sinhronizacije		 Izvoz postavki Outlook sinhronizacije (true|false).
ExportRelationshipRoles
Izvoz uloga relacija		 Izvoz uloga relacija (true|false).
ExportSales
Izvoz prodaje		 Izvoz prodaje (true|false).

Power Platform rešenje za raspakivanje

Uzima komprimovanu datoteku rešenja i dekomponuje je u više XML datoteka kako bi ih sistem kontrole izvora lakše čitao i upravljao njima.

YAML isečak (Raspakivanje)

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

Parametri Opis
SolutionInputFile
Ulazna datoteka rešenja		 (Obavezno) Putanja i naziv .zip datoteke rešenja za raspakivanje.
SolutionTargetFolder
Ciljna fasciklu za raspakivanje rešenja		 (Obavezno) Putanja i ciljna fascikla u koju želite da raspakujete rešenje.
SolutionType
Tip rešenja		 (Obavezno) Tip rešenja koje želite da raspakujete. Opcije uključuju: Nekompletno (preporučuje se), Kompletno i Oba.

Power Platform rešenje za pakovanje

Pakuje rešenje predstavljeno u kontroli izvora u .zip datoteku rešenja koja se može uvesti u drugo okruženje.

YAML isečak (Paket)

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

Parametri Opis
SolutionOutputFile
Izlazna datoteka rešenja		 (Obavezno) Naziv putanje i .zip datoteke rešenja za pakovanje rešenja.
SolutionSourceFolder
Izvorna fascikla rešenja za pakovanje		 (Obavezno) Putanja i izvorna fascikla rešenja za pakovanje.
SolutionType
Tip rešenja		 (Obavezno) Tip rešenja koje želite da spakujete. Opcije uključuju: Kompletno (preporučuje se), Nekompletno i Oba.

Power Platform brisanje rešenja

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

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka servisa za koju želite da izbrišete rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za koju želite da izbrišete rešenje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
SolutionName
Ime rešenja		 (Obavezno) Naziv rešenja koje se briše. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.

Power Platform objavljivanje prilagođavanja

Objavljuje sva prilagođavanja u okruženju.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge koju želite da objavite prilagođavanja (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge koju želite da objavite prilagođavanja (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja

Verzija Power Platform skupa rešenja

Ažurira verziju rešenja.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Servis krajnja tačka da želite da podesite verziju rešenja (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Servis krajnja tačka da želite da podesite verziju rešenja (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
SolutionName
Ime rešenja		 (Obavezno) Naziv rešenja za podešavanje verzije. Uvek koristite Naziv rešenja, a ne njegovo Ime za prikaz.
SolutionVersionNumber
Broj verzije rešenja		 (Obavezno) Broj verzije koji želite da podesite.

Iako broj verzije može biti fiksno kodiran u kanalu, preporučuje se upotreba Azure DevOps promenljive kanala poput BuildId. Ovo pruža opcije za definisanje tačnog oblika broja verzije na kartici „Opcije“, na primer: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Ova definicija se zatim može koristiti u zadatku „Postavljanje verzije rešenja“ postavljanjem svojstva „Broj verzije“ na: $(Build.BuildId) umesto direktnog kodiranja 20200824.0.0.2.

Alternativno, PowerShell umetnuta skripta zadatka $(Get-Date -Format yyyy.MM.dd.HHmm) na izlazu postavlja praznu promenljivu pod nazivom „SolutionVersion as Write-Host“ ("##vso[task.setvariable variable=SolutionVersion;]$version"), postavlja verziju rešenja na $(SolutionVersion).

Power Platform Podesite promenljive veze

Postavlja BuildTools.* promenljive da obezbedi pristup prilagođenim zadacima skripte da koristi servisnu vezu kao jedan izvor istine.

IAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za koju želite da podesite varijable veze. Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
timeoutInMinutes
Istek vremena		 Određuje maksimalno vreme, u minutama, koje je zadatak dozvoljeno da izvrši pre nego što ga server otkaže. Nulta vrednost označava beskonačan tajm-aut.
retryCountOnTaskFailure
Broj ponovljenih pokušaja ako zadatak nije uspeo		 Određuje broj ponovljenih pokušaja za ovaj zadatak koji će se desiti u slučaju neuspeha zadatka. Nije podržan za zadatke bez agenta.
ApplicationId
ID aplikacije za prijavljivanje		 (Potrebno za korisničko ime / lozinku) ID aplikacije koji se koristi za prijavljivanje (Pogledajte dodatnu napomenu ispod).
RedirectUri
Preusmeravanje URI određene aplikacije		 (Potrebno za korisničko ime / lozinku) Preusmeri URI navedene aplikacije. Potrebno prilikom određivanja ID aplikacije. (Pogledajte dodatnu napomenu ispod).

Belešku

Kada koristite tip autentifikacije korisničkog imena / lozinke, ID aplikacije i Uri preusmeravanja će biti potrebni. Ovaj autentifikacija oauth dokument ima objašnjenje zašto je potrebno da kreirate registraciju aplikacije za autentifikaciju Dataverse. Kada se povežete pomoću autentifikacije korisničkog imena / lozinke, veza se ponaša kao aplikacija koja se povezuje u ime korisnika Dataverse.

Power Platform paket za primenu

Primenjuje paket u okruženje. Primena paketa za razliku od jedne datoteke rešenja daje vam mogućnost primene više rešenja, podataka i koda u okruženje.

YAML isečak (Primena)

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

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge u koju želite da rasporedite paket (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge u koju želite da rasporedite paket (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform. Još informacija: pogledajte BuildTools.EnvironmentUrl u odeljku Power Platform Kreiranje okruženja
PackageFile
Datoteka paketa		 (Obavezno) Putanja i naziv sklopa datoteke paketa (.dll).
MaxAsyncWaitTime
Maksimalno vreme čekanja		 Maksimalno vreme čekanja u minutima za asinhronu operaciju; podrazumevana vrednost je 60 min (1 č), isto kao Azure DevOps podrazumevano za zadatke.

Zadaci upravljanja okruženjima

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

Power Platform kreiranje okruženja

Kreira novo okruženje. Kreiranje novog okruženja takođe automatski kreira BuildTools.EnvironmentUrl.

Važno

Kada je podešeno, BuildTools.EnvironmentUrl će se koristiti kao podrazumevana servisna veza za naredne zadatke u kanalu. Svaki zadatak opisan u ovom članku koristi samo krajnju tačku iz veze usluge kada BuildTools.EnvironmentUrl nije podešen.

Novo okruženje može biti obezbeđeno samo ako vaša licenca ili kapacitet dozvoljava stvaranje dodatnih okruženja. Za više informacija o tome kako da vidite kapacitet, pogledajte stranicu Detalji stranice kapaciteta.

YAML iseč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

Parametri (Create-env)

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge koju želite da kreirate okruženje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge koju želite da kreirate okruženje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
DisplayName
Ime za prikaz		 (Obavezno) Kreirano je ime za prikaz okruženja.
LocationName
Region primene		 (Obavezno) Region u koji treba da se primeni okruženje.
EnvironmentSku
Tip okruženja		 (Obavezno) Tip instance za primenu. Opcije su Sandbox, Proizvodno, Probno i SubscriptionBasedTrial.
AppsTemplate
Aplikacije		 Za tip okruženja koje nije probno, podržane aplikacije su D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation i D365_Sales.
CurrencyName
Valuta		 (Obavezno) Osnovna valuta za kreirano okruženje. Valuta se ne može izmeniti nakon kreiranja okruženja.
LanguageName
Jezik		 (Obavezno) Osnovni jezik u okruženju.
DomainName
Ime domena		 (Obavezno) Ovo je niska specifična za okruženje koja čini deo URL adrese. Na primer, za okruženje sa sledećom URL adresom: https://powerappsbuildtasks.crm.dynamics.com/, ime domena bi bilo „powerappsbuildtasks“.

beleške: Ako unesete ime domena koje je već u upotrebi, zadatak dodaje numeričku vrednost imenu domena, počevši od KSNUMKS-a. U gorenavedenom primeru, URL adresa može da postane https://powerappsbuildtasks0.crm.dynamics.com/.

Power Platform brisanje okruženja

Briše okruženje.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Servisna krajnja tačka za koju želite da izbrišete okruženje (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
PowerPlatformSPN
Power Platform principal usluge		 Servisna krajnja tačka za koju želite da izbrišete okruženje (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.

Power Platform Dodeli korisnika

Dodelite korisnika ciljnom okruženju sa određenom bezbednosna uloga.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge za okruženje koje želite da dodelite korisniku (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
User
Power Platform Korisničko ime		 Microsoft Entra ID objekta ili glavno ime korisnika koje se dodeljuje ciljnom okruženju.
Role
Ime ili ID bezbednosna uloga		 Ime bezbednosna uloga ili ID koji će biti dodeljen korisniku.
ApplicationUser
Power Platform Korisničko ime aplikacije		 Specificira da li je ulazni korisnik korisnik aplikacije (true|false).

Power Platform Resetuj okruženje

Resetuje okruženje.

IAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Servisna krajnja tačka koju želite da resetujete okruženje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
PowerPlatformSPN
Power Platform principal usluge		 Servisna krajnja tačka koju želite da resetujete okruženje (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.

Power Platform rezervno okruženje

Pravi rezervnu kopiju okruženja.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Krajnja tačka usluge koju želite da napravite rezervnu kopiju okruženja (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka usluge koju želite da napravite rezervnu kopiju okruženja (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
BackupLabel
Oznaka rezervne kopije		 (Obavezno) Oznaka koja će se dodeliti rezervnoj kopiji.

Power Platform kopiranje okruženja

Kopira okruženje u ciljno okruženje. Dostupne su dve vrste kopija: kompletna i minimalna. Kompletna kopija uključuje i podatke i metapodatke rešenja (prilagođavanja), dok minimalna kopija uključuje samo metapodatke rešenja, a ne stvarne podatke.

YAML iseč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'
    DisableAdminMode: false

Parametri (Copy-env)

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Servisna krajnja tačka za izvorno okruženje iz kojeg želite da kopirate (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
PowerPlatformSPN
Power Platform principal usluge		 Servisna krajnja tačka za izvorno okruženje iz kojeg želite da kopirate (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
TargetEnvironmentUrl
URL adresa ciljnog okruženja		 (Obavezno) URL adresa za ciljno okruženje u koje želite da kopirate.
CopyType
Tip kopiranja		 Tip kopiranja koji treba obaviti: FullCopy ili MinimalCopy
OverrideFriendlyName
Izmena prepoznatljivog imena		 Promenite prepoznatljivo ime ciljnog okruženja u drugo ime (true|false).
FriendlyName
Prepoznatljivi naziv		 Prepoznatljivo ime ciljnog okruženja.
DisableAdminMode
Onemogućavanje režima administracije		 Da li onemogućiti režim administracije (true|false).

Power Platform Vraćanje životne sredine

Vraća okruženje u datu rezervnu kopiju.

IAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformEnvironment
URL adresa Power Platform okruženja		 Servisna krajnja tačka za izvorno okruženje iz kojeg želite da vratite (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
PowerPlatformSPN
Power Platform principal usluge		 Servisna krajnja tačka za izvorno okruženje iz kojeg želite da vratite (na primer, https://powerappsbuildtools.crm.dynamics.com). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
RestoreLatestBackup
Najnovija rezervna kopija za vraćanje		 Da li da vratite najnoviju rezervnu kopiju ili obezbedite RestoreTimeStamp (true|false).
RestoreTimeStamp
DateTime rezervne kopije		 Datum i vreme rezervne kopije u formatu „mm/dd/yyyy hh:mm“ ILI niska „latest“.
TargetEnvironmentUrl
URL adresa ciljnog okruženja		 (Obavezno) URL za ciljno okruženje koje želite da vratite.
FriendlyName
Ime obnovljenog okruženja		 (Opciono) Ime obnovljenog okruženja.
DisableAdminMode
Onemogućavanje režima administracije		 Da li onemogućiti režim administracije (true|false).

Izvoz Dataverse podataka

Izvozite podatke iz okruženja sa obezbeđenom šemom.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje iz kojeg želite da izvezete podatke (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
SchemaFile
Ime XML datoteke šeme		 Ime XML datoteke šeme. Može se kreirati pomoću alata za migraciju konfiguracije.
DataFile
Ime datoteke sa podacima		 Naziv datoteke za podatke za izvoz (zip datoteka).
Overwrite
Prepisivanje sadržaja		 Power Pages sadržaj sajta za prepisivanje (true|false).

Uvoz Dataverse podataka

Uvoz podataka u okruženje.

YAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje koje želite da uvezete podatke (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
DataFile
Ime datoteke sa podacima		 Ime datoteke za komprimovani zip) datoteka podataka za uvoz, ili fascikla sa data-schema.xml i data.xml da se uveze.

Power Pages Zadaci upravljanja

Zadaci za rad sa Power Pages veb stranicom.

Power Platform PAPortal za preuzimanje

Preuzmite sadržaj Power Pages veb-lokacije iz aktuelnog Dataverse okruženja.

IAML isečak (dovnload-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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje iz kojeg želite da preuzmete sadržaj (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
WebsiteId
ID sajta portala		 Power Pages ID sajta za preuzimanje.
Overwrite
Prepisivanje sadržaja		 Power Pages sadržaj sajta za prepisivanje (true|false).
ModelVersion
Model podataka o lokaciji		 Označava da li će podaci o lokaciji koji se učitavaju koristiti standardni (1) ili poboljšani model podataka (2). Podrazumevana vrednost je '1'.

Power Platform PAPortal za otpremanje

Prenesite Power Pages sadržaj veb sajta u trenutno Dataverse okruženje.

IAML iseč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
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje u koje želite da otpremite sadržaj (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
UploadPath
Putanja sadržaja za otpremanje		 Put odakle Power Pages će sadržaj veb sajta biti postavljen.
ModelVersion
Model podataka o lokaciji		 Označava da li će podaci o lokaciji koji se učitavaju koristiti standardni (1) ili poboljšani model podataka (2). Podrazumevana vrednost je '1'.

Katalog zadataka Power Platform (verzija za pregled)

Ovi zadaci obavljaju akcije protiv kataloga u Power Platform i uključuju sledeće.

Belešku

Trenutno, kataloški zadaci za Power Platform su verzija za pregled .

Instalirajte stavku kataloga

Instalirajte stavku kataloga u ciljno okruženje.

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje u koje želite da otpremite sadržaj (na primer). https://powerappsbuildtools.crm.dynamics.com Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
Environment
URL adresa ciljnog okruženja		 (Obavezno) Environment url ovaj zadatak cilja.
CatalogItemId
Katalog ID predmeta koji će biti instaliran		 (Obavezno) Katalog stavka da se instalira na ciljnom okruženju.
TargetEnvironmentUrl
URL adresa ciljnog okruženja		 (Obavezno) URL ciljnog okruženja za instalaciju kataloške stavke u (na primer, "https://YourOrg.crm.dynamics.com").
PollStatus
Proverite status ankete		 (Opciono) Anketa za proveru statusa vašeg zahteva (true|false).

Parametri (katalog-install)

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

Pošalji odobrenje kataloga

Prosledite zahtev za odobrenje kataloga.

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje u koje želite da otpremite sadržaj (na primer, "https://powerappsbuildtools.crm.dynamics.com"). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
Environment
URL adresa ciljnog okruženja		 (Obavezno) Environment url ovaj zadatak cilja.
CatalogSubmissionFile
Datoteka za podnošenje kataloga		 (Obavezno) Navedite putanju i ime datoteke datoteke za podnošenje kataloga.
UsePackageSolutionZipFile
Tip datoteke		 Tip datoteke: paket ili rešenje zip datoteka.
SolutionZipFile
Rešenje zip ime datoteke		 Navedite putanju i ime datoteke zip datoteke rešenja.
PollStatus
Proverite status ankete		 (Opciono) Anketa za proveru statusa vašeg zahteva (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 zahteva za katalog

Nabavite status zahteva za instalaciju / slanje kataloga.

Parametri Opis
authenticationType
Tip potvrde identiteta		 (Obavezno za SPN) Navedite PowerPlatformEnvironment za vezu sa korisničkim imenom/lozinkom ili PowerPlatformSPN za tajnu vezu principala usluge/klijenta.
PowerPlatformSPN
Power Platform principal usluge		 Krajnja tačka servisa za okruženje u koje želite da otpremite sadržaj (na primer, "https://powerappsbuildtools.crm.dynamics.com"). Definisano u okviru stavke Servisne veze u odeljku Postavke projekta pomoću tipa veze Power Platform.
Environment
URL adresa ciljnog okruženja		 (Obavezno) Environment url ovaj zadatak cilja.
TrackingId
Zahtev za praćenje ID		 (Obavezno) Zahtev za praćenje ID.
RequestType
Tip zahteva		 (Obavezno) Reqeust tip. (Vrednosti: Instaliraj | Pošalji).

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

Pravljenje i objavljivanje kanala

Sada kada smo identifikovali šta možete da radite pomoću razvojnih alatki, da vidimo kako možete da primenite ove alatke na kanale za razvoj i objavljivanje. Konceptualni pregled je prikazan u nastavku. Hajde da vidimo neke detalje primene kanala pomoću Build Tools zadataka u pododeljcima koji slede.

Da biste saznali više o kreiranju ovih kanala i stvarno praktično dali ovlašćenje kanalu koristeći Microsoft Power Platform Build Tools, dovršite Build Tools laboratoriju, koju možete preuzeti sa platforme GitHub.

Više informacija o Azure Pipelines: Koristite Azure Pipelines

Pravljenje kanala: Izvoz rešenja iz razvojnog okruženja

Sledeća slika prikazuje zadatke razvojne alatke koje možete dodati u kanal koji izvozi rešenje iz razvojnog okruženja.

Izvozite rešenje iz razvojnog okruženja (DEV).

Pravljenje kanala: Izrada kompletnog rešenja

Sledeća slika prikazuje zadatke razvojne alatke koje možete dodati u kanal koji izrađuje kompletno rešenje.

Izgradite kompletno rešenje.

Objavite kanal: Primena u proizvodnom okruženju

Sledeća slika prikazuje zadatke razvojne alatke koje možete dodati u kanal koji primenjuje u proizvodnom okruženju.

Rasporedite u proizvodno okruženje (PROD).

Takođe pogledajte

Microsoft Power Platform Izgradite alate za Azure DevOps