Microsoft Power Platform būvēšanas rīku uzdevumi

Pieejamie izveides uzdevumi ir aprakstīti tālāk norādītajās sadaļās. Pēc tam mēs parādām dažus piemērus Azure Pipelines, kas izmanto šos uzdevumus. Informāciju par būvēšanas rīkiem un to lejupielādi skatiet sadaļā Microsoft Power Platform Būvēšanas rīki Azure Pipelines.

Palīga uzdevums

Tālāk ir aprakstīti pieejamie palīgs uzdevumi.

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. Šis uzdevums instalē Power Platform specifisku rīku kopu, kas aģentam nepieciešama, lai izpildītu Microsoft Power Platform būvēšanas uzdevumus. Šis uzdevums vairs neprasa konfigurāciju, kad tas tiek pievienots. Šajā uzdevumā ir iekļauti parametri katra instalētā 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

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

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.
AddToolsToPath
Pievienot rīkus ceļam		 Vides mainīgajam PATH pievieno pac cli. Ļauj izmantot pac cli no skripta uzdevumiem, neiestatot ceļu manuāli.
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 pieejamie uzdevumi risinājuma kvalitātes pārbaudei.

Power Platform pārbaudītājs

Šis uzdevums veic statiskās analīzes pārbaudi jūsu risinājumiem, salīdzinot ar labākās prakses kārtulu kopumu, lai identificētu problemātiskus modeļus, kurus jūs varētu nejauši ieviest, veidojot 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		 (Obligāti) Lai izmantotu Power Platform pārbaudītāju, ir nepieciešams savienojums ar licencētu Microsoft Power Platform vidi. Servisa savienojumi tiek definēti Servisa savienojumos sadaļā Projekta iestatījumi, izmantojot Power Platform savienojuma tipu. Papildinformācija: skatiet BuildTools.EnvironmentUrl sadaļā Power Platform Vides

izveide Piezīme: pārbaudītāja uzdevumam ir pieejamas pakalpojuma princips 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 (true) pārbaudītāja pakalpojuma ģeogrāfiskā atrašanās vieta izmanto to pašu ģeogrāfisko atrašanās vietu kā vide, ar kuru izveidojat savienojumu.
CustomPACheckerEndpoint
Pielāgots PAC pārbaudītāja galapunkts		 Vajadzīgs, ja UseDefaultPACheckerEndpoint ir aplams. Varat norādīt citu ģeogrāfisko vietu, piemēram https://japan.api.advisor.powerapps.com. , Pieejamo ģeogrāfisko vietu sarakstu skatiet sadaļā Pārbaudītāja API Power Platform izmantošana.
FileLocation
Analizējamo failu atrašanās vieta		 Nepieciešams, atsaucoties uz failu no koplietojamās piekļuves paraksta (SAS) URL. sasUriFile

Piezīme: Ir svarīgi atsaukties uz eksportēto risinājuma failu, nevis uz neiesaiņotajiem avota failiem repozitorijā. 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 no portāla Power Apps maker.
  • Marketplace: paplašināta kārtulu kopa, kas tiek izmantota, lai sertificētu lietojumprogrammu, pirms to var publicēt Marketplace.
ErrorLevel
Kļūdu līmenis		 Apvienojumā ar kļūdu parametrs sliekšņs 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 true, neizdodas, ja Power Apps pārbaudītāja analīze tiek atgriezta kā Neizdevās vai PabeigtaWithErrors.
ArtifactDestinationName
DevOps artefakta nosaukums		 Norādiet Azure Artifacts nosaukumu pārbaudītāja .sarif failam.

Risinājuma uzdevumi

Šī uzdevumu kopa var automatizēt risinājuma darbības. Tālāk šajā sadaļā aprakstītie vides uzdevumi, kas veido, kopē vai atjauno vidi, pārraksta pakalpojuma savienojumus ar jaunizveidotajām vidēm. Šie uzdevumi ļauj veikt risinājuma uzdevumus vidē, kas tiek izveidota 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

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 fails, kas jāimportē mērķa vidē (piemēram, $(Build.ArtifactStagingDirectory)$(SolutionName) .zip).

