Tugas Microsoft Power Platform Build Tools

Bahagian berikut menerangkan tugasan binaan yang tersedia. Selepas itu, kami tunjukkan beberapa contoh Azure Pipelines yang menggunakan tugasan ini. Untuk maklumat tentang alatan binaan dan cara memuat turunnya, lihat Microsoft Power Platform Alat Bina untuk Azure Pipelines.

Tugas pembantu

Bahagian berikut menerangkan tugasan pembantu yang tersedia.

Pemasang Alat Power Platform

Tambah tugasan ini sekali sebelum mana-mana tugasan Power Platform Build Tools lain dalam saluran bina dan pelepasan. Tugas ini memasang satu set alat khusus Power Platform yang diperlukan oleh ejen untuk menjalankan tugas binaan Microsoft Power Platform. Tugas ini tidak memerlukan sebarang konfigurasi lagi apabila ditambah. Tugas ini mengandungi parameter untuk versi khusus setiap alat yang dipasangnya.

Untuk kekal terkini dengan versi alat, pastikan parameter ini sepadan dengan versi alat yang diperlukan agar saluran paip berjalan dengan betul.

Cebisan YAML (Pemasang)

# 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

Parameter (Pemasang)

Parameter Perihalan
DefaultVersion
Gunakan versi alat lalai		 Ditetapkan kepada benar untuk menggunakan versi lalai semua alat, jika tidak palsu. Diperlukan (dan palsu) apabila anda menentukan mana-mana versi alat.
AddToolsToPath
Tambah Alat Ke Laluan		 Menambah CLI pac ke pembolehubah PATH persekitaran. Anda boleh menggunakan pac CLI daripada tugasan skrip tanpa perlu menyediakan laluan secara manual.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versi Alat		 Versi khusus alat untuk digunakan.

Platform Kuasa WhoAmI

Tentusahkan sambungan perkhidmatan persekitaran Power Platform dengan menyambung dan membuat permintaan WhoAmI. Tugas ini boleh jadi berguna untuk dimasukkan terlebih dahulu dalam talian paip bagi menentusahkan sambungan sebelum pemprosesan bermula.

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

Parameter (WhoAmI)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan. Untuk maklumat lanjut, lihat BuildTools.EnvironmentUrl di bawah Power Platform Create Environment
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik tamat perkhidmatan bagi persekitaran untuk disambungkan. Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek. Untuk maklumat lanjut, lihat BuildTools.EnvironmentUrl di bawah Power Platform Create Environment
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik tamat perkhidmatan bagi persekitaran untuk disambungkan. Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek.

Semak kualiti

Dalam bahagian seterusnya adalah tugas yang tersedia untuk memeriksa kualiti penyelesaian.

Pemeriksa Platform Kuasa

Tugasan ini menjalankan pemeriksaan analisis statik ke atas penyelesaian anda berdasarkan satu set peraturan amalan terbaik untuk mengenal pasti sebarang corak bermasalah yang mungkin anda perkenalkan secara tidak sengaja semasa membina penyelesaian anda.

Cebisan YAML (Penyemak)

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

Parameter (Penyemak)

Parameter Perihalan
PowerPlatformSPN
Sambungan perkhidmatan		 (Diperlukan) Untuk menggunakan pemeriksa Power Platform, anda memerlukan sambungan ke persekitaran Microsoft Power Platform berlesen. Tentukan sambungan perkhidmatan dalam Sambungan Perkhidmatan di bawah Tetapan Project menggunakan jenis sambungan Power Platform. Untuk maklumat lanjut, lihat BuildTools.EnvironmentUrl di bawah Power Platform Create Environment.

Nota: Tugas pemeriksa menyokong kaedah pengesahan Prinsipal Perkhidmatan dan nama pengguna/kata laluan. Untuk maklumat lanjut tentang mengkonfigurasi prinsipal perkhidmatan untuk tugas ini, lihat Konfigurasikan sambungan prinsipal perkhidmatan untuk persekitaran Power Platform.
UseDefaultPACheckerEndpoint
Guna titik tamat Penyemak Power Platform lalai		 Secara lalai (benar), lokasi geografi perkhidmatan penyemak menggunakan geografi yang sama dengan persekitaran yang anda sambungkan.
CustomPACheckerEndpoint
Titik tamat penyemak PAC tersuai		 Dikehendaki apabila UseDefaultPACheckerEndpoint adalah salah. Nyatakan geografi lain untuk digunakan, contohnya https://japan.api.advisor.powerapps.com. Untuk senarai geografi yang tersedia, lihat Gunakan Power Platform Checker API.
FileLocation
Lokasi fail untuk dianalisis		 Diperlukan apabila merujuk fail dari URL sasUriFiletandatangan akses kongsi (SAS).

