Microsoft Power Platform Build Tools zereginak

Erabilgarri dauden zereginak hurrengo ataletan deskribatzen dira. Ondoren, zeregin horiek erabiltzen dituzten Azure Pipelines adibide batzuk erakusten ditugu. Eraikuntza-tresnei buruzko informazioa eta deskargatzeko moduari buruzko informazioa lortzeko, ikus Microsoft Power Platform Eraikuntza-tresnak Azure Pipelines.

Laguntzailearen zeregina

Jarraian deskribatzen dira eskuragarri dauden laguntza-zereginak.

Power Platform Tresna instalatzailea

Zeregin hau beste edozein baino lehen gehitu behar da Power Platform Eraiki tresnak eraikitzeko eta askatzeko kanalizazioak. Zeregin honek Power Platform-eko tresna espezifiko multzo bat instalatzen du, agenteak Microsoft Power Platform eraikitzeko zereginak exekutatzeko behar dituena. Zeregin honek ez du konfigurazio gehiago behar gehitzen denean. Zeregin honek instalatzen ari diren tresna bakoitzaren bertsio espezifikoetarako 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@2
  displayName: 'Power Platform Tool Installer'

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

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

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.
`AddToolsToPath` Gehitu tresnak bide-izenari	Pac CLI gehitzen dio ingurune-aldagaiari `PATH` . Script zereginetatik pac cli erabiltzeko aukera ematen dizu, bide-izena eskuz konfiguratu beharrik gabe.
`PowerAppsAdminVersion` `XrmToolingPackageDeploymentVersion` `MicrosoftPowerAppsCheckerVersion` `CrmSdkCoreToolsVersion` Tresnaren bertsioa	Erabili beharreko tresnaren bertsio zehatza.

WhoAmi plataforma elektrikoa

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

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 eskuragarri dauden zereginak daude.

Power Platform-en egiaztatzailea

Zeregin honek zure irtenbideen analisi estatiko bat egiten du jardunbide egokien arau multzo baten arabera, zure irtenbidea eraikitzean nahi gabe sartu dituzun arazo-ereduak identifikatzeko.

YAML kode zati (zuzentzailea)

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

Parametroak (zuzentzailea)