Piezīme: Mainīgie sniedz ērtu veidu, kā iegūt galvenos datu bitus dažādās cauruļvada 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		 Novecojis. Importējot pārvaldītu risinājumu, sistēma pārvērš nepārvaldītos risinājuma komponentus par pārvaldītiem.
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 gaidīšanas laiks minūtēs asinhronajai darbībai; noklusējums ir 60 min (1 h), tāds pats kā Azure DevOps noklusējums 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)

Parametri 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ē pievienojamo risinājuma komponentu. Visaptverošu komponentu vērtību sarakstu skatiet sadaļā Iepriekš definētu komponentu tipu izmantošana .
SolutionUniqueName
Risinājuma nosaukums		 Risinājuma unikāls nosaukums.
AddRequiredComponents
Visi komponenti, kas nepieciešami no cita šķīduma, kas ir atkarīgi no šķīduma komponenta		 (Pēc izvēles) Norāda, vai nepārvaldītajam risinājumam ir jāpievieno arī citi risinājuma komponenti, kas nepieciešami pievienotajam risinājuma komponentam.
Environment
Vides URL vai ID		 (Pēc izvēles) Mērķa vides URL vai 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 gaidīšanas laiks minūtēs asinhronajai darbībai; noklusējums ir 60 min (1 h), tāds pats kā Azure DevOps noklusējums uzdevumiem.

Piezīmes

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) solution.zip faila ceļš un faila nosaukums, uz kuru eksportēt avota vidi (piemēram, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Piezīme: Mainīgie sniedz ērtu veidu, kā iegūt galvenos datu bitus dažādās cauruļvada 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 gaidīšanas laiks minūtēs asinhronajai darbībai; noklusējums ir 60 min (1 h), tāds pats kā Azure DevOps noklusējums 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		 Eksportēt Outlook sinhronizācijas iestatījumus (true|false).
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, kuru 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, kuru 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 konveijerā, 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 PowerPlatformSetConnectionVariables.BuildTools.* mainīgos, lai nodrošinātu pielāgotu skriptu uzdevumu piekļuvi, lai pakalpojuma savienojumu izmantotu kā vienu patiesības avotu.

Tiek iestatīti šādi mainīgie lielumi:

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

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)

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.
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 uzdevumam ir atļauts izpildīt, 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ārtoto mēģinājumu skaitu, kas notiks uzdevuma neveiksmes gadījumā. Nav atbalstīts uzdevumiem bez aģenta.
ApplicationId
Pieteikuma ID pieteikšanās		 (Nepieciešams lietotājvārdam/parolei) Lietojumprogrammas ID, ko izmantot pieteikšanās veikšanai (skatīt papildu piezīmi zemāk).
RedirectUri
Konkrētās programmas novirzīšanas URI		 (Nepieciešams lietotājvārdam/parolei) Norādītās programmas novirzīšanas URI. Nepieciešams, norādot lietotnes ID. (skatīt papildu piezīmi zemāk).

Piezīmes