Nota: Rujuk fail penyelesaian yang dieksport dan bukan fail sumber yang telah dibuka dalam repositori anda. Anda boleh menganalisis kedua-dua fail penyelesaian yang diurus dan tidak diuruskan.
FilesToAnalyzeSasUri
Fail SAS untuk dianalisis		 Dikehendaki apabila FileLocation ditetapkan kepada sasUriFile. Masukkan URI SAS. Anda boleh menambah lebih daripada satu SAS URI melalui koma (,) atau titik koma (;) senarai berasingan.
FilesToAnalyze
Fail tempatan untuk dianalisis		 Diperlukan apabila fail SAS tidak dianalisis. Tentukan laluan dan nama fail bagi fail zip untuk menganalisis. Anda boleh menggunakan wildcard. Sebagai contoh, masukkan **\*.zip untuk semua fail zip dalam semua subfolder.
FilesToExclude
Fail tempatan untuk dikecualikan		 Tentukan nama fail yang ingin dikecualikan daripada analisis. Jika anda menentukan lebih daripada satu fail, gunakan koma (,) atau titik koma (;) senarai berasingan. Senarai ini boleh merangkumi nama fail penuh atau nama dengan wildcard di hadapan atau di belakang, seperti *jquery atau form.js.
RulesToOverride
Peraturan untuk diatasi		 Susunan JSON mengandungi peraturan dan tahap untuk diatasi. Nilai yang diterima adalah OverrideLevel : Kritikal, Tinggi, Sederhana, Rendah, Maklumat. Sebagai contoh: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
RuleSet
Set peraturan		 (Diperlukan) Tentukan set peraturan untuk digunakan. Dua set peraturan yang berikut tersedia:
  • Pemeriksa penyelesaian: Set peraturan ini adalah sama seperti yang dijalankan dari portal Power Apps maker.
  • Marketplace: Set peraturan lanjutan yang digunakan untuk mengesahkan aplikasi sebelum ia boleh diterbitkan ke Marketplace.
ErrorLevel
Peringkat ralat		 Digabungkan dengan parameter ambang ralat, nilai ini menentukan tahap keterukan ralat dan amaran yang dibenarkan. Nilai ambang yang disokong ialah <tahap>IssueCount iaitu tahap=Kritikal, Tinggi, Sederhana, Rendah dan Bermaklumat.
ErrorThreshold
Ambang ralat		 Mentakrifkan bilangan ralat (> = 0) untuk tahap yang ditetapkan yang dibenarkan penyemak meluluskan penyelesaian yang sedang disemak.
FailOnPowerAppsCheckerAnalysisError
Gagal pada ralat		 Apabila benar, fail jika analisis Power Apps Checker kembali sebagai Failed atau FinishedWithErrors.
ArtifactDestinationName
Nama artifak DevOps		 Tentukan nama Azure Artifacts untuk fail .sarif penyemak.

Tugas penyelesaian

Set tugasan ini mengautomasikan tindakan penyelesaian. Tugas persekitaran yang digariskan kemudian dalam bahagian ini yang mencipta, menyalin atau memulihkan persekitaran menimpa sambungan perkhidmatan dengan persekitaran yang baru dicipta. Dengan menggunakan tugasan ini, anda boleh melaksanakan tugasan penyelesaian terhadap persekitaran yang anda cipta atas permintaan.

Penyelesaian Import Power Platform

Imports penyelesaian ke dalam persekitaran sasaran.

Cebisan YAML (Import)

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

