Partekatu honen bidez:

Microsoft Power Platform konpilazio-tresnen zereginak

  • Artikulua

Erabilgarri dauden zereginak hurrengo ataletan deskribatzen dira. Ondoren, zeregin hauek erabiltzen dituzten Azure Pipelines adibide batzuk erakusten ditugu. Eraikuntza-tresnei eta haiek deskargatu nola deskargatu buruzko informazio gehiago lortzeko, ikus Microsoft Power Platform Azure Pipelines-erako eraikitzeko tresnak.

Laguntzailearen zeregina

Eskuragarri dauden laguntzaile-zereginak deskribatzen dira jarraian.

Power Platform Tresna instalatzailea

Zeregin hau beste edozein baino lehen gehitu behar da Power Platform Eraiki tresnak eraikitzeko eta askatzeko kanalizazioak. Zeregin honek multzo bat instalatzen du Power Platformagenteak exekutatu behar dituen tresna espezifikoak Microsoft Power Platform konpilazio-zereginak eraiki. Zeregin honek ez du konfigurazio gehiago behar gehitzen denean. Zeregin honek instalatzen ari diren tresna bakoitzaren bertsio zehatzetarako parametroak ditu.

Tresnearen bertsioekin denborarekin eguneratuta egon, ziurtatu parametro hauek kanalizazioa behar bezala funtzionatzeko behar diren tresnen bertsioei dagozkiela.

YAML kode zati (Instalatzailea)

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

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

Parametroak (instalatzailea)

Parametroak Deskribapenak
DefaultVersion
Erabili tresnaren bertsio lehenetsiak		 Ezarri gisa egia tresna guztien bertsio lehenetsia erabiltzeko, bestela faltsua. Beharrezkoa (eta faltsua) edozein tresna-bertsio zehazten denean.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Tresnaren bertsioa		 Erabili beharreko tresnaren bertsio zehatza.

Power Platform WhoAmI

Egiaztatu Power Platform ingurumen zerbitzuen konexioa WhoAmI eskaera konektatuz eta eginez. Zeregin hau erabilgarria izan daiteke kanalizazioan sartzeko, konektagarritasuna prozesatzeko hasi aurretik egiaztatzeko.

YAML kode zati (WhoAmI)

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs: 
#   Service Principal/client secret (supports MFA)
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'My service connection'

# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@0
  displayName: 'Power Platform WhoAmI'

  inputs:
#   Username/password (no MFA support)
    PowerPlatformEnvironment: 'My service connection'

Parametroak (WhoAmI)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Aukerakoa) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Konektatu nahi duzun ingurunearen zerbitzuaren amaiera-puntua. Zehaztuta dago Zerbitzuaren konexioak aukeran Proiektuaren ezarpenak sekzioan. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Konektatu nahi duzun ingurunearen zerbitzuaren amaiera-puntua. Zehaztuta dago Zerbitzuaren konexioak aukeran Proiektuaren ezarpenak sekzioan.

Kalitate-egiaztapena

Hurrengo atalean irtenbide baten kalitatea egiaztatzeko dauden zereginak daude.

Power Platform Checker

Zeregin honek zure soluzioen analisi estatikoko egiaztapena egiten du praktika onen arau multzo baten arabera, zure irtenbidea eraikitzean nahi gabe sartu ditzakezun eredu problematikoak identifikatzeko.

YAML kode zati (zuzentzailea)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  displayName: 'Power Platform Checker '
  inputs:
    PowerPlatformSPN: 'Dataverse service connection'
    UseDefaultPACheckerEndpoint: false
    CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
    FileLocation: sasUriFile
    FilesToAnalyzeSasUri: 'SAS URI'
    FilesToAnalyze: '**\*.zip'
    FilesToExclude: '**\*.tzip'
    RulesToOverride: 'JSON array'
    RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'

Parametroak (zuzentzailea)

Parametroak Deskribapenak
PowerPlatformSPN
Zerbitzuaren konexioa		 (Beharrezkoa) Lizentziadun konexioa Microsoft Power Platform ingurunea behar da Power Platform egiaztatzailea. Zerbitzuaren konexioak hemen zehazten dira Zerbitzuaren konexioak beherako Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikus BuildTools.EnvironmentUrl azpian Power Platform Sortu ingurunea

Oharra: Zerbitzu nagusia eta erabiltzaile-izena/pasahitza autentifikazio metodoak eskuragarri daude egiaztatzaile-zereginerako. Zeregin honekin erabiltzeko zerbitzuaren nagusiak nola konfiguratu informazio gehiago lortzeko, ikus Konfiguratu zerbitzurako konexio nagusiak Power Platform inguruneetan.
UseDefaultPACheckerEndpoint
Erabili lehenetsia Power Platform Checker amaierako puntua		 Lehenespenez (egia), egiaztatzaile-zerbitzuaren kokapen geografikoak konektatzen zaren ingurunearen geografia bera erabiltzen du.
CustomPACheckerEndpoint
PAC egiaztatzaileen amaierako puntu pertsonalizatua		 Beharrezkoa denean UseDefaultPACheckerEndpoint da faltsua. Erabili beharreko beste geometria bat zehaz dezakezu, adibidez https://japan.api.advisor.powerapps.com. Eskuragarri dauden geografien zerrenda ikusteko, ikus Erabili Power Platform Checker API. .
FileLocation
Aztertu beharreko fitxategien kokapena		 Beharrezkoa da sarbide partekatuko sinaduraren (SAS) URL sasUriFile batetik fitxategi bat erreferentzia egitean.

