Microsoft Power Platform Build Tools uzdevumi

  • Raksts

Pieejamie izveides uzdevumi ir aprakstīti tālāk norādītajās sadaļās. Pēc tam mēs parādīsim dažus Azure konveijeru piemērus, kuros tiek izmantoti šie uzdevumi. Informāciju par būvēšanas rīkiem un to lejupielādi skatiet Microsoft Power Platform rakstā Būvēšanas rīki Azure konveijeriem.

Palīga uzdevums

Pieejamie palīguzdevumi ir aprakstīti tālāk.

Power Platform rīku instalētājs

Šis uzdevums ir jāpievieno vienu reizi pirms jebkāds Power Platform būvētaja rīks dod uzdevumu būvēt un izlaist konveijerus. Izmantojot šo uzdevumu, tiek instalēta Power Platform–speciālie instrumenti, kuri nepiecieśami aģentam, lai palaistu Microsoft Power Platform izveides uzdevumus. Šim uzdevumam nav nepieciešama papildu konfigurācija, kad tas tiek pievienots. Šis uzdevums satur parametrus katra instalējamā rīka konkrētajām versijām.

Lai saglabātu jaunāko rīka versiju laika gaitā, pārliecinieties, vai šie parametri atbilst to rīku versijām, kas nepieciešamas, lai konveijers darbotos pareizi.

YAML fragments (Installer)

# 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

Parametri (Installer)

Parametri Apraksts
DefaultVersion
Noklusejuma rīku versiju lietošana		 Iesatiet kā patiesu, lai izmantotu visu rīku noklusējuma versiju, pretējā gadījumā – aplamu. Vajadzīgs (un aplams), ja ir norādītas rīku versijas.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Rīka versija		 Konkrēta rīka versija, kas jāizmanto.

Power Platform WhoAmI

Pārbauda Power Platform vides pakalpojumu savienojumu, savienojot un veicot Whoami pieprasījumu. Šis uzdevums var būt noderīgs, lai agri ekļautu konveijerā un verificētu savienojamību pirms apstrādes sākšanas.

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

Parametri (WhoAmI)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Pēc izvēles) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Servisa galapunkts videi, ar kuru izveidot savienojumu. Definēts sadaļā Servisa savienojumiProjekta iestatījumos. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Servisa galapunkts videi, ar kuru izveidot savienojumu. Definēts sadaļā Servisa savienojumiProjekta iestatījumos.

Kvalitātes pārbaude

Nākamajā sadaļā ir pieejami uzdevumi risinājuma kvalitātes pārbaudei.

Power Platform Checker

Šis uzdevums veic jūsu risinājumu statisku analīzi, salīdzinot tos ar labākās prakses kārtulu kopu, lai noteiktu visus problemātiskos modeļus, kurus jūs varētu netīšām ieviest, veidojot savu risinājumu.

YAML fragments (Checker)

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

Parametri (Checker)

Parametri Apraksts
PowerPlatformSPN
Servisa savienojums		 (Nepieciešams) Ir nepieciešams savienojums ar lincencētu Microsoft Power Platform vidi, lai izmantotu šo Power Platform pārbaudītāju. Servisa savienojumi tiek definēti Servisa savienojumos sadaļā Projekta iestatījumi, izmantojot Power Platform savienojuma tipu. Papildinformācija skatiet BuildTools.EnvironmentUrl sadaļu Power Platform Izveidot vidi

Piezīme: Pārbaudītāja uzdevumam ir pieejamas pakalpojuma vadītāja un lietotājvārda/paroles autentifikācijas metodes. Lai iegūtu papildinformāciju par to, kā konfigurēt servisa vadītājus, kas tiks izmantoti ar šo uzdevumu, skatiet rakstu Servisa galveno savienojumu konfigurēšana Power Platform vidēm.
UseDefaultPACheckerEndpoint
Lietojiet Power Platform Checker noklusējuma galapunktu		 Pēc noklusējuma (patiess) pārbaudītāja pakalpojuma ģeogrāfiskajai atrašanās vietai tiek izmantota tā pati ģeogrāfiskā atrašanās vieta, ar kuru veidojat savienojumu.
CustomPACheckerEndpoint
Pielāgots PAC pārbaudītāja galapunkts		 Vajadzīgs, ja UseDefaultPACheckerEndpoint ir aplams. Varat norādīt citu ģeogrāfisko atrašanās vietu, ko izmantot, piemēram https://japan.api.advisor.powerapps.com. , Pieejamo ģeogrāfisko atrašanās vietu sarakstu skatiet sadaļā Pārbaudītāja Power Platform API izmantošana.
FileLocation
Analizējamo failu atrašanās vieta		 Nepieciešams, veidojot atsauci uz failu no koplietojama piekļuves paraksta (SAS) vietrāža URL. sasUriFile