Parametroak	Deskribapenak
`PowerPlatformSPN` Zerbitzuaren konexioa	(Beharrezkoa) Power Platform egiaztatzailea erabiltzeko baimendutako Microsoft Power Platform ingurune baterako konexioa behar da. Zerbitzuaren konexioak hemen zehazten dira Zerbitzuaren konexioak beherako Proiektuaren ezarpenak erabiliz Power Platform konexio mota. Informazio gehiago: ikus `BuildTools.EnvironmentUrl` Ingurunea sortu Power Platform atalean . Oharra: Zerbitzu Nagusia eta erabiltzaile-izen/pasahitz bidezko autentifikazio-metodoak eskuragarri daude egiaztatzaile-zereginarentzat. 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	Berez (true), egiaztatzaile zerbitzuaren kokapen geografikoak konektatzen zaren ingurunearen geografia bera erabiltzen du.
`CustomPACheckerEndpoint` PAC egiaztatzaileen amaierako puntu pertsonalizatua	Beharrezkoa denean `UseDefaultPACheckerEndpoint` da faltsua. Beste geografia bat zehaztu dezakezu erabiltzeko, adibidez `https://japan.api.advisor.powerapps.com.` Eskuragarri dauden geografien zerrenda bat ikusteko, ikus Erabili Power Platform Checker APIa.
`FileLocation` Aztertzeko fitxategien kokapena	Beharrezkoa da partekatutako sarbide-sinadura (SAS) URL batetik fitxategi bat erreferentziatzean `sasUriFile`. Oharra: Garrantzitsua da esportatutako soluzio-fitxategi bat erreferentziatzea, eta ez zure biltegian 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 da 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: Irtenbide-egiaztatzailea: arau multzo hau Power Apps maker ataritik exekutatzen den bera da. Marketplace: aplikazio bat Marketplace-en argitaratu aurretik ziurtatzeko erabiltzen den arau multzo hedatua.
`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	true denean, huts egiten du egiaztatzailearen Power Apps analisia Failed edo FinishedWithErrors gisa itzultzen bada.
`ArtifactDestinationName` DevOps artefaktuaren izena	Zehaztu Azure Artifacts izena egiaztatzailearen .sarif fitxategiarentzat.

Soluzioaren zereginak

Zeregin multzo honek konponbide ekintzak automatiza ditzake. Atal honetan geroago azaldutako ingurune-zereginak, ingurune bat sortu, kopiatu edo leheneratzen dutenak, zerbitzu-konexioak gainidazten dituzte sortutako ingurune berriekin. Zeregin hauek eskaeraren arabera sortutako inguruneetan soluzio-zereginak egitea ahalbidetzen dute.

Power Platform inportatu soluzioa

Irtenbidea xede ingurune batera inportatzen du.

YAML kode zati (Inportatu)

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

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

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 zerbitzuaren amaiera-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 zerbitzuaren amaiera-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	(Beharrezkoa) Helburu-ingurunean inportatzeko .zip soluzioaren fitxategiaren bidea eta fitxategi-izena (adibidez, $(Build.ArtifactStagingDirectory)$(SolutionName).zip). Oharra: Aldagaiek datu-zati garrantzitsuak zure bideratze-atalen hainbat ataletara eramateko modu erosoa ematen dizute. 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	Zaharkitua. Sistemak kudeatu gabeko soluzio-osagaiak kudeatu bihurtuko ditu kudeatutako soluzio bat inportatzen duzunean.
`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	Gehienezko itxaronaldia (minututan) eragiketa asinkronorako; lehenetsia 60 min (1 ordu) da, zereginetarako Azure DevOps lehenetsiaren berdina.
`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 irtenbide osagaia

Kudeatu gabeko soluzio bati soluzio-osagai bat gehitzen dio.

YAML zatia (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 ikusteko.
`SolutionUniqueName` Soluzioaren izena	Soluzioaren izen bakarra.
`AddRequiredComponents` Soluzio-osagaiaren araberako beste soluzio batetik behar diren osagaiak	(Aukerakoa) Gehitzen ari zaren soluzio-osagaiak behar dituen beste soluzio-osagai batzuk ere kudeatu gabeko soluzioari gehitu behar zaizkion adierazten du.
`Environment` Ingurunearen URLa edo IDa	(Aukerakoa) Ingurunearen URLa edo helburuko 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@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

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 berritu nahi duzun zerbitzuaren amaiera-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 berritu nahi duzun zerbitzuaren amaiera-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	Gehienezko itxaronaldia (minututan) eragiketa asinkronorako; lehenetsia 60 min (1 ordu) da, zereginetarako Azure DevOps lehenetsiaren berdina.

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

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 berritu nahi duzun zerbitzuaren amaiera-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 berritu nahi duzun zerbitzuaren amaiera-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	(Beharrezkoa) Iturburu-ingurunea esportatzeko solution.zip fitxategiaren bidea eta fitxategi-izena (adibidez, $(Build.ArtifactStagingDirectory)$(SolutionName).zip). Oharra: Aldagaiek datu-zati garrantzitsuak zure bideratze-atalen hainbat ataletara eramateko modu erosoa ematen dizute. 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	Gehienezko itxaronaldia (minututan) eragiketa asinkronorako; lehenetsia 60 min (1 ordu) da, zereginetarako Azure DevOps lehenetsiaren berdina.
`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 sinkronizazioaren 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@2
  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@2
  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@2
  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 zerbitzuaren amaiera-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 zerbitzuaren amaiera-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@2
  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 zerbitzuaren amaiera-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 zerbitzuaren amaiera-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@2
  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	Soluzioaren bertsioa ezarri nahi duzun zerbitzuaren amaiera-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	Soluzioaren bertsioa ezarri nahi duzun zerbitzuaren amaiera-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 gogor kodetu daitekeen arren, BuildId bezalako kanalizazio aldagai Azure DevOps erabiltzea gomendatzen da. 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 Konexio aldagaiak ezarri

Aldagaiak ezartzen ditu PowerPlatformSetConnectionVariables.BuildTools.* script zeregin pertsonalizatuak sarbidea emateko, zerbitzuaren konexioa egiaren iturri bakarra gisa erabiltzeko.

Ondorengo aldagaiak ezartzen dira:

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