Izmantojot lietotājvārda/paroles autentifikācijas tipu, būs nepieciešams lietojumprogrammas ID un novirzīšanas URI. Šajā autentifikācijas oauth dokumentā ir paskaidrots, kāpēc jums ir jāizveido lietotnes reģistrācija, lai autentificētos Dataverse. Izveidojot savienojumu, izmantojot lietotājvārda/paroles autentifikāciju, savienojums darbojas kā lietojumprogramma, kas lietotāja vārdā izveido savienojumu 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 gaidīšanas laiks minūtēs asinhronajai darbībai; noklusējums ir 60 min (1 h), tāds pats kā Azure DevOps noklusējums 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, kuram vēlaties izveidot 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, kuram vēlaties izveidot vidi (piemēram, https://powerappsbuildtools.crm.dynamics.com). Definēts Projekta iestatījumu sadaļā Servisa savienojumi, lietojot Power Platform savienojuma veidu.
DisplayName
Parādāmais 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 veids		 (Nepieciešams) Izvietojamās instances tips. Opcijas ir Smilškaste, Ražošanas, Izmēģinājuma un SubscriptionBasedTrial.
AppsTemplate
Lietojumprogrammas		 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
Language		 (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 jau lietotu domēna nosaukumu, 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 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@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, kuru 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, kuru 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ītu 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)

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.
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 pamatvārds, kas jāpiešķir mērķa videi.
Role
Drošības lomas nosaukums vai ID		 Drošības lomas nosaukums 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

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

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 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
    MaxAsyncWaitTime: 60

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 kopēšanas laikā izlaist audita datus. (taisnība|nepatiess).
MaxAsyncWaitTime
Maksimālais gaidīšanas laiks		 Maksimālais gaidīšanas laiks minūtēs asinhronajai darbībai; noklusējums ir 60 min (1 h), tāds pats kā Azure DevOps noklusējums uzdevumiem.

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)

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 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, kas jāatjauno		 Vai atjaunot jaunāko dublējumu vai nodrošināt RestoreTimeStamp (true|false).
RestoreTimeStamp
DatumsDublējuma laiks		 Dublējuma datums un laiks formātā “mm/dd/gggg hh:mm” VAI virkne “jaunākais”.
TargetEnvironmentUrl
Mērķvides URL		 (Obligāti) Mērķa vides URL, 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).

Eksportēt Dataverse datus

Eksportējiet datus no vides ar 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)

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.
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 konfigurācijas migrācijas rīku.
DataFile
Datu faila nosaukums		 Eksportējamo datu faila nosaukums (zip fails).
Overwrite
Satura pārrakstīšana		 Power Pages tīmekļa vietnes saturs, kas jāpārraksta (patiess|nepatiess).

Datu importēšana Dataverse

Importēt datus 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)

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.
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		 Importējamā saspiestā zip datu faila nosaukums vai importējamā mape ar data-schema.xml un data.xml.

Power Pages pārvaldības uzdevumi

Uzdevumi darbam ar Power Pages tīmekļa 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)

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.
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 mājas lapas ID		 Power Pages tīmekļa vietnes ID, lai lejupielādētu.
Overwrite
Satura pārrakstīšana		 Power Pages tīmekļa vietnes saturs, kas jāpārraksta (patiess|nepatiess).
ModelVersion
Vietnes datu modelis		 Norāda, vai augšupielādējamie vietnes dati izmantos standarta (1) vai uzlaboto datu modeli (2). Noklusējuma vērtība ir "1".

Power Platform PAPortal augšupielāde

Augšupielādējiet Power Pages tīmekļa vietnes saturu pašreizējā Dataverse vidē.

YAML fragments (upload-paportal)

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

Parametri (upload-paportal)

Parametri 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
Augšupielādes satura ceļš		 Ceļš, no kura tiks augšupielādēts Power Pages tīmekļa vietnes saturs.
ModelVersion
Vietnes datu modelis		 Norāda, vai augšupielādējamie vietnes dati izmantos standarta (1) vai uzlaboto datu modeli (2). Noklusējuma vērtība ir "1".

Uzdevumu Power Platform katalogs (priekšskatījums)

Š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ē.

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.
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
Instalējamais kataloga vienuma ID		 (Obligāti) Kataloga vienums, kas jāinstalē mērķa vidē.
TargetEnvironmentUrl
Mērķvides URL		 (Obligāti) Kataloga vienuma instalēšanas mērķa vides URL (piemēram, "https://YourOrg.crm.dynamics.com").
PollStatus
Aptaujas statusa pārbaude		 (Pēc izvēles) Aptauja, lai pārbaudītu 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

Iesniegt kataloga apstiprinājumu

Iesniedziet kataloga apstiprinājuma pieprasījumu.

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.
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 (true|false).

Parametri (katalogs-iesniegšana)

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.

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.
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) Pieprasīt 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 praktisku konveijera autorēšanu, izmantojot Microsoft Power Platform veidošanas rīkus, aizpildiet build tools labs, kuru 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.

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.

Izveidojiet 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ē.

Izvietot ražošanas vidē (PROD).

Skatiet arī

Microsoft Power Platform Veidojiet rīkus Azure DevOps

  • Last updated on