Piezīme: ir svarīgi atsaukties uz eksportētu risinājuma failu, nevis uz repozitorijā esošajiem neiesaiņotajiem avota failiem. Var analizēt gan pārvaldītos, gan nepārvaldītos risinājumu failus.
FilesToAnalyzeSasUri
SAS faili analizēšanai		 Vajadzīgs, ja FileLocation ir iestatīta uz sasUriFile. Ievadiet SAS URI. Var pievienot vairāk nekā vienu SAS URI, izmantojot komatu (,) vai semikolu (;) atdalīts saraksts.
FilesToAnalyze
Lokālie faili analizēšanai		 Nepieciešams, ja SAS faili netiek analizēti. Norādiet zip failu ceļu un faila nosaukumu, kas jāanalizē. Var izmantot aizstājējzīmes. Piemēram, ievadiet ** \*.zip visiem zip failiem visās apakšmapēs.
FilesToExclude
Lokālie faili, kurus izslēgt		 Norādiet to failu nosaukumus, kurus jāizņem no analīzes. Ja to ir vairāk nekā viens, lieciet starp tiem komatu (,) vai semikolu (;). Šajā sarakstā var iekļaut pilno faila nosaukumu vai nosaukumu ar sākuma vai beigu aizstājējzīmi, piemēram, *jquery vai form.js
RulesToOverride
Pārlabojamās kārtulas		 JSON masīvs ietver kārtulas un līmeņus, kurus jāpārlabo. Pieļaujamās OverrideLevel vērtības: kritisks, augsts, vidējs, zems, informācijas. Piemērs: [{"Id":"metadati-remove-dup-re","OverrideLevel":"Vidējs"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Vidējs"}]
RuleSet
Kārtulu kopa		 (Nepieciešams) Norādiet, kuru kārtulu kopu lietot. Ir pieejamas divas tālāk aprakstītās kārtulu kopas:
  • Risinājumu pārbaudītājs: šī kārtulu kopa ir tā pati, kas tiek palaista Power Apps no veidotāju portāla.
  • AppSource: paplašināto noteikumu kopa, kas tiek izmantota, lai apstiprinātu pieteikumu, pirms to var publicēt. AppSource
ErrorLevel
Kļūdu līmenis		 Kopā ar kļūdu sliekšņa parametrs nosaka atļauto kļūdu un brīdinājumu smagumu. Atbalstītās sliekśńa vērtības ir <level>IssueCount, kur level = kritisks, augsts, vidējs, zems un informatīvs.
ErrorThreshold
Kļūdu robežvērtība		 Definē noteikta līmeņa kļūdu skaitu (>=0), kuras pārbaudītājs var palaist, pārbaudot risinājumus.
FailOnPowerAppsCheckerAnalysisError
Kļūdas neizdošanās		 Ja patiess, neizdodas, ja Power Apps pārbaudītāja analīze tiek atgriezta kā Failed vai FinishedWithErrors.
ArtifactDestinationName
DevOps artefakta nosaukums		 Norādiet Azure artefaktu nosaukumu pārbaudītāja .sarif failam.

Risinājuma uzdevumi

Šī uzdevumu kopa var automatizēt risinājuma darbības. Šajā sadaļā tālāk aprakstītie vides uzdevumi, kas izveido, kopē vai atjauno vidi, pārraksta pakalpojumu savienojumus ar jaunizveidotajām vidēm. Šie uzdevumi ļauj veikt risinājuma uzdevumus vidēs, kas tiek izveidotas pēc pieprasījuma.

Power Platform risinājuma importēšana

Importējot risinājumu mērķa vidē.

YAML fragments (importēšana)

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

Parametri (importēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kurā vēlaties importēt risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kurā vēlaties importēt risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
SolutionInputFile
Risinājuma ievades fails		 (Obligāti) Risinājuma ceļš un faila nosaukums .zip failu, kas jāimportē mērķa vidē (piemēram, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

Piezīme: Mainīgie nodrošina ērtu veidu, kā iegūt svarīgākos datu bitus dažādās konveijera daļās. Vispusīgu sarakstu skatiet Iepriekš definētu mainīgo lietošana.
HoldingSolution
Importēt risinājumu kā saturošo risinājumu		 Jaunināšanas parametrs (patiess|nepatiess), kas tiek izmantots, lai atjaunotu risinājumu. Šis parametrs vieso risinājumu programmā Dataverse, bet nejaunina risinājumu, kamēr nav palaists risinājuma jaunināšanas uzdevums.
OverwriteUnmanagedCustomizations
Nepārvaldīto pielāgojumu pārlabošana		 Norādiet, vai pārrakstīt nepārvaldītos pielāgojumus (patiess|nepatiess).
SkipProductUpdateDependencies
Produktu atjaunināšanas atkarību izlaišana		 Norādiet, vai vajadzētu izlaist ar produktu atjauninājumiem saistīto atkarību izpildi (patiess|aplams).
ConvertToManaged
Pārvērst par pārvaldīto		 Norādiet, vai importēt kā pārvaldītu risinājumu (patiess|aplams).
AsyncOperation
Asinhronā importēšana		 Ja atlasīts (patiess) importēšanas darbība tiks veikta asinhroni. Tas ir ieteicams lielākam risinājumam, jo šis uzdevuma izpilde automātiski noilgs pēc 4 minūtēm. Asinhrono uzdevumu izveĺéśana veiks aptauju un gaidīs, līdz tiks sasniegts MaxAsyncWaitTime (patiess|nepatiess)
MaxAsyncWaitTime
Maksimālais gaidīšanas laiks		 Maksimālais asinhronās operācijas gaidīšanas laiks minūtē; noklusējuma laiks ir 60 minūtes (1 stunda), tāpat kā Azure DevOps noklusējuma laiks attiecībā uz uzdevumiem.
PublishWorkflows
Procesu aktivizēšana pēc importēšanas		 Norādiet vai pēc importēšanas vajadzētu aktivizēt kādus risinājuma procesus (darbplūsmas) (patiess|aplams).
UseDeploymentSettingsFile
Izvietošānas iestatījumu failu lietošana		 Savienojuma atsauces un vides mainīgās vērtības var iestatīt, izmantojot izvietošanas iestatījumu failu (patiess|aplams).
DeploymentSettingsFile
Izvietošanas iestatījumu fails		 (Vajadzīgs, ja UseDeploymentSettingsFile=patiess) Izvietošanas iestatījumu faila ceļš un nosaukums.

Power Platform Risinājuma komponenta pievienošana

Pievieno risinājuma komponentu nepārvaldītam risinājumam.

YAML fragments (pievienot)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.add-solution-component.PowerPlatformAddSolutionComponent@2
  displayName: 'Power Platform Add Solution Component '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SolutionName: 'SampleSolution '
    Component: contact
    ComponentType: 1
    AddRequiredComponents: false

Parametri (pievienot)

Parameters Apraksts
ComponentId
Risinājuma komponenta ID		 Mērķa risinājumam pievienojamās shēmas nosaukums vai komponenta ID.
ComponentType
Power Platform vides vietrādis URL		 Vērtība, kas apzīmē risinājuma komponentu, kuru pievienojat. Skatiet sadaļu Iepriekš definētu komponentu tipu izmantošana visaptverošam komponentu vērtību sarakstam.
SolutionUniqueName
Risinājuma nosaukums		 Unikāls risinājuma nosaukums.
AddRequiredComponents
Visi komponenti, kas nepieciešami no cita risinājuma atkarībā no risinājuma komponenta		 (Pēc izvēles) Norāda, vai nepārvaldītajam risinājumam ir jāpievieno arī citi risinājuma komponenti, kas nepieciešami risinājuma komponentam, kuru pievienojat.
Environment
Vides URL vai ID		 (Pēc izvēles) Vides URL vai mērķa vides ID.

Power Platform Lietot risinājuma jauninājumu

Jauninā risinājumu, kas importēts kā turēšanas risinājums.

YAML fragments (jaunināšana)

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

Parametri (jaunināšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, uz kuru vēlaties jaunināt risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, uz kuru vēlaties jaunināt risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
SolutionName
Risinājuma nosaukums		 (Nepieciešams) Jaunināmā risinājuma nosaukums. Vienmēr izmantojiet risinājuma Nosaukumu, nevis tā Parādāmo nosaukumu.
AsyncOperation
Asinhronā jaunināšana		 Ja atlasīts (patiess) jaunināšanas darbība tiks veikta kā asinhrons pakešuzdevums. Atlasot asinhrono uzdevumu, tiks veikta aptauja un tiks gaidīts, līdz ir sasniegs MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimālais gaidīšanas laiks		 Maksimālais asinhronās operācijas gaidīšanas laiks minūtē; noklusējuma laiks ir 60 minūtes (1 stunda), tāpat kā Azure DevOps noklusējuma laiks attiecībā uz uzdevumiem.

Note

Mainīgie nodrošina ērtu veidu, kā iegūt svarīgākos datu fragmentus dažādās konveijera daļās. Vispusīgu sarakstu skatiet Iepriekš definētu mainīgo lietošana. Importējot risinājumu, izmantojot izvietošanas iestatījumu failu, varat iepriekš aizpildīt savienojuma atsauci un informāciju par vides mainīgajiem mērķa videi.

Papildinformācija: Savienojuma atsauču un vides mainīgo iepriekšēja aizpildīšana automatizētai izvietošanai

Power Platform risinājuma eksportēšana

Eksportē risinājumu no avota vides.

YAML fragments (eksportēšana)

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

Parametri (eksportēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, uz kuru vēlaties jaunināt risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, uz kuru vēlaties jaunināt risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
SolutionName
Risinājuma nosaukums		 (Nepieciešams) Eksportējamā risinājuma nosaukums. Vienmēr izmantojiet risinājuma Nosaukumu, nevis tā Parādāmo nosaukumu.
SolutionOutputFile
Risinājuma izvades fails		 (Obligāti) Ceļš un faila nosaukums solution.zip failam, lai eksportētu avota vidi uz (piemēram, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip ).

Piezīme: Mainīgie nodrošina ērtu veidu, kā iegūt svarīgākos datu bitus dažādās konveijera daļās. Vispusīgu sarakstu skatiet Iepriekš definētu mainīgo lietošana.
AsyncOperation
Asinhronā eksportēšana		 Ja atlasīts (patiess) eksportēšanas darbība tiks veikta kā asinhrons pakešuzdevums. Atlasot asinhrono uzdevumu, tiks veikta aptauja un tiks gaidīts, līdz ir sasniegs MaxAsyncWaitTime.
MaxAsyncWaitTime
Maksimālais gaidīšanas laiks		 Maksimālais asinhronās operācijas gaidīšanas laiks minūtē; noklusējuma laiks ir 60 minūtes (1 stunda), tāpat kā Azure DevOps noklusējuma laiks attiecībā uz uzdevumiem.
Managed
Eksportēt kā pārvaldītu		 Ja atlasīts (patiess), eksportē risinājumu kā pārvaldītu risinājumu; pretējā gadījumā eksportē kā nepārvaldītu risinājumu.
ExportAutoNumberingSettings
Eksportēt automātiskās numerācijas iestatījumus		 Eksportēt automātiskās numerācijas iestatījumus (patiess|aplams).
ExportCalendarSettings
Kalendāra iestatījumu eksportēšana		 Kalendāra iestatījumu eksportēšana (patiess|aplams).
ExportCustomizationSettings
Pielāgošanas iestatījumu eksportēšana		 Pielāgošanas iestatījumu eksportēšana (patiess|aplams).
ExportEmailTrackingSettings
E-pasta izsekošanas iestatījumu eksportēšana		 E-pasta izsekošanas iestatījumu eksportēšana (patiess|aplams).
ExportGeneralSettings
Vispārīgo iestatījumu eksportēšana		 Vispārīgo iestatījumu eksportēšana (patiess|aplams).
ExportIsvConfig
ISV konfigurācijas eksportēšana		 ISV konfigurācijas eksportēšana (patiess|aplams).
ExportMarketingSettings
Mārketinga iestatījumu eksportēšana		 Mārketinga iestatījumu eksportēšana (patiess|aplams).
ExportOutlookSynchronizationSettings
Outlook sinhronizācijas iestatījumu eksportēšana		 Outlook sinhronizācijas iestatījumu eksportēšana (patiess|aplams).
ExportRelationshipRoles
Attiecību lomu eksportēšāna		 Attiecību lomu eksportēšāna (patiess|aplams).
ExportSales
Eksportu pārdošana		 Eksportu pārdošana (patiess|aplams).

Power Platform atpakošanas risinājums

Sadala saspiestu risinājuma failu vairākos XML tā, lai avota vadīklas sistēma šos failus varētu vieglāk lasīt un pārvaldīt.

YAML fragments (izpakošana)

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

Parametri (izpakošana)

Parametri Apraksts
SolutionInputFile
Risinājuma ievades fails		 (Nepieciešams) solution.zip faila ceļš un faila nosaukums, kas jāatpako.
SolutionTargetFolder
Mērķa mape, lai atpakotu risinājumu		 (Nepieciešams) Ceļš un mērķa mape, kurā vēlaties atpakot risinājumu.
SolutionType
Risinājuma veids		 (Nepieciešams) Izpakojamā risinājuma veida izvēle. Ir šādas opcijas: Nepārvaldīts (ieteicams), Pārvaldīts un Abi.

Power Platform pakotnes risinājums

Iepako avota vadīklā esošu risinājumu solution.zip failā, ko var importēt citā vidē.

YAML fragments (sapakošana)

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

Parametri (sapakošana)

Parametri Apraksts
SolutionOutputFile
Risinājuma izvades fails		 (Nepieciešams) solution.zip faila ceļš un faila nosaukums, lai iepakotu risinājumu.
SolutionSourceFolder
Risinājuma pakotnes avota mape		 (Nepieciešams) Risinājumu pakošanas ceļš un avota mape.
SolutionType
Risinājuma veids		 (Nepieciešams) Iepakojamā risinājuma veida izvēle. Ir šādas opcijas: Pārvaldīts (ieteicams), Neārvaldīts un Abi.

Power Platform Dzēst risinājumu

Tiek dzēsts risinājums mērķa vidē.

YAML fragments (dzēšana)

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'

Parametri (dzēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, ka vēlaties dzēst risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, ka vēlaties dzēst risinājumu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
SolutionName
Risinājuma nosaukums		 (Nepieciešams) Dzēšamā risinājuma nosaukums. Vienmēr izmantojiet risinājuma Nosaukumu, nevis tā Parādāmo nosaukumu.

Power Platform pielāgojumu publicēšana

Visi pielāgojumi tiek publicēti vidē.

YAML fragments (publicēšana)

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

Parametri (publicēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kurā vēlaties publicēt pielāgojumus (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kurā vēlaties publicēt pielāgojumus (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana

Power Platform risinājuma versijas iestatīšana

Atjaunina risinājuma versiju.

YAML fragments (versija)

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

Parametri (versija)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kuram vēlaties iestatīt risinājuma versiju (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kuram vēlaties iestatīt risinājuma versiju (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
SolutionName
Risinājuma nosaukums		 (Obligāti) Nosaukums risinājumam, kuram jāiestata versija. Vienmēr izmantojiet risinājuma Nosaukumu, nevis tā Parādāmo nosaukumu.
SolutionVersionNumber
Risinājuma versijas numurs		 (Nepieciešams) Versijas numurs, kuru vēlaties iestatīt.

Lai gan versijas numuru var kodēt cauruļvadā,, ir ieteicams izmantot Azure DevOps konveijera mainīgo, piemēram, BuildId. Tas nodrošina opcijas, lai cilnē Opcijas definētu precīzu versijas numura formu, piemēram: $(gads:gggg)-$(mēnesis:mm)-$(diena:dd)-$(rev:rr)-3

Šo definīciju pēc tam var izmantot uzdevumā Iestatīt risinājuma versiju, iestatot versijas numura rekvizītu ar $(Build.BuildId), nevis stingri iekodēt 20200824.0.0.2.

Var arī iestatīt PowerShell iekļautā uzdevuma skripta $(Get-Date -Format yyyy.MM.dd.HHmm) izvadi uz tukšu mainīgo ar nosaukumu SolutionVersion kā Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), iestatīt risinājuma versiju kā $(SolutionVersion).

Power Platform Savienojuma mainīgo iestatīšana

Iestata BuildTools.* mainīgos, lai nodrošinātu pielāgotu skriptu uzdevumu piekļuvi, lai izmantotu pakalpojumu savienojumu kā vienu patiesības avotu.

YAML fragments (SetConnectionVariables)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.set-connection-variables.PowerPlatformSetConnectionVariables@2
  displayName: 'Power Platform Set Connection Variables '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
  timeoutInMinutes: 2
  retryCountOnTaskFailure: 5

Parametri (SetConnectionVariables)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kuram vēlaties iestatīt savienojuma mainīgos. Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
timeoutInMinutes
Taimauts		 Norāda maksimālo laiku (minūtēs), ko ir atļauts izpildīt uzdevumam, pirms serveris to atceļ. Nulles vērtība norāda uz bezgalīgu taimautu.
retryCountOnTaskFailure
Atkārtotu mēģinājumu skaits, ja uzdevums neizdevās		 Norāda šī uzdevuma atkārtotu mēģinājumu skaitu, kas notiks uzdevuma neizdošanās gadījumā. Netiek atbalstīts uzdevumiem bez aģenta.
ApplicationId
Lietojumprogrammas ID, lai pieteiktos		 (Nepieciešams lietotājvārdam/parolei) Lietojumprogrammas ID, ko izmantot, lai pieteiktos (skatiet papildu piezīmi zemāk).
RedirectUri
Novirziet konkrētās lietotnes URI		 (Nepieciešams lietotājvārdam/parolei) Novirziet norādītās lietotnes URI. Nepieciešams, norādot lietotnes ID. (skatiet tālāk sniegto papildu piezīmi).

Piezīmes

Izmantojot lietotājvārda/paroles autentifikācijas veidu, būs nepieciešams lietojumprogrammas ID un novirzīšanas Uri. Šajā autentificētajā dokumentā ir paskaidrots, kāpēc jums ir jāizveido lietotnes reģistrācija, lai autentificētos Dataverse. Kad izveidojat savienojumu, izmantojot lietotājvārda/paroles autentifikāciju, savienojums darbojas kā lietojumprogramma, kas lietotāja vārdā veido savienojumu ar Dataverse.

Power Platform pakotnes izvietošana

Izvieto paku vidē. Pakotnes izvietošana, pretstatā atsevišķam risinājuma failam, piedāvā opciju izvietot vairākus risinājumus, datus un kodu vidē.

YAML fragments (izvietošana)

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

Parametri (izvietošana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kurā vēlaties izvietot pakotni (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kurā vēlaties izvietot pakotni (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu. Papildinformāciju skatiet sadaļā BuildTools.EnvironmentUrl rakstā Power Platform vides izveidošana
PackageFile
Pakotnes fails		 (Obligāti) Pakotnes faila montāžas ceļš un faila nosaukums (.dll).
MaxAsyncWaitTime
Maksimālais gaidīšanas laiks		 Maksimālais asinhronās operācijas gaidīšanas laiks minūtē; noklusējuma laiks ir 60 minūtes (1 stunda), tāpat kā Azure DevOps noklusējuma laiks attiecībā uz uzdevumiem.

Vides pārvaldības uzdevumi

Automatizējiet kopīgo vides dzīves cikla pārvaldības (ELM) uzdevumus.

Power Platform vides izveide

Izveido jaunu vidi. Izveidojot jaunu vidi, tiek automātiski izveidota BuildTools.EnvironmentUrl.

Svarīgi

Ja iestatīts, BuildTools.EnvironmentUrl izmantos kā noklusējuma servisa savienojumu turpmākiem konveijera uzdevumiem. Katrs šajā rakstā izmantotais uzdevums izmanto tikai galapunktu no servisa savienojuma, ja nav iestatīts BuildTools.EnvironmentUrl.

Jaunu vidi var nodrošināt tikai tad, ja jūsu licence vai noslodze ļauj izveidot papildu vides. Papildinformāciju par noslodzes skatīšanu skatiet sadaļā Noslodzes lapas detalizētā informācija.

YAML fragments (Izveidot vidi)

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

Parametri (izveidot vidi)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kuru vēlaties izveidot vidē (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kuru vēlaties izveidot vidē (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
DisplayName
Parādāmais nosaukums/vārds		 (Nepieciešams) Izveidotās vides parādāmais nosaukums.
LocationName
Izvietošanas reģions		 (Nepieciešams) Reģions, kurā jāizveido vide.
EnvironmentSku
Vides tips		 (Nepieciešams) Izvietojamās instances tips. Opcijas ir Smilškaste, Ražošanas, Izmēģinājuma un SubscriptionBasedTrial.
AppsTemplate
Programmas		 Vides tipam, kas nav izmēģinājuma, atbalstītās programmas ir D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation un D365_Sales.
CurrencyName
Valūta		 (Nepieciešams) Izveidotās vides pamatvalūta. Pēc vides izveides valūtu nevar atjaunināt.
LanguageName
Valoda		 (Nepieciešams) Pamatvaloda vidē.
DomainName
Domēna nosaukums		 (Nepieciešams) Šī ir videi specifiska virkne, kas veido daļu no vietrāža URL. Piemēram, attiecībā uz vidi ar šādu vietrādi URL: https://powerappsbuildtasks.crm.dynamics.com/, domēna nosaukums ir 'powerappsbuildtasks'.

Piezīme: ja ievadāt domēna nosaukumu, kas jau tiek lietots, šis uzdevums pievieno skaitlisko vērtību domēna nosaukumam, sākot ar 0. Iepriekš dotajā piemērā vietrādis URL var tikt pārvērsts par https://powerappsbuildtasks0.crm.dynamics.com/.

Power Platform vides dzēšana

Dzēš vidi.

YAML fragments (vides dzēšana)

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

Parametri (vides dzēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, ka vēlaties dzēst vidi (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, ka vēlaties dzēst vidi (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.

Power Platform Piešķirt lietotāju

Piešķiriet lietotāju mērķa videi ar norādītiem drošības loma.

YAML fragments (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Parametri (AssignUser-env)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, kurai vēlaties piešķirt lietotāju (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
User
Power Platform lietotājvārds		 Microsoft Entra objekta ID vai lietotāja pamatnosaukums, ko piešķirt mērķa videi.
Role
Drošības loma vārds vai ID		 Drošības loma vārdu vai ID, kas jāpiešķir lietotājam.
ApplicationUser
Power Platform lietojumprogrammas lietotājvārds		 Norāda, vai ievades lietotājs ir lietojumprogrammas lietotājs (true|false).

Power Platform Atiestatīt vidi

Atiestata vidi.

YAML fragments (Reset-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.reset-environment.PowerPlatformResetEnvironment@2
  displayName: 'Power Platform Reset Environment '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    CurrencyName: ALL
    Purpose: 'Reset to PointInTime'
    AppsTemplate: 'D365_CustomerService,D365_FieldService'

Parametri (Reset-env)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kuru vēlaties atiestatīt vidi (piemēram, https://powerappsbuildtools.crm.dynamics.com). Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kuru vēlaties atiestatīt vidi (piemēram, https://powerappsbuildtools.crm.dynamics.com). Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.

Power Platform vides dublēšana

Vides dublēšana.

YAML fragments (vides rezerves kopēšana)

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

Parametri (vides rezerves kopēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts, kuru vēlaties dublēt vidē (piemēram, https://powerappsbuildtools.crm.dynamics.com). Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts, kuru vēlaties dublēt vidē (piemēram, https://powerappsbuildtools.crm.dynamics.com). Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
BackupLabel
Dublējumkopijas etiķete		 (Obligāts) Dublējumam piešķiramā etiķete.

Power Platform vides kopēšana

Kopē vidi mērķa vidē. Ir pieejamas divu veidu kopijas: pilnas un minimālas. Pilnajā kopijā ir iekļauti gan dati, gan risinājuma metadati (pielāgojumi), savukārt minimālajā kopijā ir tikai risinājumu metadati, nevis faktiskie dati.

YAML fragments (vides kopēšana)

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

Parametri (vides kopēšana)

Parametri Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts avota videi, no kuras vēlaties kopēt (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts avota videi, no kuras vēlaties kopēt (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
TargetEnvironmentUrl
Mērķvides URL		 (Obligāts) Tās mērķa vides URL, uz kuru vēlaties kopēt.
CopyType
Kopijas tips		 Veicamās kopijas tips: FullCopy vai MinimalCopy
OverrideFriendlyName
Pārrakstīt informatīvo nosaukumu		 Maina mērķa vides informatīvo nosaukumu uz citu nosaukumu (patiess|aplams).
FriendlyName
Draudzīgais nosaukums		 Mērķa vides draudzīgais nosaukums.
DisableAdminMode
Administrēšanas režīma atspējošana		 Vai deaktivizét administrēšanas režīmu (patiess|aplams).

Power Platform Atjaunot vidi

Atjauno konkrētā dublējuma vidi.

YAML fragments (Restore-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Parametri (Restore-env)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformEnvironment
Power Platform vides vietrādis URL		 Pakalpojuma galapunkts avota videi, no kuras vēlaties atjaunot (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts avota videi, no kuras vēlaties atjaunot (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
RestoreLatestBackup
Jaunākais dublējums atjaunošanai		 Vai atjaunot jaunāko dublējumu vai nodrošināt RestoreTimeStamp (patiess|aplams).
RestoreTimeStamp
Dublējuma datumsLaiks		 Dublējuma datums un laiks formātā “mm/dd/gggg hh:mm” VAI virkne “jaunākais”.
TargetEnvironmentUrl
Mērķvides URL		 (Obligāti) Vietrādis URL mērķa videi, kuru vēlaties atjaunot.
FriendlyName
Atjaunotās vides nosaukums		 (Pēc izvēles) Atjaunotās vides nosaukums.
DisableAdminMode
Administrēšanas režīma atspējošana		 Vai deaktivizét administrēšanas režīmu (patiess|aplams).

Datu eksportēšana Dataverse

Eksportējiet datus no vides, izmantojot norādīto shēmu.

YAML fragments (exportdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-data.PowerPlatformExportData@2
  displayName: 'Power Platform Export Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    SchemaFile: 'C:\tempschema.xml'
    DataFile: exportdata.zip
    Overwrite: true

Parametri (exportdata-env)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, no kuras vēlaties eksportēt datus (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
SchemaFile
Shēmas XML faila nosaukums		 Shēmas XML faila nosaukums. To var izveidot, izmantojot Configuration Migration rīku.
DataFile
Datu faila nosaukums		 Eksportējamo datu faila nosaukums (zip fails).
Overwrite
Satura pārrakstīšana		 Power Pages pārrakstāmo vietnes saturu (patiess|nepatiess).

Datu importēšana Dataverse

Datu importēšana vidē.

YAML fragments (importdata-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-data.PowerPlatformImportData@2
  displayName: 'Power Platform Import Data '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    DataFile: 'C:\Data\Import.zip'

Parametri (importdata-env)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, kurā vēlaties importēt datus (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
DataFile
Datu faila nosaukums		 Faila nosaukums saspiestai ZIP) importējamajam datu failam vai mapei ar data-schema.xml un data.xml, kas jāimportē.

Power Pages Pārvaldības uzdevumi

Uzdevumi darbam ar Power Pages vietni.

Power Platform PAPortal lejupielāde

Lejupielādēt Power Pages tīmekļa vietnes saturu no pašreizējās Dataverse vides.

YAML fragments (download-paportal)

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

Parametri (download-paportal)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, no kuras vēlaties lejupielādēt saturu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
WebsiteId
Portāla tīmekļa vietnes ID		 Power Pages tīmekļa vietnes ID, lai lejupielādētu.
Overwrite
Satura pārrakstīšana		 Power Pages pārrakstāmo vietnes saturu (patiess|nepatiess).
ModelVersion
Vietnes datu modelis		 Norāda, vai augšupielādējamie vietnes dati izmantos standarta (1) vai uzlaboto(-o) datu modeli ().2 Noklusējuma vērtība ir "1".

Power Platform PAPortal augšupielāde

Augšupielādējiet Power Pages vietnes saturu pašreizējā Dataverse vidē.

YAML fragments (augšupielāde-paportāls)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.upload-paportal.PowerPlatformUploadPaportal@2
  displayName: 'Power Platform Upload PAPortal '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    UploadPath: 'C:\portals\starter-portal'

Parametri (upload-paportal)

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, kurā vēlaties augšupielādēt saturu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
UploadPath
Satura augšupielādes ceļš		 Ceļš, Power Pages no kura tiks augšupielādēts vietnes saturs.
ModelVersion
Vietnes datu modelis		 Norāda, vai augšupielādējamie vietnes dati izmantos standarta (1) vai uzlaboto(-o) datu modeli ().2 Noklusējuma vērtība ir "1".

Uzdevumu katalogs (priekšskatījums Power Platform )

Šie uzdevumi veic darbības pret katalogu Power Platform un ietver tālāk norādīto.

Piezīmes

Pašlaik kataloga uzdevumi Power Platform ir priekšskatījuma laidiens .

Kataloga vienuma instalēšana

Instalējiet kataloga vienumu mērķa vidē.

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, kurā vēlaties augšupielādēt saturu (piemēram). https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
Environment
Mērķvides URL		 (Obligāti) Vides URL šis uzdevums ir paredzēts.
CatalogItemId
Kataloga krājuma ID, kas jāinstalē		 (Obligāti) Kataloga vienums, kas jāinstalē mērķa vidē.
TargetEnvironmentUrl
Mērķvides URL		 (Obligāti) Mērķa vides vietrādis URL kataloga vienumu instalēšanai (piemēram, "https://YourOrg.crm.dynamics.com").
PollStatus
Aptaujas statusa pārbaude		 (Pēc izvēles) Aptauja, lai pārbaudītu pieprasījuma statusu (patiess|nepatiess).

Parametri (kataloga instalēšana)

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

Iesniegt kataloga apstiprinājumu

Iesniedziet kataloga apstiprinājuma pieprasījumu.

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, kurā vēlaties augšupielādēt saturu (piemēram, "").https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
Environment
Mērķvides URL		 (Obligāti) Vides URL šis uzdevums ir paredzēts.
CatalogSubmissionFile
Kataloga iesniegšanas fails		 (Obligāti) Norādiet kataloga iesniegšanas faila ceļu un faila nosaukumu.
UsePackageSolutionZipFile
Faila veids		 Faila tips: pakotnes vai risinājuma zip fails.
SolutionZipFile
Risinājuma zip faila nosaukums		 Norādiet risinājuma zip faila ceļu un faila nosaukumu.
PollStatus
Aptaujas statusa pārbaude		 (Pēc izvēles) Aptauja, lai pārbaudītu pieprasījuma statusu (patiess|nepatiess).

Parametri (katalogs-iesniegt)

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

Kataloga pieprasījuma statuss

Iegūstiet kataloga instalēšanas/iesniegšanas pieprasījuma statusu.

Parameters Apraksts
authenticationType
Autentifikācijas veids		 (Obligāti SPN gadījumā) Norādiet PowerPlatformEnvironment lietotājvārda / paroles savienojumam vai PowerPlatformSPN servisa vadītāja / klienta slepenajam savienojumam.
PowerPlatformSPN
Power Platform servisa primārais		 Pakalpojuma galapunkts videi, kurā vēlaties augšupielādēt saturu (piemēram, "").https://powerappsbuildtools.crm.dynamics.com Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
Environment
Mērķvides URL		 (Obligāti) Vides URL šis uzdevums ir paredzēts.
TrackingId
Pieprasīt izsekošanas ID		 (Obligāti) Pieprasiet izsekošanas ID.
RequestType
Pieprasījuma tips		 (Obligāti) Reqeust tips. (Vērtības: Instalēt | Iesniegt).

Parametri (kataloga statuss)

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

Konveijeru būvēšana un izlaišana

Tagad, kad esam noteikuši, ko var paveikt, izmantojot izveides rīkus, paskatīsimies, kā šos rīkus var lietot jūsu izveidē un kā atbrīvot konveijerus. Tālāk ir parādīts konceptuāls pārskats. Sekojošajās apakšdaļās apskatīsim sīkāku informāciju par konveijeru īstenošanu, izmantojot izveides rīka uzdevumus.

Lai uzzinātu vairāk par šo konveijeru izveidi un veiktu praktisku konveijera autorēšanu, izmantojot Microsoft Power Platform Build Tools, pabeidziet Build Tools laboratorijas, ko varat lejupielādēt no GitHub.

Papildinformācija par Azure konveijeriem: Azure cauruļvadu izmantošana

Konveijera būvēšana: eksportējiet risinājumu no izstrādes vides (DEV)

Šajā attēlā ir parādīti izveides rīka uzdevumi, ko var pievienot konveijeram, kas eksportē risinājumu no izstrādes vides.

Eksportējiet risinājumu no izstrādes vides (DEV).

Būvēt konveijeru: pārvaldīta risinājuma izveide

Šajā attēlā ir parādīti izveides rīka uzdevumi, ko var pievienot konveijeram, kas būvē pārvaldītu risinājumu.

Veidojiet pārvaldīts risinājums.

Laidiena konveijers: izvietošana ražošanas vidē (PROD)

Šajā attēlā ir parādīti izveides rīka uzdevumi, ko var pievienot konveijeram, kuru izvieto ražošanas vidē.

Izvietošana ražošanas vidē (PROD).

Skatiet arī

Microsoft Power Platform Build Tools programmai Azure DevOps