Oharra: garrantzitsua da esportatutako irtenbide-fitxategi bat erreferentzia egitea eta ez biltegiko deskonprimitutako iturburu-fitxategiak. Kudeatutako eta kudeatu gabeko irtenbide fitxategiak aztertu daitezke.
FilesToAnalyzeSasUri
SAS fitxategiak aztertzeko		 Beharrezkoa denean FileLocation ezarrita dago sasUriFile. Idatzi SAS URI. SAS URI bat baino gehiago gehitu koma (,) edo koma (;) bereizitako zerrendaren bidez.
FilesToAnalyze
Lokala fitxategiak aztertzeko		 Beharrezkoa SAS fitxategiak aztertzen ez direnean. Zehaztu aztertu beharreko zip fitxategien bide-izena eta izena. Komodinak erabil daitezke. Adibidez, idatzi **\*.zip azpikarpeta guztietako zip fitxategi guztientzat.
FilesToExclude
Lokala fitxategiak baztertzeko		 Zehaztu analisitik kanpo utzi beharreko fitxategien izenak. Bat baino gehiago bada, eman koma (,) edo puntu eta koma (;) bereizitako zerrenda baten bidez. Zerrenda honek fitxategi-izen osoa edo hasierako edo amaierako komodinak dituen izena izan dezake, hala nola *jquery edo form.js
RulesToOverride
Gainditzeko arauak		 Ezabatzeko arauak eta mailak dituen JSON array bat. OverrideLevel-erako onartutako balioak hauek dira: Critical, High, Medium, Low, Informational. Adibidez: [{"Id":"meta-remove-dup-reg", "OverrideLevel":"Ertaina"},{"Id": "il-Avoid-Specialized-Update-Ops","OverrideLevel": "Ertaina"}]
RuleSet
Arau multzoa		 (Beharrezkoa) Zehaztu zer arau ezarri behar den. Hauek dira erabilgarri dauden bi arau multzoak:
  • Soluzio-egiaztapena: arau multzo hau Power Apps maker atarikotik exekutatzen den bera da.
  • AppSource: Aplikazio bat ziurtatzeko erabiltzen den arau-multzo hedatua AppSourcen argitaratu aurretik.
ErrorLevel
Akats maila		 Errorearekin batera, atalase-parametroak onartzen diren erroreen eta abisuen larritasuna definitzen du. Onartutako atalase-balioak hauek dira <level>IssueCount where level=Kritikoa, Altua, Ertaina, Baxua eta Informazioa.
ErrorThreshold
Akatsen atalasea		 Egiaztatzaileak egiaztatzen ari den soluzioak gainditzeko baimendutako maila zehatz bateko errore kopurua (>=0) definitzen du.
FailOnPowerAppsCheckerAnalysisError
Errorearen hutsegitea		 Noiz egia, huts egin bada Power Apps Egiaztatzaileen analisia Huts egin edo FinishedWithErrors gisa itzultzen da.
ArtifactDestinationName
DevOps artefaktuaren izena		 Zehaztu Azure Artifacts izena egiaztatzailearen .sarif fitxategirako.

Soluzioaren zereginak

Zeregin multzo honek konponbide ekintzak automatiza ditzake. Ingurune bat sortu, kopiatu edo leheneratzen duten atal honetan geroago azaltzen diren ingurune-zereginek zerbitzu-konexioak gainidazten dituzte sortu berri diren inguruneekin. Zeregin horiei esker, konponbide-zereginak egitea ahalbidetzen dute eskaeraren arabera sortzen diren inguruneen aurka.

Power Platform inportatu soluzioa

Irtenbidea xede ingurune batera inportatzen du.

YAML kode zati (Inportatu)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@0
  displayName: 'Power Platform Import Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    HoldingSolution: true
    OverwriteUnmanagedCustomizations: true
    SkipProductUpdateDependencies: true
    ConvertToManaged: true

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

