Microsoft Power Platform Build Tools uzdevumi
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@2
displayName: 'Power Platform Tool Installer'
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
Parametri (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@2
displayName: 'Power Platform WhoAmI'
inputs:
# Service Principal/client secret (supports MFA)
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'My service connection'
# Verifies an environment service connection
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.whoami.PowerPlatformWhoAmi@2
displayName: 'Power Platform WhoAmI'
inputs:
# Username/password (no MFA support)
PowerPlatformEnvironment: 'My service connection'
Parametri (WhoAmI)
Parametri | 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@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@2
displayName: 'Power Platform Checker '
inputs:
PowerPlatformSPN: 'Dataverse service connection'
UseDefaultPACheckerEndpoint: false
CustomPACheckerEndpoint: 'https://japan.api.advisor.powerapps.com/'
FileLocation: sasUriFile
FilesToAnalyzeSasUri: 'SAS URI'
FilesToAnalyze: '**\*.zip'
FilesToExclude: '**\*.tzip'
RulesToOverride: 'JSON array'
RuleSet: '0ad12346-e108-40b8-a956-9a8f95ea18c9'
Parametri (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 vidiPiezī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:
|
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@2
displayName: 'Power Platform Import Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
HoldingSolution: true
OverwriteUnmanagedCustomizations: true
SkipProductUpdateDependencies: true
ConvertToManaged: true
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
displayName: 'Power Platform Import Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
AsyncOperation: true
MaxAsyncWaitTime: 60
PublishWorkflows: false
Parametri (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 galvenos 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@2
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionName: 'Contoso_sample'
AsyncOperation: false
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.apply-solution-upgrade.PowerPlatformApplySolutionUpgrade@2
displayName: 'Power Platform Apply Solution Upgrade '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
MaxAsyncWaitTime: 45
Parametri (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@2
displayName: 'Power Platform Export Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionName: 'Contoso_sample'
SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
Managed: true
MaxAsyncWaitTime: 120
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.export-solution.PowerPlatformExportSolution@2
displayName: 'Power Platform Export Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionName: 'Contoso_sample'
SolutionOutputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
Managed: true
MaxAsyncWaitTime: 120
ExportAutoNumberingSettings: true
ExportCalendarSettings: true
ExportCustomizationSettings: true
ExportEmailTrackingSettings: true
ExportGeneralSettings: true
ExportIsvConfig: true
ExportMarketingSettings: true
ExportOutlookSynchronizationSettings: true
ExportRelationshipRoles: true
ExportSales: true
Parametri (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 galvenos 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@2
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@2
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@2
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@2
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@2
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@2
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@2
displayName: 'Power Platform Create Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
DisplayName: 'First Coffee test'
DomainName: firstcoffee
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.create-environment.PowerPlatformCreateEnvironment@2
displayName: 'Power Platform Create Environment '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
DisplayName: 'First Coffee prod'
EnvironmentSku: Production
AppsTemplate: 'D365_CustomerService,D365_FieldService'
LocationName: canada
LanguageName: 1036
CurrencyName: ALL
DomainName: firstcoffee
Parametri (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īmes: Ja ievadāt domēna nosaukumu, kas jau tiek izmantots, uzdevums domēna nosaukumam pievieno skaitlisku vērtību, sākot ar 0. Iepriekš dotajā piemērā vietrādis URL var tikt pārvērsts par |
Power Platform vides dzēšana
Dzēš vidi.
YAML fragments (vides dzēšana)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
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ājam mērķa vidi ar noteiktu drošības lomu.
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 lomas nosaukums vai ID |
Lietotājam piešķiramās drošības lomas nosaukums vai ID. |
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@2
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@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
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. |
SkipAuditData SkipAuditData |
Vai izlaist audita datus kopēšanas laikā (patiess|nepatiess). |
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 izlaidums.
Instalējiet kataloga vienumu
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āts) Vides URL, uz kuru attiecas šis uzdevums. |
CatalogItemId Instalējamais kataloga vienuma ID |
(Obligāts) Kataloga vienums, kas jāinstalē mērķa vidē. |
TargetEnvironmentUrl Mērķvides URL |
(Obligāts) Kataloga vienumu instalēšanas mērķa vides URL (piemēram, "https://YourOrg.crm.dynamics.com"). |
PollStatus Pārbaudiet aptaujas statusu |
(Neobligāti) Aptauja, lai pārbaudītu jūsu pieprasījuma statusu (true|false). |
Parametri (katalogs-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
Iesniedziet 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āts) Vides URL, uz kuru attiecas šis uzdevums. |
CatalogSubmissionFile Kataloga iesniegšanas fails |
(Obligāts) Norādiet kataloga iesniegšanas faila ceļu un faila nosaukumu. |
UsePackageSolutionZipFile Faila veids |
Faila veids: pakotnes vai risinājuma zip fails. |
SolutionZipFile Risinājuma zip faila nosaukums |
Norādiet risinājuma zip faila ceļu un faila nosaukumu. |
PollStatus Pārbaudiet aptaujas statusu |
(Neobligāti) Aptauja, lai pārbaudītu jūsu pieprasījuma statusu (true|false). |
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āts) Vides URL, uz kuru attiecas šis uzdevums. |
TrackingId Pieprasīt izsekošanas ID |
(Obligāts) Pieprasīt izsekošanas ID. |
RequestType Pieprasījuma tips |
(Obligāts) Pieprasījuma veids. (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.
Plašāka informācija par Azure Pipelines: Izmantojiet Azure Pipelines
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.
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.
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ē.