YAML zatia (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 (KonexioAldagaiakEzarri)

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	Zeregin batek zerbitzariak bertan behera utzi aurretik exekutatzeko baimena duen gehienezko denbora zehazten du, minututan. Zero balioak denbora-muga infinitua adierazten du.
`retryCountOnTaskFailure` Zeregina huts egiten badu, berriro saiatzeko kopurua	Zeregin honek huts egiten badu, zeregin honen bersailkapen kopurua zehazten du. Ez da onartzen agenterik gabeko zereginetarako.
`ApplicationId` Saioa hasteko aplikazioaren IDa	(Erabiltzaile-izenarentzat/pasahitzarentzat beharrezkoa) Saioa hasteko erabiliko den aplikazioaren IDa (ikusi beheko ohar gehigarria).
`RedirectUri` Aplikazio zehatzaren birbideratze URIa	(Erabiltzaile-izena/pasahitza beharrezkoa da) Zehaztutako aplikazioaren birbideratze-URIa. Aplikazioaren IDa zehaztean beharrezkoa. (Ikusi beheko ohar gehigarria).

Oharra

Erabiltzaile-izen/pasahitz autentifikazio mota erabiltzean, Aplikazioaren IDa eta Birbideratze URIa beharko dira. *oauthenticate oauth* dokumentu honek azaltzen du zergatik sortu behar duzun aplikazio-erregistro bat autentifikatzeko . Dataverse Erabiltzaile-izen/pasahitz autentifikazioa erabiliz konektatzen zarenean, konexioak erabiltzailearen izenean konektatzen ari den aplikazio baten antzera 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@2
  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 zabaldu nahi duzun zerbitzuaren amaiera-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 zabaldu nahi duzun zerbitzuaren amaiera-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	Gehienezko itxaronaldia (minututan) eragiketa asinkronorako; lehenetsia 60 min (1 ordu) da, zereginetarako Azure DevOps lehenetsiaren berdina.

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

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 hornitu ahal izateko, zure lizentziak edo gaitasunak ingurune gehigarriak sortzea ahalbidetzen badu bakarrik. Ikusteko gaitasuna ikusteko informazio gehiago lortzeko Edukiera orriaren xehetasunak.

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

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 zerbitzuaren amaiera-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 zerbitzuaren amaiera-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: Dagoeneko erabiltzen ari den domeinu-izen bat sartzen baduzu, zereginak balio numeriko bat eransten dio domeinu-izenari, 0-rekin hasita. Goiko adibidean, URL bihur daiteke`https://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@2
  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 amaiera-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 amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.

Power Platform Erabiltzailea esleitu

Esleitu erabiltzaile bat helburu-ingurune bati zehaztutako segurtasun-rol batekin.

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

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 ingurunearen 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 helburuko inguruneari esleitzeko.
`Role` Segurtasun-rolaren izena edo IDa	Erabiltzaileari esleituko zaion segurtasun-rolaren izena edo IDa.
`ApplicationUser` Power Platform aplikazioaren erabiltzaile-izena	Sarrerako erabiltzailea aplikazioaren erabiltzailea den zehazten du (egia\|gezurra).

Power Platform Ingurunea berrezarri

Ingurune bat berrezartzen du.

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

Parametroak (Berrezarri ingurunea)

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 zerbitzuaren amaiera-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 berrezarri nahi duzun zerbitzuaren amaiera-puntua (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@2
  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 zerbitzuaren amaiera-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 zerbitzuaren amaiera-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@2
  displayName: 'Power Platform Copy Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'

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

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 zerbitzuaren amaiera-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 zerbitzuaren amaiera-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.
`SkipAuditData` Saltatu AuditoriaDatuak	Kopiatzeko eragiketan auditoria-datuak saltatu behar diren ala ez. (egia\|gezurra).
`MaxAsyncWaitTime` Gehienezko itxaronaldia	Gehienezko itxaronaldia (minututan) eragiketa asinkronorako; lehenetsia 60 min (1 ordu) da, zereginetarako Azure DevOps lehenetsiaren berdina.

Power Platform Ingurumena leheneratu

Ingurune bat leheneratzen du zehaztutako babeskopia batera.

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

Parametroak (Ingurunea leheneratu)

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	Leheneratu nahi duzun iturburu-ingurunearen zerbitzu-amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
`PowerPlatformSPN` Power Platform zerbitzuaren nagusia	Leheneratu nahi duzun iturburu-ingurunearen zerbitzu-amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
`RestoreLatestBackup` Berreskuratzeko azken babeskopia	Azken babeskopia leheneratu edo RestoreTimeStamp (egia\|gezurra) eman.
`RestoreTimeStamp` Babeskopiaren data eta ordua	Babeskopiaren data eta ordua "mm/dd/yyyy hh:mm" formatuan, EDO "latest" katea.
`TargetEnvironmentUrl` Helburuko ingurunea URL	(Beharrezkoa) Leheneratu nahi duzun helburu-ingurunearen URLa.
`FriendlyName` Leheneratu den ingurunearen izena	(Aukerakoa) Leheneratu den ingurunearen izena.
`DisableAdminMode` Administrazio-modua desgaitu	Administrazio modua desgaitu ala ez (egia\|faltsua).

Esportatu datuak Dataverse

Esportatu datuak ingurune batetik emandako eskema erabiliz.

YAML zatia (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 ingurunearen zerbitzuaren amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
`SchemaFile` Eskema XML fitxategiaren izena	Eskema XML fitxategiaren izena. Configuration Migration tresna erabiliz sor daiteke.
`DataFile` Datu fitxategiaren izena	Esportatzeko datuen fitxategiaren izena (zip fitxategia).
`Overwrite` Edukia gainidatzi	Power Pages-en webgunearen edukia gainidazteko (egia\|faltsua).

Inportatu datuak Dataverse

Inportatu datuak ingurune batera.

YAML zatia (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 ingurunearen zerbitzuaren amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
`DataFile` Datu fitxategiaren izena	Inportatzeko konprimitutako zip datu-fitxategiaren izena, edo inportatzeko data-schema.xml eta data.xml dituen karpeta.

Power Pages-en kudeaketa-zereginak

Power Pages-en webgune batekin lan egiteko zereginak.

Power Platform deskargatu PAPortal

Deskargatu Power Pages webguneko edukia uneko Dataverse ingurunetik.

YAML zatia (download-paportal)

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

Parametroak (download-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 ingurunearen zerbitzuaren amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
`WebsiteId` Atariaren webgunearen IDa	Power Pages webgunearen IDa deskargatu beharrekoa.
`Overwrite` Edukia gainidatzi	Power Pages-en webgunearen edukia gainidazteko (egia\|faltsua).
`ModelVersion` Gunearen datu-eredua	Adierazten du igoko diren guneko datuek datu-eredu estandarra (`1`) edo hobetua (`2`) erabiliko duten. Balio lehenetsia '1' da.

Power Platform kargatu PAPortal

Igo Power Pages webgunearen edukia uneko Dataverse ingurunera.

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

Parametroak (igoera-portala)

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 igo nahi duzun ingurunearen zerbitzuaren amaiera-puntua (adibidez, `https://powerappsbuildtools.crm.dynamics.com`). Azpian definitua Zerbitzu-konexioak urtean Proiektuaren ezarpenak erabiliz Power Platform konexio mota.
`UploadPath` Edukia igotzeko bidea	Power Pages webgunearen edukia igoko den bide-izena.
`ModelVersion` Gunearen datu-eredua	Adierazten du igoko diren guneko datuek datu-eredu estandarra (`1`) edo hobetua (`2`) erabiliko duten. Balio lehenetsia '1' da.

Zereginen katalogoa (aurrebista) Power Platform

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

Oharra

Gaur egun, katalogo-zereginak aurrebista-bertsio gisa daude. Power Platform

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 igo nahi duzun ingurunearen 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	(Beharrezkoa) Zeregin honen helburu den ingurunearen URLa.
`CatalogItemId` Instalatu beharreko katalogoko elementuaren IDa	(Beharrezkoa) Helburuko ingurunean instalatuko den katalogo-elementua.
`TargetEnvironmentUrl` Helburuko ingurunea URL	(Beharrezkoa) Katalogoko elementuak instalatzeko helburu-ingurunearen URLa (adibidez, "https://YourOrg.crm.dynamics.com").
`PollStatus` Egiaztatu bozketa egoera	(Aukerakoa) Eskaeraren egoera egiaztatzeko inkesta (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

Bidali katalogoaren onespena

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 igo nahi duzun ingurunearen 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	(Beharrezkoa) Zeregin honen helburu den ingurunearen URLa.
`CatalogSubmissionFile` Katalogoaren bidalketa fitxategia	(Beharrezkoa) Zehaztu katalogoaren bidalketa-fitxategiaren bidea eta fitxategi-izena.
`UsePackageSolutionZipFile` Fitxategi mota	Fitxategi mota: paketea edo irtenbide zip fitxategia.
`SolutionZipFile` Soluzioaren zip fitxategiaren izena	Zehaztu soluzio zip fitxategiaren bidea eta fitxategi-izena.
`PollStatus` Egiaztatu bozketa egoera	(Aukerakoa) Eskaeraren egoera egiaztatzeko inkesta (egia\|gezurra).

Parametroak (katalogoa bidali)

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

Katalogo 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 igo nahi duzun ingurunearen 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	(Beharrezkoa) Zeregin honen helburu den ingurunearen URLa.
`TrackingId` Jarraipen IDa eskatu	(Beharrezkoa) Jarraipen IDa eskatu.
`RequestType` Eskaera mota	(Beharrezkoa) 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.

Kanalizazio horiek sortzeari buruz gehiago jakiteko eta Microsoft Power Platform Build Tools erabiliz kanalizazio praktikoa egiteko, osatu build tools labs, GitHub-tik deskarga dezakezuna.

Azure Pipelines-ri 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 soluzio 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 irtenbide bat.

Argitaratu bideratze bat: inplementatu ekoizpen-ingurunera (PROD)

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

Ekoizpen-ingurune batera zabaldu (PROD).

Ikusi baita ere

Microsoft Power Platform Eraiki tresnak Azure DevOps

Oharrak

Lagungarria al da orri hau?

Last updated on 2026-03-09