Parametroak (Inportazioa)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Soluzioa inportatu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Soluzioa inportatu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
SolutionInputFile
Soluzioaren sarrera-fitxategia		 (Derrigorrezkoa) Helburu-ingurunean inportatzeko irtenbide .zip fitxategiaren bidea eta fitxategi-izena (adibidez, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Oharra: Aldagaiek modu egokian eskaintzen dituzte zure hoditeriako hainbat zatitan datu funtsezko datuak. Ikusi Erabili aurrez definitutako aldagaiak zerrenda integrala lortzeko.
HoldingSolution
Inportatu euste-irtenbide gisa		 Soluzio bat eguneratu behar denean erabiltzen den parametro aurreratua (egia|faltsua). Parametro honek Dataverse irtenbidea ostatatzen du baina ez du irtenbidea eguneratzen Aplikatu irtenbidea bertsio-berritzea ataza exekutatu arte.
OverwriteUnmanagedCustomizations
Gainidatzi kudeatu gabeko pertsonalizazioak		 Zehaztu kudeatu gabeko pertsonalizazioak gainidatzi nahi dituzun (egia|faltsua).
SkipProductUpdateDependencies
Saltatu produktuaren eguneratze-menpekotasunak		 Zehaztu produktuen eguneratzeei lotutako mendekotasunen betearaztea saltatu behar den (egia|faltsua).
ConvertToManaged
Bihurtu kudeatuta		 Zehaztu kudeatutako soluzio gisa inportatu nahi duzun (egia|faltsua).
AsyncOperation
Asinkronoa inportatu		 Hautatzen bada (egia), inportazio eragiketa modu asinkronoan egingo da. Konponbide handiagoetarako gomendagarria da zeregin hau beste 4 minutu igaro ondoren automatikoki iraungiko delako. Asinkronoa hautatzen baduzu, galdeketa egingo da eta MaxAsyncWaitTime iritsi arte itxarongo da (egia|faltsua).
MaxAsyncWaitTime
Gehienezko itxaronaldia		 Eragiketa asinkronorako gehienezko itxaron-denbora minututan; lehenetsia 60 min (ordu 1) da Azure DevOps zereginetarako lehenetsia.
PublishWorkflows
Aktibatu prozesuak inportatu ondoren		 Zehaztu soluzioaren prozesuren bat (lan-fluxuak) inportatu ondoren aktibatu behar den (egia|faltsua).
UseDeploymentSettingsFile
Erabili inplementazio-ezarpenen fitxategia		 Konexioaren erreferentziak eta ingurunearen aldagaiaren balioak ezarri daitezke erabiliz inplementazio-ezarpenak fitxategia (egia|faltsua).
DeploymentSettingsFile
Inplementazio-ezarpenen fitxategia		 (Beharrezkoa denean UseDeploymentSettingsFile=egia) Inplementazioaren ezarpenen fitxategiaren bidea eta fitxategiaren izena.

Power Platform Gehitu soluzio osagaia

Kudeatu gabeko soluzio bati irtenbide-osagai bat gehitzen dio.

YAML kode zati (Gehitu)

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

Parametroak (gehitu)

Parametroak Deskribapenak
ComponentId
Soluzio-osagaiaren IDa		 Helburu-soluzioan gehitu beharreko osagaiaren eskemaren izena edo IDa.
ComponentType
Power Platform ingurunearen URLa		 Gehitzen ari zaren soluzio-osagaia adierazten duen balioa. Ikus Erabili aurrez definitutako osagai motak osagaien balioen zerrenda osoa lortzeko.
SolutionUniqueName
Soluzioaren izena		 Irtenbidearen izen berezia.
AddRequiredComponents
Disoluzioaren osagaiaren menpeko beste soluzio batetik behar diren osagaiak		 (Aukerakoa) Gehitzen ari zaren soluzio-osagaiak behar dituen beste soluzio-osagai batzuk kudeatu gabeko soluzioari ere gehitu behar zaizkion adierazten du.
Environment
Ingurunearen URLa edo IDa		 (Aukerakoa) Ingurunearen URLa edo xede-ingurunearen IDa.

Power Platform Bertsio-berritu soluzioa

Euste-soluzio gisa inportatu den soluzioa bertsio berritzen du.

YAML kode zati (Bertsioa)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    AsyncOperation: false

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@0
  displayName: 'Power Platform Apply Solution Upgrade '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    MaxAsyncWaitTime: 45

Parametroak (Bertsioa)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Soluzioa eguneratu nahi duzun zerbitzuaren amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Soluzioa eguneratu nahi duzun zerbitzuaren amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
SolutionName
Soluzioaren izena		 (Derrigorrezkoa) Bertsio-berritzea aplikatzeko irtenbidearen izena. Beti erabili soluzioaren Izena, ez Bistaratzeko izena.
AsyncOperation
Bertsio asinkronoa		 Hautatzen bada (egia), bertsioa berritzeko eragiketa gauzatuko da sorta lan asinkrono bat bezala. Asinkronoa hautatzen baduzu, galdeketa egingo da eta MaxAsyncWaitTime iritsi arte itxarongo da.
MaxAsyncWaitTime
Gehienezko itxaronaldia		 Eragiketa asinkronorako gehienezko itxaron-denbora minututan; lehenetsia 60 min (ordu 1) da Azure DevOps zereginetarako lehenetsia.

Oharra

Aldagaiek modu egokian eskaintzen dituzte zure hoditeriako hainbat zatitan datu funtsezko datuak. Ikusi Erabili aurrez definitutako aldagaiak zerrenda integrala lortzeko. Helburu-ingurunerako konexio-erreferentzia eta ingurune-aldagaien informazioa aurrez bete dezakezu irtenbide bat inplementazio-ezarpen-fitxategi bat erabiliz inportatzen duzun bitartean.

Informazio gehiago: Bete aurretik konexio-erreferentziak eta ingurune-aldagaiak. inplementazio automatizatuetarako

Power Platform esportatu soluzioa

Iturri ingurune batetik irtenbidea esportatzen du.

YAML kode zati (Esportatu)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@0
  displayName: 'Power Platform Export Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    Managed: true
    MaxAsyncWaitTime: 120
    ExportAutoNumberingSettings: true
    ExportCalendarSettings: true
    ExportCustomizationSettings: true
    ExportEmailTrackingSettings: true
    ExportGeneralSettings: true
    ExportIsvConfig: true
    ExportMarketingSettings: true
    ExportOutlookSynchronizationSettings: true
    ExportRelationshipRoles: true
    ExportSales: true

Parametroak (Esportazioa)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Soluzioa eguneratu nahi duzun zerbitzuaren amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Soluzioa eguneratu nahi duzun zerbitzuaren amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
SolutionName
Soluzioaren izena		 (Beharrezkoa) Esportatuko den soluzioaren izena. Beti erabili soluzioaren Izena, ez Bistaratzeko izena.
SolutionOutputFile
Soluzioaren irteera-fitxategia		 (Derrigorrezkoa) Iturburu-ingurunea esportatzeko solution.zip fitxategiaren bidea eta fitxategi-izena (adibidez, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Oharra: Aldagaiek modu egokian eskaintzen dituzte zure hoditeriako hainbat zatitan datu funtsezko datuak. Ikusi Erabili aurrez definitutako aldagaiak zerrenda integrala lortzeko.
AsyncOperation
Asinkronoa esportatu		 Hautatzen bada (egia), esportatzeko eragiketa gauzatuko da sorta lan asinkrono bat bezala. Asinkronoa hautatzen baduzu, galdeketa egingo da eta MaxAsyncWaitTime iritsi arte itxarongo da.
MaxAsyncWaitTime
Gehienezko itxaronaldia		 Eragiketa asinkronorako gehienezko itxaron-denbora minututan; lehenetsia 60 min (ordu 1) da Azure DevOps zereginetarako lehenetsia.
Managed
Esportatu kudeatu gisa		 Hautatzen bada (egia), esportatu soluzioa kudeatutako soluzio gisa; bestela, kudeatu gabeko irtenbide gisa esportatu.
ExportAutoNumberingSettings
Esportatu zenbaki automatikoko ezarpenak		 Esportatu zenbaki automatikoko ezarpenak (egia|faltsua).
ExportCalendarSettings
Esportatu egutegi-ezarpenak		 Esportatu egutegi-ezarpenak (egia|faltsua).
ExportCustomizationSettings
Esportatu pertsonalizazio-ezarpenak		 Esportatu pertsonalizazio-ezarpenak (egia|faltsua).
ExportEmailTrackingSettings
Esportatu mail-jarraipenaren ezarpenak		 Esportatu posta elektronikoaren jarraipenaren ezarpenak (egia|faltsua).
ExportGeneralSettings
Esportatu ezarpen orokorrak		 Esportatu orokorrak diren ezarpenak (egia|faltsua).
ExportIsvConfig
Esportatu ISV konfigurazioa		 Esportatu ISV konfigurazioa (egia|faltsua).
ExportMarketingSettings
Esportatu Marketin-ezarpenak		 Esportatu marketin-ezarpenak (egia|faltsua).
ExportOutlookSynchronizationSettings
Esportatu Outlook sinkronizazio ezarpenak		 Esportatu Outlook sinkronizazioaren ezarpenak (egia|faltsua).
ExportRelationshipRoles
Esportatu harreman-funtzioa		 Esportatu harreman-funtzioa (egia|faltsua).
ExportSales
Esportatze-salmentak		 Esportazioen salmenta (egia|faltsua).

Power Platform deskonprimatzeko soluzioa

Deskonprimatzeko soluzioaren zereginak konprimitutako konponbide fitxategia hartzen du eta XML fitxategi askotan eta beste fitxategi batzuetan bereizten ditu, fitxategi horiek iturri kontrol sistema batek errazago kudeatu ditzan.

YAML kode zati (deskonprimitu)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.unpack-solution.PowerPlatformUnpackSolution@0
  displayName: 'Power Platform Unpack Solution '
  inputs:
    SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
    SolutionTargetFolder: 'C:\Public'
    SolutionType: Both

Parametroak (deskonprimitu)

Parametroak Deskribapenak
SolutionInputFile
Soluzioaren sarrera-fitxategia		 (Beharrezkoa) Deskonprimatu beharreko solution.zip fitxategiaren bide-izena eta izena.
SolutionTargetFolder
Helburuko karpeta soluzioa deskonprimatzeko		 (Beharrezkoa) Soluzioa deskonprimatu nahi duzun bide-izena eta helburuko karpeta.
SolutionType
Soluzio mota		 (Beharrezkoa) Aukeratu deskonprimatu nahi duzun soluzioa. Aukerak hauek dira: kudeatu gabea (Gomendatua), Kudeatutako, eta Biek.

Power Platform paketearen soluzioa

Zeregin honek iturburu-kontrolean irudikatutako irtenbidea paketatzen du ingurune batera inportatu daitekeen solution.zip fitxategian.

YAML kode zati (konprimitu)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.pack-solution.PowerPlatformPackSolution@0
  displayName: 'Power Platform Pack Solution '
  inputs:
    SolutionSourceFolder: 'C:\Public'
    SolutionOutputFile: 'Contoso_sample_1_0_0_1_managed.zip'
    SolutionType: Managed

Parametroak (konprimitu)

Parametroak Deskribapenak
SolutionOutputFile
Soluzioaren irteera-fitxategia		 (Beharrezkoa) Soluzioa paketatzeko solution.zip fitxategiaren bide-izena eta fitxategiaren izena.
SolutionSourceFolder
Paketatu beharreko soluzioaren iturburuko karpeta		 (Beharrezkoa) Paketatu beharreko soluzioaren bide-izena eta iturburuko karpeta.
SolutionType
Soluzio mota		 (Beharrezkoa) Aukeratu konprimatu nahi duzun soluzioa. Aukerak hauek dira: kudeatua (Gomendatua), Kudeatu gabea, eta Biek.

Power Platform Ezabatu soluzioa

Helburuko inguruneko soluzioa ezabatzen du.

YAML kode zati (Ezabatu)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-solution.PowerPlatformDeleteSolution@0
  displayName: 'Power Platform Delete Solution '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'

Parametroak (Ezabatu)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Soluzioa ezabatu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Soluzioa ezabatu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
SolutionName
Soluzioaren izena		 (Eskatutakoa) Ezabatzeko soluzioaren izena. Beti erabili soluzioaren Izena, ez Bistaratzeko izena.

Power Platform Argitaratu pertsonalizazioak

Ingurune batean pertsonalizazio guztiak argitaratzen ditu.

YAML kode zati (Argitaratu)

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

Parametroak (Argitaratu)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Pertsonalizazioak argitaratu nahi dituzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Pertsonalizazioak argitaratu nahi dituzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea

Power Platform ezarri soluzioaren bertsioa

Irtenbide baten bertsioa eguneratzen du.

YAML kode zati (bertsioa)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-solution-version.PowerPlatformSetSolutionVersion@0
  displayName: 'Power Platform Set Solution Version '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    SolutionName: 'Contoso_sample'
    SolutionVersionNumber: 1.0.0.0

Parametroak (bertsioa)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Soluzio-bertsioa ezarri nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Soluzio-bertsioa ezarri nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
SolutionName
Soluzioaren izena		 (Derrigorrezkoa) Bertsioa ezartzeko soluzioaren izena. Beti erabili soluzioaren Izena, ez Bistaratzeko izena.
SolutionVersionNumber
Soluzioaren bertsio-zenbakia		 (Beharrezkoa) ezarri nahi duzun bertsio zenbakia.

Bertsio zenbakia kanalizazioan kodetu daitekeen arren, gomendatzen da Azure DevOps pipeline aldagaia bezalakoa BuildId. Honek bertsio zenbakiaren forma zehatza definitzeko aukerak eskaintzen ditu "Aukerak" fitxan, adibidez: $(Urtea:aaaa)-$(Hilabetea:HH)-$(Eguna:ee)-$(rev:rr)-3

Definizio hau Ezarri soluzioaren bertsioa zereginean erabil daiteke, bertsio zenbakiaren propietatea ezarriz: $(Build.BuildId) 20200824.0.0.2 kodeketa gogorraren ordez.

Bestela, Powershell-eko ataza script-a $(Get-Date -Format yyyy.MM.dd.HHmm) irteerako aldagai hutsean ezarri da SolutionVersion Write-Host gisa ("##vso[task.setvariable variable=SolutionVersion;]$bertsioa"), Set Solution gisa bertsioa $(SolutionVersion).

Power Platform Ezarri Konexio-aldagaiak

BuildTools.* aldagaiak ezartzen ditu script-zeregin pertsonalizatuen sarbidea emateko zerbitzu-konexioa egia iturri bakar gisa erabiltzeko.

YAML kode zati (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

Parametroak (SetConnectionVariables)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Konexio-aldagaiak ezarri nahi dituzun zerbitzuaren amaiera-puntua. Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
timeoutInMinutes
Debora-muga		 Zerbitzariak bertan behera utzi aurretik zeregin bat exekutatzeko baimena duen gehienezko denbora, minututan, zehazten du. Zero balio batek denbora-muga infinitua adierazten du.
retryCountOnTaskFailure
Saiakera kopurua zereginak huts egin badu		 Zeregin honen hutsegite kasuan gertatuko den berriro saiakera kopurua zehazten du. Ez da onartzen agenterik gabeko zereginetarako.
ApplicationId
Saioa hasteko aplikazioaren IDa		 (Erabiltzaile-izena/pasahitza behar da) Saioa hasteko erabili beharreko aplikazioaren IDa (Ikus beheko ohar gehigarria).
RedirectUri
Zehaztutako aplikazioaren URI birbideratu		 (Erabiltzaile-izena/pasahitza behar da) Zehaztutako aplikazioaren URI birbideratu. Beharrezkoa da aplikazioaren ID bat zehaztean. (Ikus beheko ohar gehigarria).

Oharra

Erabiltzaile-izena/pasahitza autentifikazio mota erabiltzean, Aplikazioaren IDa eta Birbideratzeko Uri beharko dira. Authenticate oauth dokumentu honek autentifikaziorako aplikazioaren erregistroa zergatik sortu behar duzun azaltzen du Dataverse. Erabiltzaile-izena/pasahitza autentifikazioa erabiliz konektatzen zarenean, konexioak erabiltzaile baten izenean konektatzen den aplikazio gisa jokatzen du Dataverse.

Power Platform inplementazio paketea

Pakete bat ingurune batera zabaltzen du. Inplementatzea paketea soluzio-fitxategi bakarraren aurka hainbat soluzio, datu eta kode ingurune batean inplementatzeko aukera ematen dizu.

YAML kode zati (Inplementatu)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@0
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parametroak (Inplementatu)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Paketea inplementatu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Paketea inplementatu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikusi BuildTools.EnvironmentUrl azpian Power Platform sortu ingurunea
PackageFile
Pakete fitxategia		 (Derrigorrezkoa) Pakete-fitxategi-multzoaren (.dll) bidea eta fitxategi-izena.
MaxAsyncWaitTime
Gehienezko itxaronaldia		 Eragiketa asinkronorako gehienezko itxaron-denbora minututan; lehenetsia 60 min (ordu 1) da Azure DevOps zereginetarako lehenetsia.

Ingurunearen kudeaketa-zereginak

Automatizatu ingurumenaren bizitza-zikloaren kudeaketa (ELM) egitekoak.

Power Platform sorrera-ingurunea

Sortu egiten du ingurune berria. Ingurune berri bat sortzeak ere automatikoki sortzen du BuildTools.EnvironmentUrl.

Garrantzitsua da

Ezarritakoan, BuildTools.EnvironmentUrl gisa erabiliko da zerbitzu-konexio lehenetsia hodietan hurrengo zereginetarako. Artikulu honetan deskribatutako zeregin bakoitzak zerbitzu-konexioko amaiera-puntua soilik erabiltzen du BuildTools.EnvironmentUrl ez dago ezarrita.

Ingurune berri bat zure lizentziak edo gaitasunak ingurune osagarriak sortzea ahalbidetzen badu bakarrik eman daiteke. Ikusteko gaitasuna ikusteko informazio gehiago lortzeko Edukiera orriaren xehetasunak.

YAML kode zati (Sortu-env)

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

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

Parametroak (Sortu-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Ingurunea sortu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Ingurunea sortu nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
DisplayName
Bistaratzeko izena		 (Beharrezkoa) Sortu den inguruaren bistaratzeko izena.
LocationName
Inplementazio-eskualdea		 (Beharrezkoa) Ingurunea sortzeko erabili beharreko eskualdea.
EnvironmentSku
Ingurune mota		 (Beharrezkoa) Inplementatu nahi den instantzia mota. Aukerak dira Sandbox, Ekoizpena, Epaiketa, eta SubscriptionBasedTrial.
AppsTemplate
Aplikazioak		 Proba ez den ingurune mota baterako, onartzen diren aplikazioak D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation eta D365_Sales dira.
CurrencyName
Moneta		 (Beharrezkoa) Sortutako ingurunerako oinarrizko moneta. Ingurunea sortu ondoren ezin da moneta eguneratu.
LanguageName
Hizkuntza		 (Beharrezkoa) Ingurunearen oinarrizko hizkuntza.
DomainName
Domeinu-izena		 (Beharrezkoa) URLaren zati den ingurugiroari buruzko katea da. Adibidez, URL hau duen ingurune baterako: https://powerappsbuildtasks.crm.dynamics.com/, domeinuaren izena 'powerappsbuildtasks' izango litzateke.

Oharra: erabiltzen ari zaren domeinu izen bat sartzen baduzu, zereginak zenbakizko balioa erantsiko dio domeinu izenari, 0tik hasita. Goiko adibidean, URL bihur daitekehttps://powerappsbuildtasks0.crm.dynamics.com/.

Power Platform Ezabatu ingurunea

Ezabatu egiten du ingurunea.

YAML kode zati (Ezabatu-env)

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

Parametroak (Ezabatu-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Ingurunea ezabatu nahi duzun zerbitzuaren amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Ingurunea ezabatu nahi duzun zerbitzuaren amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.

Power Platform Esleitu erabiltzailea

Esleitu erabiltzaile bat segurtasun-funtzio zehaztutako helburu-ingurune batera.

YAML kode zati (EsleituUser-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

Parametroak (AssignUser-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Erabiltzailea esleitu nahi diozun inguruneko zerbitzuaren amaiera-puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
User
Power Platform erabiltzaile izena		 Microsoft Entra objektuaren IDa edo erabiltzailearen izen nagusia xede-inguruneari esleitzeko.
Role
segurtasun-funtzio izena edo ID		 segurtasun-funtzio erabiltzaileari esleitu beharreko izena edo ID.
ApplicationUser
Power Platform aplikazioaren erabiltzaile-izena		 Sarrerako erabiltzailea aplikazioaren erabiltzailea den zehazten du (egia|gezurra).

Power Platform Berrezarri ingurunea

Ingurune bat berrezartzen du.

YAML kode zati (Berrezarri-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'

Parametroak (Berrezarri-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Ingurunea berrezarri nahi duzun zerbitzu-amaiera (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Ingurunea berrezarri nahi duzun zerbitzu-amaiera (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.

Power Platform-en babeskopiak egiteko ingurunea

Babeskopia egin ingurunea.

YAML kode zati (Backup-env)

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

Parametroak (Backup-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Ingurunearen babeskopia egin nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Ingurunearen babeskopia egin nahi duzun zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
BackupLabel
Babeskopiaren etiketa		 (Beharrezkoa) Babeskopiari esleitu beharreko etiketa.

Power Platform kopiatzeko ingurunea

Kopiatu ingurune bat publikoaren ingurune batean. Bi kopia mota daude eskuragarri: osoa eta minimoa. Osoa kopiak bai datuak eta bai soluzioen metadatuak (pertsonalizazioak) biltzen ditu, eta a gutxieneko kopiak soluzioen metadatuak eta ez benetako datuak biltzen ditu.

YAML lagina (Kopiatu-env)

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

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

Parametroak (Kopiatu-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Kopiatu nahi duzun iturburu-ingurunearen zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Kopiatu nahi duzun iturburu-ingurunearen zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
TargetEnvironmentUrl
Helburuko ingurunea URL		 (Beharrezkoa) Kopiatu nahi duzun helburuko ingurunearen URLa.
CopyType
Kopia mota		 Gauzatzeko kopiatze-mota: FullCopy edo MinimalCopy
OverrideFriendlyName
Gainidatzi izen adierazgarria		 Aldatu xede-ingurunearen lagunarteko izena beste izen batekin (egia|faltsua).
FriendlyName
Izen adierazgarria		 Helmugako ingurunearen izen erraza.
DisableAdminMode
Administrazio-modua desgaitu		 Administrazio modua desgaitu ala ez (egia|faltsua).

Power Platform Ingurumena Berreskuratu

Ingurune bat leheneratzen du zehaztutako babeskopia batera.

YAML kode zati (Berreskuratu-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'

Parametroak (Restore-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformEnvironment
Power Platform ingurunearen URLa		 Bertaratu nahi duzun iturburu-ingurunearen zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Bertaratu nahi duzun iturburu-ingurunearen zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
RestoreLatestBackup
Berrezartzeko azken babeskopia		 Azken babeskopia leheneratu edo RestoreTimeStamp eman (egia|gezurra).
RestoreTimeStamp
Babeskopia egiteko data eta ordua		 Babeskopiaren data eta ordua "mm/dd/yyyy hh:mm" formatuan, EDO "latest" katea.
TargetEnvironmentUrl
Helburuko ingurunea URL		 (Derrigorrezkoa) Berrezarri nahi duzun xede-ingurunearen URLa.
FriendlyName
Leheneratu ingurunearen izena		 (Aukerakoa) Leheneratu ingurunearen izena.
DisableAdminMode
Administrazio-modua desgaitu		 Administrazio modua desgaitu ala ez (egia|faltsua).

Esportatu Dataverse Datuak

Esportatu datuak emandako eskema duen ingurune batetik.

YAML kode zati (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

Parametroak (exportdata-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Datuak esportatu nahi dituzun inguruneko zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
SchemaFile
XML eskema fitxategiaren izena		 XML eskema fitxategiaren izena. Konfigurazioa Migrazio tresna erabiliz sor daiteke.
DataFile
Datu-fitxategiaren izena		 Esportatu beharreko datuen fitxategiaren izena (zip fitxategia).
Overwrite
Edukia gainidaztea		 Power Pages gainidatzi beharreko webgunearen edukia (egia|gezurra).

Inportatu Dataverse datuak

Inportatu datuak ingurune batera.

YAML kode zati (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'

Parametroak (importdata-env)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Datuak inportatu nahi dituzun inguruneko zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
DataFile
Datu-fitxategiaren izena		 Zip konprimituaren fitxategiaren izena) inportatu beharreko datu-fitxategia, edo inportatu beharreko data-schema.xml eta data.xml dituen karpeta.

Power Pages kudeaketa zereginak

Power Pages webgune batekin lan egiteko zereginak.

Power Platform deskargatu PAPortal

Deskargatu Power Pages webguneko edukia uneko Dataverse ingurunetik.

YAML kode zati (deskargatu-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

Parametroak (deskarga-paportal)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Edukia deskargatu nahi duzun inguruneko zerbitzu amaierako puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
WebsiteId
Atariko webgunearen IDa		 Power Pages deskargatzeko webgunearen IDa.
Overwrite
Edukia gainidaztea		 Power Pages gainidatzi beharreko webgunearen edukia (egia|gezurra).
ModelVersion
Gunearen Datuen Eredua		 Kargatu beharreko guneko datuek estandarra (1) edo datu eredu hobetua (2) erabiliko duten adierazten du. Balio lehenetsia '1' da.

Power Platform kargatu PAPortal

Kargatu Power Pages webguneko edukia egungo Dataverse ingurunera.

YAML kode zati (kargatu-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'

Parametroak (kargatu-paportal)

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Edukia kargatu nahi duzun inguruneko zerbitzuaren amaiera-puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
UploadPath
Kargatu edukiaren bidea		 Power Pages webguneko edukia kargatuko den bidea.
ModelVersion
Gunearen Datuen Eredua		 Kargatu beharreko guneko datuek estandarra (1) edo datu eredu hobetua (2) erabiliko duten adierazten du. Balio lehenetsia '1' da.

Power Platform zereginen katalogoa (aurrebista)

Zeregin hauek katalogoaren aurkako ekintzak burutzen dituzte Power Platform n eta honako hauek barne hartzen dituzte.

Oharra

Une honetan, Power Platform ko katalogo-zereginak aurrebista argitarapena dira.

Instalatu katalogoko elementua

Instalatu katalogo-elementu bat helmuga-ingurunean.

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Edukia kargatu nahi duzun inguruneko zerbitzuaren amaiera-puntua (adibidez, https://powerappsbuildtools.crm.dynamics.com). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
Environment
Helburuko ingurunea URL		 (Derrigorrezkoa) Zeregin honek helburu duen inguruneko URLa.
CatalogItemId
Instalatu beharreko katalogoko elementuaren IDa		 (Derrigorrezkoa) Katalogoko elementua xede ingurunean instalatu beharrekoa.
TargetEnvironmentUrl
Helburuko ingurunea URL		 (Derrigorrezkoa) Katalogoko elementuak instalatzeko xede-ingurunearen URLa (adibidez, "https://YourOrg.crm.dynamics.com").
PollStatus
Egiaztatu inkestaren egoera		 (Aukera) Inkesta zure eskaeraren egoera egiaztatzeko (egia|gezurra).

Parametroak (katalogo-instalazioa)

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

Katalogoaren onespena bidali

Bidali katalogoa onartzeko eskaera.

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Edukia kargatu nahi duzun inguruneko zerbitzuaren amaiera-puntua (adibidez, "https://powerappsbuildtools.crm.dynamics.com"). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
Environment
Helburuko ingurunea URL		 (Derrigorrezkoa) Zeregin honek helburu duen inguruneko URLa.
CatalogSubmissionFile
Katalogoa aurkezteko fitxategia		 (Derrigorrezkoa) Zehaztu katalogoa bidaltzeko fitxategiaren bidea eta fitxategi-izena.
UsePackageSolutionZipFile
Fitxategi mota		 Fitxategi mota: pakete edo irtenbide zip fitxategia.
SolutionZipFile
Irtenbidearen zip fitxategiaren izena		 Zehaztu irtenbidearen zip fitxategiaren bidea eta fitxategiaren izena.
PollStatus
Egiaztatu inkestaren egoera		 (Aukera) Inkesta zure eskaeraren egoera egiaztatzeko (egia|gezurra).

Parametroak (katalogoa-bidaltzea)

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

Katalogoaren eskaeraren egoera

Lortu katalogoa instalatzeko/bidaltzeko eskaeraren egoera.

Parametroak Deskribapenak
authenticationType
Autentifikazio mota		 (Eskatutakoa SPN) Zehaztu bai PowerPlatformEnvironment erabiltzaile-izen/pasahitza konexio baterako edo PowerPlatformSPN Zerbitzu Nagusia/bezeroaren sekretu konexio baterako.
PowerPlatformSPN
Power Platform zerbitzuaren nagusia		 Edukia kargatu nahi duzun inguruneko zerbitzuaren amaiera-puntua (adibidez, "https://powerappsbuildtools.crm.dynamics.com"). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
Environment
Helburuko ingurunea URL		 (Derrigorrezkoa) Zeregin honek helburu duen inguruneko URLa.
TrackingId
Eskatu jarraipen ID		 (Derrigorrezkoa) Eskatu jarraipen ID.
RequestType
Eskaera mota		 (Derrigorrezkoa) Eskaera mota. (Balioak: Instalatu | Bidali).

Parametroak (katalogo-egoera)

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

Bideratzeak konpilatzen eta argitaratzen ditu

Orain konpilazio-tresnak erabiliz zer egin daitekeen identifikatu ondoren, ikus dezagun tresna horiek nola osatu ditzakezun zure konpilazio- eta argitalpen-bideratzeetan. Ikuspegi orokor kontzeptual bat agertzen da jarraian. Orain ikus ditzagun bideratzeen ezarpenari buruzko xehetasun batzuk, ondorengo azpiataletan eraikitzeko tresnaren zereginak erabiliz.

Gehiago jakiteko bideratze horiek sortzeko eta une gainera bideratzeak sortzeko baimena erabiliz Microsoft Power Platform Build Tools, osatu build tools laborategiak, GitHub-etik deskarga dezakezu.

Azure Pipelines-i buruzko informazio gehiago: Erabili Azure Pipelines

Konpilatu bideratzeak: esportatu soluzio bat garapen-ingurune batetik (DEV)

Ondorengo irudian, garapen-ingurune batetik irtenbide bat esportatzen duen bideratze bati gehitu ahal izango zenioke.

Esportatu irtenbide bat garapen-ingurune batetik (DEV).

Konpilatu bideratze bat: konpilatu kudeatutako soluzio bat

Ondorengo irudian, garapen-ingurune batetik kudeatutako soluzio bat konpilatzen duen bideratze bati gehitu ahal izango zenioke.

Eraiki kudeatutako soluzio bat.

Argitaratu bideratze bat: inplementatu ekoizpen-ingurunera (PROD)

Ondorengo irudian, garapen-ingurune batetik inplementatuko soluzio bat konpilatzen duen bideratze bati gehitu ahal izango zenioke.

Inplementatu ekoizpen-ingurune batera (PROD).

Ikus baita ere

Microsoft Power Platform Build Tools eraiki Azure DevOps