Parameter (Import)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu import penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu import penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
SolutionInputFile
Fail input penyelesaian		 (Diperlukan) Laluan dan nama fail penyelesaian .zip fail untuk diimport ke dalam persekitaran sasaran (contohnya, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Nota: Pembolehubah memberi anda cara mudah untuk mendapatkan bit data utama ke dalam pelbagai bahagian saluran paip anda. Lihat Gunakan pemboleh ubah yang dipratentukan untuk senarai yang komprehensif.
HoldingSolution
Import sebagai penyelesaian pegangan		 Parameter lanjutan (benar|palsu) digunakan apabila penyelesaian perlu dinaik taraf. Parameter ini mengehoskan penyelesaian dalam Dataverse tetapi tidak menaik taraf penyelesaian sehingga tugas Guna Naik Taraf Penyelesaian berjalan.
OverwriteUnmanagedCustomizations
Tulis ganti penyesuaian yang tidak terurus		 Tentukan sama ada mahu menulis ganti penyesuaian yang tidak terurus (benar|palsu).
SkipProductUpdateDependencies
Langkau kebergantungan kemas kini produk		 Tentukan sama ada penguatkuasaan kebersandaran yang berkaitan dengan kemas kini produk harus dilangkau (benar|palsu).
ConvertToManaged
Tukar kepada terurus		 Usang. Sistem akan menukar komponen penyelesaian tidak terurus kepada terurus apabila anda mengimport penyelesaian terurus.
AsyncOperation
Import tidak segerak		 Jika dipilih (benar), operasi import akan dilaksanakan secara tidak segerak. Ini disyorkan untuk penyelesaian yang lebih besar kerana tugas ini akan tamat masa secara automatik selepas 4 minit atau sebaliknya. Memilih tidak segerak akan meninjau dan menunggu sehingga MaxAsyncWaitTime telah dicapai (benar|palsu).
MaxAsyncWaitTime
Masa tunggu maksimum		 Masa menunggu maksimum dalam beberapa minit untuk operasi tak segerak; lalai ialah 60 minit (1 jam), sama seperti lalai Azure DevOps untuk tugasan.
PublishWorkflows
Aktifkan proses selepas import		 Tentukan sama ada sebarang proses (aliran kerja) dalam penyelesaian perlu diaktifkan selepas import (benar|palsu).
UseDeploymentSettingsFile
Gunakan fail tetapan pelaksanaan		 Nilai rujukan sambungan dan pemboleh ubah persekitaran boleh ditetapkan dengan menggunakan fail tetapan pelaksanaan (benar|palsu).
DeploymentSettingsFile
Fail tetapan pelaksanaan		 (Diperlukan apabila UseDeploymentSettingsFile=benar) Laluan dan nama fail bagi fail tetapan pelaksanaan.

Power Platform Tambah Komponen Penyelesaian

Menambah komponen penyelesaian pada penyelesaian yang tidak terurus.

Coretan YAML (Tambah)

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

Parameter (Tambah)

Parameter Perihalan
ComponentId
ID komponen penyelesaian		 Nama skema atau ID komponen untuk ditambahkan pada penyelesaian sasaran.
ComponentType
URL persekitaran Power Platform		 Nilai yang mewakili komponen penyelesaian yang anda tambah. Lihat Gunakan jenis komponen yang telah ditetapkan untuk senarai komprehensif nilai komponen.
SolutionUniqueName
Nama penyelesaian		 Nama unik penyelesaian.
AddRequiredComponents
Sebarang komponen yang diperlukan daripada penyelesaian lain bergantung kepada komponen larutan		 (Pilihan) Menunjukkan sama ada komponen penyelesaian lain yang diperlukan oleh komponen penyelesaian yang anda tambah juga harus ditambah pada penyelesaian tidak terurus.
Environment
URL atau ID persekitaran		 (Pilihan) URL persekitaran atau ID persekitaran sasaran.

Guna Naik Taraf Penyelesaian Power Platform

Naik taraf penyelesaian yang telah diimport sebagai penyelesaian pegangan.

Cebisan YAML (Naik taraf)

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

Parameter (Naik taraf)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu menaik taraf penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu menaik taraf penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
SolutionName
Nama penyelesaian		 (Diperlukan) Nama penyelesaian untuk memohon naik taraf. Sentiasa gunakan Nama penyelesaian bukan Nama Paparan.
AsyncOperation
Naik taraf tidak segerak		 Jika dipilih (benar), operasi naik taraf akan dilaksanakan sebagai tugas kelompok tidak segerak. Pemilihan tidak segerak akan diundi dan tunggu sehingga MaxAsyncWaitTime telah dicapai.
MaxAsyncWaitTime
Masa tunggu maksimum		 Masa menunggu maksimum dalam beberapa minit untuk operasi tak segerak; lalai ialah 60 minit (1 jam), sama seperti lalai Azure DevOps untuk tugasan.

Nota

Pemboleh ubah memberikan anda cara mudah untuk mendapatkan cebisan utama data ke dalam pelbagai bahagian talian paip anda. Lihat Gunakan pemboleh ubah yang dipratentukan untuk senarai yang komprehensif. Anda boleh praisi maklumat rujukan sambungan dan pemboleh ubah persekitaran untuk persekitaran sasaran sambil mengimport penyelesaian menggunakan fail tetapan pelaksanaan.

Maklumat lanjut: Praisi rujukan sambungan dan pemboleh ubah persekitaran untuk pelaksanaan automatik

Penyelesaian Eksport Power Platform

Export penyelesaian daripada persekitaran sumber.

Cebisan YAML (Eksport)

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

Parameter (Eksport)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu menaik taraf penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu menaik taraf penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
SolutionName
Nama penyelesaian		 (Diperlukan) Nama penyelesaian untuk dieksport. Sentiasa gunakan Nama penyelesaian bukan Nama Paparan.
SolutionOutputFile
Fail output penyelesaian		 (Diperlukan) Laluan dan nama fail fail solution.zip untuk mengeksport persekitaran sumber (contohnya, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

Nota: Pembolehubah memberi anda cara mudah untuk mendapatkan bit data utama ke dalam pelbagai bahagian saluran paip anda. Lihat Gunakan pemboleh ubah yang dipratentukan untuk senarai yang komprehensif.
AsyncOperation
Eksport tidak segerak		 Jika dipilih (benar), operasi eksport akan dilaksanakan sebagai tugas kelompok tidak segerak. Pemilihan tidak segerak akan diundi dan tunggu sehingga MaxAsyncWaitTime telah dicapai.
MaxAsyncWaitTime
Masa tunggu maksimum		 Masa menunggu maksimum dalam beberapa minit untuk operasi tak segerak; lalai ialah 60 minit (1 jam), sama seperti lalai Azure DevOps untuk tugasan.
Managed
Eksport sebagai terurus		 Jika dipilih (benar), eksport penyelesaian sebagai penyelesaian terurus; sebaliknya eksport sebagai penyelesaian yang tidak terurus.
ExportAutoNumberingSettings
Eksport tetapan auto penomboran		 Eksport tetapan auto penomboran (benar|palsu).
ExportCalendarSettings
Eksport tetapan kalendar		 Eksport tetapan kalendar (benar|palsu).
ExportCustomizationSettings
Eksport tetapan penyesuaian		 Eksport tetapan penyesuaian (benar|palsu).
ExportEmailTrackingSettings
Eksport tetapan penjejakan e-mel		 Eksport tetapan penjejakan e-mel (benar|palsu).
ExportGeneralSettings
Eksport tetapan umum		 Eksport tetapan umum (benar|palsu).
ExportIsvConfig
Eksport konfigurasi ISV		 Eksport konfigurasi ISV (benar|palsu).
ExportMarketingSettings
Eksport tetapan pemasaran		 Eksport tetapan pemasaran (benar|palsu).
ExportOutlookSynchronizationSettings
Eksport seting penyegerakan Outlook		 Eksport seting penyegerakan Outlook (benar|salah).
ExportRelationshipRoles
Eksport peranan perhubungan		 Eksport peranan perhubungan (benar|palsu).
ExportSales
Eksport jualan		 Eksport jualan (benar|palsu).

Penyelesaian Buka Power Platform

Ambil fail penyelesaian dimampatkan dan nyahmampatkannya ke dalam berbilang fail XML supaya fail ini boleh dibaca dan diurus dengan mudah oleh sistem kawalan sumber.

Cebisan YAML (Buka pek)

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

Parameter (Buka pek)

Parameter Perihalan
SolutionInputFile
Fail input penyelesaian		 (Diperlukan) Laluan dan nama fail bagi fail solution.zip file untuk dibuka.
SolutionTargetFolder
Folder sasaran untuk nyahpakej penyelesaian		 (Diperlukan) Laluan dan folder sasaran yang anda mahu penyelesaian dibuka.
SolutionType
Jenis penyelesaian		 (Diperlukan) Jenis penyelesaian yang anda mahu buka. Pilihan termasuk: Tidak terurus (disyorkan), Terurus, dan Kedua-duanya.

Penyelesaian Pek Power Platform

Pekkan penyelesaian yang diwakili dalam kawalan sumber ke dalam fail solution.zip yang boleh diimport ke dalam persekitaran lain.

Cebisan YAML (Pek)

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

Parameter (Pek)

Parameter Perihalan
SolutionOutputFile
Fail output penyelesaian		 (Diperlukan) laluan dan nama fail bagi fail solution.zip untuk mempekkan penyelesaian.
SolutionSourceFolder
Folder sumber penyelesaian untuk membungkus		 (Diperlukan) Laluan dan folder sumber penyelesaian untuk dipek.
SolutionType
Jenis penyelesaian		 (Diperlukan) Jenis penyelesaian yang anda mahu pek. Pilihan termasuk: Terurus (disyorkan), Tidak terurus dan Kedua-duanya.

Padam penyelesaian Power Platform

Padam penyelesaian dalam persekitaran sasaran.

Cebisan YAML snippet (Padam)

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'

Parameter (Padam)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu padamkan penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu padamkan penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
SolutionName
Nama penyelesaian		 (Diperlukan) Nama penyelesaian untuk dipadamkan. Sentiasa gunakan Nama penyelesaian bukan Nama Paparan.

Penyesuaian Terbit Power Platform

Terbitkan semua penyesuaian dalam persekitaran.

Cebisan YAML (Terbit)

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

Parameter (Terbit)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu terbitkan penyesuaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu terbitkan penyesuaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran

Versi Penyelesaian Set Power Platform

Kemas kini versi penyelesaian.

Cebisan YAML (Versi)

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

Parameter (Versi)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu setkan versi penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu setkan versi penyelesaian (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
SolutionName
Nama penyelesaian		 (Diperlukan) Nama penyelesaian untuk tetapkan versi. Sentiasa gunakan Nama penyelesaian bukan Nama Paparan.
SolutionVersionNumber
Nombor versi penyelesaian		 (Diperlukan) Nombor versi yang anda mahu tetapkan.

Walaupun nombor versi boleh dikodkan keras dalam saluran paip, disyorkan untuk menggunakan pembolehubah saluran paip Azure DevOps seperti BuildId. Ini menyediakan pilihan untuk mentakrifkan bentuk sebenar nombor versi di bawah tab "Pilihan", contohnya: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3

Definisi ini kemudian boleh digunakan dalam tugas Versi Penyelesaian Set dengan menetapkan sifat Nombor Versi dengan: $(Build.BuildId) berbanding pengekodan keras 20200824.0.0.2.

Selain itu, skrip tugas dalam baris PowerShell $(Get-Date -Format yyyy.MM.dd.HHmm) output ditetapkan kepada pemboleh ubah kosong bernama SolutionVersion sebagai Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Tetapkan Versi Penyelesaian kepada $(SolutionVersion).

Power Platform Tetapkan Pembolehubah Sambungan

Mengesetkan PowerPlatformSetConnectionVariables.BuildTools.* pembolehubah untuk menyediakan akses tugas skrip tersuai untuk menggunakan sambungan perkhidmatan sebagai sumber kebenaran tunggal.

Pembolehubah berikut ditetapkan:

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

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

Parameter (SetConnectionVariables)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu tetapkan pembolehubah sambungan. Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
timeoutInMinutes
Tamat masa		 Menentukan masa maksimum, dalam beberapa minit, tugas dibenarkan untuk dilaksanakan sebelum dibatalkan oleh pelayan. Nilai sifar menunjukkan tamat masa tak terhingga.
retryCountOnTaskFailure
Bilangan percubaan semula jika tugas gagal		 Menentukan bilangan percubaan semula untuk tugas ini yang akan berlaku sekiranya kegagalan tugas. Tidak disokong untuk tugasan tanpa ejen.
ApplicationId
ID Permohonan untuk log masuk		 (Diperlukan untuk nama pengguna/kata laluan) ID Permohonan untuk digunakan untuk log masuk (Lihat nota tambahan di bawah).
RedirectUri
Ubah hala URI apl tertentu		 (Diperlukan untuk nama pengguna/kata laluan) Ubah hala URI apl yang ditentukan. Diperlukan apabila menentukan Id Apl. (Lihat nota tambahan di bawah).

Nota

Apabila menggunakan jenis pengesahan nama pengguna/kata laluan, Id Aplikasi dan Uri Ubah Hala akan diperlukan. Dokumen oauth pengesahan ini mempunyai penjelasan tentang sebab anda perlu membuat pendaftaran apl untuk mengesahkan Dataverse. Apabila anda menyambung menggunakan pengesahan nama pengguna/kata laluan, sambungan berkelakuan sebagai aplikasi yang menyambung bagi pihak pengguna kepada Dataverse.

Pakej Pelaksanaan Power Platform

Laksanakan pakej ke persekitaran. Melaksanakan pakej terlebih dahulu ke fail penyelesaian tunggal memberikan pilihan untuk melaksanakan berbilang penyelesaian, data, dan kod ke dalam persekitaran.

Cebisan YAML (Guna)

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

Parameter (Guna)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu gunakan pakej (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu gunakan pakej (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform. Maklumat lanjut: lihat BuildTools.EnvironmentUrl di bawah Power Platform Cipta Persekitaran
PackageFile
Fail pakej		 Hendaklah Laluan dan nama fail pemasangan fail pakej (. dll).
MaxAsyncWaitTime
Masa tunggu maksimum		 Masa menunggu maksimum dalam beberapa minit untuk operasi tak segerak; lalai ialah 60 minit (1 jam), sama seperti lalai Azure DevOps untuk tugasan.

Tugas pengurusan persekitaran

Mengautomasikan tugas Pengurusan Kitaran Hayat Persekitaran lazim (ELM).

Persekitaran Cipta Power Platform

Cipta persekitaran baharu. Mencipta persekitaran baharu juga secara automatik mencipta BuildTools.EnvironmentUrl.

Penting

Apabila ditetapkan, BuildTools.EnvironmentUrl akan digunakan sebagai sambungan perkhidmatan lalai untuk tugas seterusnya dalam talian paip. Setiap tugas yang diterangkan dalam artikel ini hanya menggunakan titik tamat daripada sambungan perkhidmatan apabila BuildTools.EnvironmentUrl tidak ditetapkan.

Persekitaran baharu hanya boleh diperuntukkan jika lesen atau kapasiti anda membenarkan penciptaan persekitaran tambahan. Untuk mendapatkan maklumat lanjut tentang cara melihat kapasiti lihat Butiran halaman kapasiti.

Cebisan YAML (Create-env)

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

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

Parameter (Create-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu cipta persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu cipta persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
DisplayName
Nama Paparan		 (Diperlukan) Nama paparan bagi persekitaran yang dicipta.
LocationName
Rantau pelaksanaan		 (Diperlukan) Rantau ini agar persekitaran perlu dicipta.
EnvironmentSku
Jenis persekitaran		 (Diperlukan) Jenis tika untuk melaksanakan. Pilihan ialah Kotak pasir, Pengeluaran, Percubaan, dan SubscriptionBasedTrial.
AppsTemplate
Aplikasi		 Bagi jenis persekitaran bukan percubaan, aplikasi yang disokong adalah D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation, dan D365_Sales.
CurrencyName
Mata wang		 (Diperlukan) Mata Wang asas untuk persekitaran yang dicipta. Mata wang tidak boleh dikemas kini selepas persekitaran dicipta.
LanguageName
Bahasa		 (Diperlukan) Bahasa asas dalam persekitaran.
DomainName
Nama Domain		 (Diperlukan) Ini ialah rentetan khusus persekitaran yang membentuk sebahagian daripada URL tersebut. Contohnya, untuk persekitaran dengan URL berikut:https://powerappsbuildtasks.crm.dynamics.com/, nama domain akan menjadi 'powerappsbuildtasks'.

Nota: Jika anda memasukkan nama domain yang sudah digunakan, tugas tersebut menambahkan nilai berangka pada nama domain, bermula dengan 0. Untuk contoh di atas, URL mungkin menjadihttps://powerappsbuildtasks0.crm.dynamics.com/.

Persekitaran Padam Power Platform

Padamkan persekitaran.

Cebisan YAML (Delete-env)

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

Parameter (Delete-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu padamkan persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu padamkan persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.

Power Platform Tugaskan Pengguna

Tugaskan pengguna kepada persekitaran sasaran dengan peranan keselamatan yang ditentukan.

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

Parameter (AssignUser-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu tugaskan kepada pengguna (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
User
Power Platform Nama pengguna		 ID objek Microsoft Entra atau nama utama pengguna untuk diperuntukkan kepada persekitaran sasaran.
Role
Nama atau ID peranan keselamatan		 Nama peranan atau ID keselamatan yang akan diberikan kepada pengguna.
ApplicationUser
Power Platform Nama pengguna aplikasi		 Menentukan sama ada pengguna input ialah pengguna aplikasi (true|false).

Power Platform Tetapkan semula Persekitaran

Menetapkan semula persekitaran.

Coretan YAML (Tetapkan semula-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'

Parameter (Tetapkan semula-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu tetapkan semula persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu tetapkan semula persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.

Persekitaran Sandaran Power Platform

Persediaan persekitaran.

Cebisan YAML (Backup-env)

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

Parameter (Backup-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan yang anda mahu sandarkan persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan yang anda mahu sandarkan persekitaran (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
BackupLabel
Label sandaran		 (Diperlukan) Label yang akan ditugaskan ke sandaran.

Persekitaran Salinan Power Platform

Salin persekitaran ke persekitaran sasaran. Dua jenis salinan boleh didapati: penuh dan minimum. Salinan penuh termasuk metadata data dan penyelesaian (penyesuaian), manakala salinan minimum hanya termasuk metadata penyelesaian dan bukan data sebenar.

Cebisan YAML (Copy-env)

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

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

Parameter (Copy-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan untuk persekitaran sumber yang anda mahu salin daripada (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran sumber yang anda mahu salin daripada (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
TargetEnvironmentUrl
URL persekitaran sasaran		 (Diperlukan) URL untuk persekitaran sasaran yang anda mahu salin.
CopyType
Jenis salinan		 Jenis salinan untuk dilaksanakan: FullCopy atau MinimalCopy
OverrideFriendlyName
Gantikan nama mesra		 Tukar nama mesra persekitaran sasaran kepada nama lain (benar|palsu).
FriendlyName
Nama mesra		 Nama mesra persekitaran sasaran.
SkipAuditData
Langkau Data Audit		 Sama ada untuk melangkau data audit semasa operasi salinan. (benar|salah).
MaxAsyncWaitTime
Masa tunggu maksimum		 Masa menunggu maksimum dalam beberapa minit untuk operasi tak segerak; lalai ialah 60 minit (1 jam), sama seperti lalai Azure DevOps untuk tugasan.

Power Platform Pulihkan Persekitaran

Pulihkan persekitaran kepada sandaran yang diberikan.

Coretan YAML (Pulihkan-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'

Parameter (Restore-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformEnvironment
URL persekitaran Power Platform		 Titik akhir perkhidmatan untuk persekitaran sumber yang anda mahu pulihkan daripada (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran sumber yang anda mahu pulihkan daripada (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
RestoreLatestBackup
Sandaran terkini untuk dipulihkan		 Sama ada untuk memulihkan sandaran terkini atau menyediakan RestoreTimeStamp (true|false).
RestoreTimeStamp
TarikhMasa sandaran		 DateTime sandaran dalam format 'bb/hh/tttt jj:mm' atau rentetan 'terkini'.
TargetEnvironmentUrl
URL persekitaran sasaran		 (Diperlukan) URL untuk persekitaran sasaran yang ingin anda pulihkan.
FriendlyName
Nama persekitaran yang dipulihkan		 (Pilihan) Nama persekitaran yang dipulihkan.
DisableAdminMode
Nyahdayakan mod pentadbir		 Sama ada mahu menyahdayakan mod pentadbiran (benar|palsu).

Eksport Dataverse Data

Eksport data daripada persekitaran dengan skema yang disediakan.

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

Parameter (exportdata-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu mengeksport data (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
SchemaFile
Nama fail XML skema		 Nama fail XML skema. Ia boleh dibuat menggunakan alat Migrasi Konfigurasi.
DataFile
Nama fail data		 Nama fail untuk data untuk dieksport (fail zip).
Overwrite
Menulis ganti kandungan		 Kandungan laman web Power Pages untuk menimpa (benar|salah).

Import Dataverse Data

Import data ke persekitaran.

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

Parameter (importdata-env)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu import data (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
DataFile
Nama fail data		 Nama fail untuk zip termampat) fail data untuk diimport, atau folder dengan data-schema.xml dan data.xml untuk diimport.

Tugas pengurusan Power Pages

Tugas untuk bekerja dengan laman web Power Pages.

Power Platform Muat turun PAPortal

Muat turun kandungan tapak web Power Pages daripada persekitaran Dataverse semasa.

Coretan YAML (muat turun-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

Parameter (muat turun-paportal)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu muat turun kandungan (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
WebsiteId
ID laman web portal		 ID laman web Power Pages untuk dimuat turun.
Overwrite
Menulis ganti kandungan		 Kandungan laman web Power Pages untuk menimpa (benar|salah).
ModelVersion
Model Data Tapak		 Menunjukkan sama ada data tapak yang akan dimuat naik akan menggunakan model1 data standard ( ) atau dipertingkatkan(2). Nilai lalai ialah '1'.

Power Platform Muat naik PAPortal

Muat naik kandungan laman web Power Pages ke persekitaran Dataverse semasa.

Coretan YAML (muat naik-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'

Parameter (muat naik-paportal)

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu muat naik kandungan (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
UploadPath
Muat naik laluan kandungan		 Laluan dari mana kandungan laman web Power Pages akan dimuat naik.
ModelVersion
Model Data Tapak		 Menunjukkan sama ada data tapak yang akan dimuat naik akan menggunakan model1 data standard ( ) atau dipertingkatkan(2). Nilai lalai ialah '1'.

Katalog untuk Power Platform tugasan (pratonton)

Tugas-tugas ini melakukan tindakan terhadap katalog dalam Power Platform dan termasuk yang berikut.

Nota

Pada masa ini, tugasan katalog untuk Power Platform ialah keluaran pratonton .

Pasang item katalog

Pasang item katalog ke persekitaran sasaran.

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu muat naik kandungan (contohnya, https://powerappsbuildtools.crm.dynamics.com). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
Environment
URL persekitaran sasaran		 (Diperlukan) Persekitaran url tugas ini menyasarkan.
CatalogItemId
ID Item Katalog untuk dipasang		 (Diperlukan) Item katalog untuk dipasang pada persekitaran sasaran.
TargetEnvironmentUrl
URL persekitaran sasaran		 (Diperlukan) Url persekitaran sasaran untuk pemasangan item katalog ke dalam (contohnya, "https://YourOrg.crm.dynamics.com").
PollStatus
Semak status tinjauan pendapat		 (Pilihan) Tinjauan pendapat untuk menyemak status permintaan anda (benar|salah).

Parameter (pemasangan katalog)

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

Hantar kelulusan Katalog

Serahkan permintaan kelulusan katalog.

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu muat naik kandungan (contohnya, "https://powerappsbuildtools.crm.dynamics.com"). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
Environment
URL persekitaran sasaran		 (Diperlukan) Persekitaran url tugas ini menyasarkan.
CatalogSubmissionFile
Fail penyerahan katalog		 (Diperlukan) Tentukan laluan dan nama fail fail penyerahan katalog.
UsePackageSolutionZipFile
Jenis fail		 Jenis fail: pakej atau fail zip penyelesaian.
SolutionZipFile
Nama fail zip penyelesaian		 Tentukan laluan dan nama fail fail zip penyelesaian.
PollStatus
Semak status tinjauan pendapat		 (Pilihan) Tinjauan pendapat untuk menyemak status permintaan anda (benar|salah).

Parameter (hantar katalog)

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

Status permintaan katalog

Dapatkan status permintaan pemasangan/hantar katalog.

Parameter Perihalan
authenticationType
Jenis pengesahan		 (Pilihan) Nyatakan sama ada PowerPlatformEnvironment untuk sambungan nama pengguna/kata laluan atau PowerPlatformSPN untuk sambungan rahsia Prinsipal Perkhidmatan/pelanggan.
PowerPlatformSPN
Prinsipal Perkhidmatan Power Platform		 Titik akhir perkhidmatan untuk persekitaran yang anda mahu muat naik kandungan (contohnya, "https://powerappsbuildtools.crm.dynamics.com"). Ditakrifkan di bawah Sambungan Perkhidmatan dalam Tetapan Projek menggunakan jenis sambungan Power Platform.
Environment
URL persekitaran sasaran		 (Diperlukan) Persekitaran url tugas ini menyasarkan.
TrackingId
Minta ID penjejakan		 (Diperlukan) Minta ID penjejakan.
RequestType
Jenis permintaan		 (Diperlukan) Jenis reqeust. (Nilai: Pasang | Hantar).

Parameter (status katalog)

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

Talian paip binaan dan keluaran

Sekarang kami telah mengenalpasti apa yang boleh dilakukan dengan menggunakan alatan binaan, mari lihat cara anda mungkin menggunakan alatan ini untuk talian paip binaan dan keluaran anda. Gambaran keseluruhan konsep ditunjukkan di bawah. Mari lihat beberapa butiran pelaksanaan talian paip menggunakan tugas alatan binaan dalam sub bahagian yang diikuti.

Untuk mengetahui lebih lanjut tentang mencipta saluran paip ini dan benar>benar melakukan pengarangan saluran paip secara langsung menggunakan Alat Bina Microsoft Power Platform, lengkapkan makmal alatan , yang boleh anda muat turun daripada GitHub.

Maklumat lanjut tentang Azure Pipelines: Gunakan Azure Pipelines

Bina talian paip: Eksport penyelesaian daripada persekitaran pembangunan (DEV)

Rajah berikut menunjukkan tugas alatan binaan yang anda mungkin tambahkan pada talian paip yang mengeksport penyelesaian daripada persekitaran pembangunan.

Eksport penyelesaian daripada persekitaran pembangunan (DEV).

Bina talian paip: Bina penyelesaian terurus

Rajah berikut menunjukkan tugas alatan binaan yang anda mungkin tambahkan pada talian paip yang membina penyelesaian terurus.

Bina penyelesaian terurus.

Talian paip keluaran: Laksanakan kepada persekitaran pengeluaran (PROD)

Rajah berikut menunjukkan tugas alatan binaan yang anda mungkin tambahkan pada talian paip yang melaksanakan persekitaran pengeluaran.

Gunakan ke persekitaran pengeluaran (PROD).

Lihat Juga

Microsoft Power Platform Bina Alat untuk Azure DevOps

  • Last updated on