Tugas Microsoft Power Platform Build Tools
Tugas Build yang tersedia dijelaskan di bagian berikut. Setelah itu, kami menampilkan beberapa contoh Azure Pipelines yang memanfaatkan tugas-tugas ini. Untuk informasi tentang alat build dan cara mengunduhnya, lihat Microsoft Power Platform Build Tools untuk Azure Pipelines.
Tugas pembantu
Tugas pembantu yang tersedia dijelaskan selanjutnya.
Installer alat Power Platform
Tugas ini diperlukan untuk ditambahkan satu kali sebelum tugas alat Build Power Platform lainnya di alur Build dan rilis. Tugas ini menginstal seperangkat alat spesifik Power Platform yang diperlukan oleh agen untuk menjalankan tugas build Microsoft Power Platform. Tugas ini tidak memerlukan konfigurasi lagi saat ditambahkan. Tugas ini berisi parameter untuk versi tertentu dari setiap alat yang sedang diinstal.
Agar dapat tetap diperbarui dengan versi alat dari waktu ke waktu, pastikan parameter ini sesuai dengan versi alat yang diperlukan untuk alur agar berjalan dengan benar.
Cuplikan YAML (Penginstal)
# Installs default Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
displayName: 'Power Platform Tool Installer'
inputs:
DefaultVersion: false
XrmToolingPackageDeploymentVersion: 3.3.0.928
Parameter (Penginstal)
Parameter | KETERANGAN |
---|---|
DefaultVersion Gunakan versi alat default |
Diatur ke true untuk menggunakan versi default dari semua alat, jika tidak, maka false. Diperlukan (dan false) bila versi alat apa pun ditentukan. |
PowerAppsAdminVersion XrmToolingPackageDeploymentVersion MicrosoftPowerAppsCheckerVersion CrmSdkCoreToolsVersion Versi alat |
Versi alat yang spesifik untuk digunakan. |
Power Platform WhoAmI
Memverifikasi koneksi Layanan lingkungan Power Platform dengan menghubungkan dan membuat permintaan WhoAmI. Tugas ini dapat berguna untuk menyertakan awal di alur kerja, untuk memverifikasi konektivitas sebelum pemrosesan dimulai.
Cuplikan 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 | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(Opsional) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Layanan titik akhir untuk lingkungan yang ingin dihubungkan. Ditentukan dalam sambungan layanan di pengaturan proyek. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Layanan titik akhir untuk lingkungan yang ingin dihubungkan. Ditentukan dalam sambungan layanan di pengaturan proyek. |
Pemeriksaan kualitas
Di bagian berikutnya adalah tugas yang tersedia untuk memeriksa kualitas solusi.
Power Platform Checker
Tugas ini menjalankan pemeriksaan analisis statis pada solusi Anda terhadap serangkaian aturan praktik terbaik untuk mengidentifikasi pola bermasalah yang mungkin secara tidak sengaja Anda perkenalkan saat membangun solusi Anda.
Cuplikan YAML (Pemeriksa)
# 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 (Pemeriksa)
Parameter | KETERANGAN |
---|---|
PowerPlatformSPN Sambungan Layanan |
(Diperlukan) Sambungan ke lingkungan Microsoft Power Platform berlisensi diperlukan untuk menggunakan pemeriksa Power Platform. Sambungan layanan ditentukan dalam sambungan layanan dalam pengaturan proyek menggunakan jenis sambungan Power Platform. Informasi selengkapnya: lihat BuildTools.EnvironmentUrl di bawah Power Platform Buat LingkunganCatatan: Metode autentikasi Perwakilan Layanan dan nama pengguna/kata sandi tersedia untuk tugas pemeriksa. Untuk informasi lebih lanjut tentang cara mengkonfigurasi Layanan prinsipal untuk digunakan dengan tugas ini, lihat mengkonfigurasi sambungan prinsip layanan untuk lingkungan Power Platform. |
UseDefaultPACheckerEndpoint Gunakan titik akhir Pemeriksa Power Platform default |
Secara default (true), lokasi geografis layanan pemeriksa menggunakan geografi yang sama dengan lingkungan yang Anda sambungkan. |
CustomPACheckerEndpoint titik akhir Pemeriksa PAC kustom |
Diperlukan bila UseDefaultPACheckerEndpoint adalah salah. Anda dapat menentukan geografis lain yang akan digunakan, misalnya https://japan.api.advisor.powerapps.com. Untuk daftar geografi yang tersedia, lihat Menggunakan Power Platform API Pemeriksa. |
FileLocation Lokasi file untuk dianalisis |
Diperlukan saat mereferensikan file dari URL sasUriFile tanda tangan akses bersama (SAS).Catatan: Penting untuk mereferensikan file solusi yang diekspor dan bukan file sumber yang dibongkar di repositori Anda. File solusi terkelola maupun tidak terkelola dapat dianalisis. |
FilesToAnalyzeSasUri file SAS untuk dianalisis |
Diperlukan bila FileLocation diatur ke sasUriFile . Masukkan URI SAS. Anda dapat menambahkan lebih dari satu URI SAS melalui Daftar terpisah koma (,) atau titik koma (;). |
FilesToAnalyze File lokal untuk dianalisis |
Diperlukan saat file SAS tidak dianalisis. Tentukan jalur dan nama file dari file zip untuk dianalisis. Wildcard dapat digunakan. Misalnya, masukkan ** \*.zip untuk semua file zip di semua subfolder. |
FilesToExclude File lokal untuk dikecualikan |
Tentukan nama file yang akan dikesampingkan dari analisis. Jika lebih dari satu, berikan melalui daftar terpisah koma (,) atau titik koma (;). Daftar ini dapat mencakup nama file lengkap atau nama dengan wildcard depan atau belakang, seperti *jquery atau form.js |
RulesToOverride Aturan untuk menimpa |
Larik JSON yang berisi aturan dan tingkat untuk menimpa. Nilai yang disetujui untuk OverrideLevel adalah: Penting, Tinggi, Sedang, Rendah, Informasi. Misalnya: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
RuleSet Rangkaian aturan |
(Diperlukan) Tentukan aturan yang diatur untuk diterapkan. Rangkaian dua aturan berikut tersedia: |
ErrorLevel Tingkat kesalahan |
Dikombinasikan dengan error, parameter threshold menentukan tingkat keparahan error dan peringatan yang diizinkan. Nilai ambang batas yang didukung adalah <level>ssueCount dengan level=Penting, Tinggi, Sedang, Rendah, dan Informasi. |
ErrorThreshold Ambang kesalahan |
Menentukan jumlah kesalahan (>=0) pada tingkat tertentu yang diizinkan agar pemeriksa dapat melewatkan solusi yang sedang diperiksa. |
FailOnPowerAppsCheckerAnalysisError Gagal karena kesalahan |
Bila true, gagal jika analisis Pemeriksa Power Apps dikembalikan sebagai Gagal atau FinishedWithErrors. |
ArtifactDestinationName Nama artefak DevOps |
Tentukan nama Azure Artifacts untuk file .sarif pemeriksa. |
Tugas solusi
Rangkaian tugas ini dapat mengotomatisasi tindakan solusi. Tugas lingkungan yang diuraikan nanti di bagian ini yang membuat, menyalin, atau memulihkan lingkungan menimpa koneksi layanan dengan lingkungan yang baru dibuat. Tugas-tugas ini memungkinkan untuk melakukan tugas solusi terhadap lingkungan yang dibuat sesuai permintaan.
Impor Solusi Power Platform
Mengimpor solusi ke lingkungan target.
Cuplikan yaml (Impor)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
displayName: 'Power Platform Import Solution '
inputs:
PowerPlatformEnvironment: 'My service connection'
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
HoldingSolution: true
OverwriteUnmanagedCustomizations: true
SkipProductUpdateDependencies: true
ConvertToManaged: true
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
displayName: 'Power Platform Import Solution '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
SolutionInputFile: 'C:\Public\Contoso_sample_1_0_0_1_managed.zip'
AsyncOperation: true
MaxAsyncWaitTime: 60
PublishWorkflows: false
Parameter (Impor)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda impor solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda impor solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
SolutionInputFile File input solusi |
(Wajib) Jalur dan nama file solusi .zip file untuk diimpor ke lingkungan target (misalnya,.zip $(Build.ArtifactStagingDirectory)$(SolutionName)).
Catatan: Variabel memberi Anda cara mudah untuk mendapatkan bit data penting ke berbagai bagian alur Anda. Lihat gunakan variabel yang telah ditetapkan untuk daftar yang komprehensif. |
HoldingSolution Impor sebagai solusi wadah |
Parameter sebelumnya (true|false) yang digunakan saat solusi harus ditingkatkan. Parameter ini meng-host solusi Dataverse namun tidak meningkatkan solusi hingga tugas Terapkan Peningkatan Solusi dijalankan. |
OverwriteUnmanagedCustomizations Timpa penyesuaian tak terkelola |
Tentukan apakah akan menimpa penyesuaian yang tidak terkelola (true|false). |
SkipProductUpdateDependencies Abaikan dependensi pembaruan produk |
Tentukan apakah pemberlakuan dependensi yang terkait dengan pembaruan produk harus diabaikan (true|false). |
ConvertToManaged Konversikan ke terkelola |
Tentukan apakah akan mengimpor sebagai solusi terkelola (true|false). |
AsyncOperation Impor Asinkron |
Jika dipilih (true), operasi impor akan dilakukan secara asinkron. Ini direkomendasikan untuk solusi yang lebih besar karena tugas ini akan secara otomatis habis waktunya setelah 4 menit jika sebaliknya. Memilih asinkron akan melakukan poling dan menunggu hingga MaxAsyncWaitTime dicapai (true|false). |
MaxAsyncWaitTime Waktu tunggu maksimum |
Waktu tunggu maksimum dalam menit untuk operasi asinkron; default adalah 60 menit (1 jam), sama dengan default Azure DevOps untuk tugas. |
PublishWorkflows Mengaktifkan proses setelah impor |
Tentukan apakah proses (alur kerja) apa pun di solusi harus diaktifkan setelah impor (true|false). |
UseDeploymentSettingsFile Gunakan file pengaturan penyebaran |
Referensi koneksi dan nilai variabel lingkungan dapat diatur dengan menggunakan file pengaturan penyebaran (true|false). |
DeploymentSettingsFile File pengaturan penyebaran |
(Diperlukan bila UseDeploymentSettingsFile =true) Jalur dan nama file dari file pengaturan penyebaran. |
Power Platform Tambahkan Komponen Solusi
Menambahkan komponen solusi ke solusi yang tidak dikelola.
Cuplikan YAML (Tambahkan)
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 (Tambahkan)
Parameter | Description |
---|---|
ComponentId ID komponen solusi |
Nama skema atau ID komponen untuk ditambahkan ke solusi target. |
ComponentType URL Lingkungan Power Platform |
Nilai yang mewakili komponen solusi yang Anda tambahkan. Lihat Menggunakan jenis komponen yang telah ditentukan sebelumnya untuk daftar lengkap nilai komponen. |
SolutionUniqueName Nama solusi |
Nama unik solusi. |
AddRequiredComponents Komponen apa pun yang diperlukan dari solusi lain tergantung pada komponen solusi |
(Opsional) Menunjukkan apakah komponen solusi lain yang diperlukan oleh komponen solusi yang Anda tambahkan juga harus ditambahkan ke solusi yang tidak dikelola. |
Environment URL atau ID lingkungan |
(Opsional) URL lingkungan atau ID lingkungan target. |
Power Platform Terapkan Peningkatan Solusi
Meningkatkan solusi yang telah diimpor sebagai solusi wadah.
Cuplikan YAML (Peningkatan)
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 (Peningkatan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda tingkatkan solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda tingkatkan solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
SolutionName Nama Solusi |
(Wajib) Nama solusi untuk menerapkan peningkatan. Selalu gunakan nama solusi, bukan nama tampilannya. |
AsyncOperation Peningkatan asinkron |
Jika dipilih (true), operasi peningkatan akan dilakukan sebagai pekerjaan kumpulan asinkron. Memilih asinkron akan melakukan poling dan menunggu hingga MaxAsyncWaitTime dicapai. |
MaxAsyncWaitTime Waktu tunggu maksimum |
Waktu tunggu maksimum dalam menit untuk operasi asinkron; default adalah 60 menit (1 jam), sama dengan default Azure DevOps untuk tugas. |
Catatan
Variabel memberi Anda cara mudah untuk mendapatkan potongan kunci data ke berbagai bagian alur Anda. Lihat gunakan variabel yang telah ditetapkan untuk daftar yang komprehensif. Anda dapat mengisi referensi koneksi sebelumnya dan informasi variabel lingkungan untuk lingkungan target sambil mengimpor solusi menggunakan file pengaturan penyebaran.
Informasi selengkapnya: Isi dulu Referensi sambungan dan variabel lingkungan untuk penyebaran otomatis
Ekspor Solusi Power Platform
Mengekspor solusi dari lingkungan sumber.
Cuplikan YAML (ekspor)
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 (ekspor)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda tingkatkan solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda tingkatkan solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
SolutionName Nama Solusi |
(Diperlukan) Nama solusi yang akan diekspor. Selalu gunakan nama solusi, bukan nama tampilannya. |
SolutionOutputFile File output solusi |
(Wajib) Jalur dan nama file file solution.zip untuk mengekspor lingkungan sumber (misalnya, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).
Catatan: Variabel memberi Anda cara mudah untuk mendapatkan bit data penting ke berbagai bagian alur Anda. Lihat gunakan variabel yang telah ditetapkan untuk daftar yang komprehensif. |
AsyncOperation Ekspor Asinkron |
Jika dipilih (true), operasi ekspor akan dilakukan sebagai pekerjaan kumpulan asinkron. Memilih asinkron akan melakukan poling dan menunggu hingga MaxAsyncWaitTime dicapai. |
MaxAsyncWaitTime Waktu tunggu maksimum |
Waktu tunggu maksimum dalam menit untuk operasi asinkron; default adalah 60 menit (1 jam), sama dengan default Azure DevOps untuk tugas. |
Managed Ekspor sebagai terkelola |
Jika dipilih (true), ekspor solusi sebagai solusi terkelola; atau ekspor sebagai solusi tidak terkelola. |
ExportAutoNumberingSettings Mengekspor pengaturan penomoran otomatis |
Mengekspor pengaturan penomoran otomatis (true|false). |
ExportCalendarSettings ekspor Pengaturan kalender |
ekspor Pengaturan kalender (true|false). |
ExportCustomizationSettings Ekspor pengaturan penyesuaian |
Ekspor Pengaturan penyesuaian (true|false). |
ExportEmailTrackingSettings Ekspor Pengaturan Pelacakan email |
Mengekspor pengaturan pelacakan email (true|false). |
ExportGeneralSettings ekspor Pengaturan umum |
ekspor Pengaturan umum (true|false). |
ExportIsvConfig Mengekspor konfigurasi ISV |
Mengekspor konfigurasi ISV (true|false). |
ExportMarketingSettings ekspor Pengaturan pemasaran |
Ekspor Pengaturan pemasaran (true|false). |
ExportOutlookSynchronizationSettings Mengekspor pengaturan sinkronisasi Outlook |
Ekspor Pengaturan Sinkronisasi Outlook (true|false). |
ExportRelationshipRoles Ekspor Peran relasi |
Ekspor Peran relasi (true|false). |
ExportSales Ekspor Penjualan |
Ekspor penjualan (true|false). |
Solusi membongkar paket Power Platform
Mengambil file solusi terkompresi dan mengurangkan menjadi beberapa file XML dan file lainnya sehingga file ini dapat lebih mudah dibaca dan dikelola oleh sistem kontrol sumber.
Cuplikan YAML (Bongkar)
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 (Bongkar)
Parameter | KETERANGAN |
---|---|
SolutionInputFile File input solusi |
(Diperlukan) Jalur dan nama file dari file solution.zip untuk dibongkar. |
SolutionTargetFolder Folder target untuk membongkar solusi |
(Diperlukan) Folder jalur dan target yang akan Anda gunakan untuk membongkar solusi. |
SolutionType Jenis solusi |
(Diperlukan) Jenis solusi yang ingin Anda bongkar. Pilihan mencakup: Tidak terkelola (disarankan), terkelola, dan keduanya. |
Solusi paket Power Platform
Mengemas solusi yang diwakili dalam kontrol sumber ke dalam file Solution.zip yang dapat diimpor ke lingkungan lain.
Cuplikan YAML (Kemas)
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 (Kemas)
Parameter | KETERANGAN |
---|---|
SolutionOutputFile File output solusi |
(Diperlukan) Jalur dan nama file dari file Solution.zip untuk dikemas solusinya. |
SolutionSourceFolder Folder sumber solusi untuk dikemas |
(Diperlukan) Folder jalur dan sumber solusi untuk dikemas. |
SolutionType Jenis solusi |
(Diperlukan) Jenis solusi yang ingin Anda kemas. Pilihan mencakup: terkelola (disarankan), tidak terkelola, dan keduanya. |
Power Platform Menghapus solusi
Menghapus solusi dalam lingkungan sasaran.
Cuplikan YAML (Hapus)
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 (Hapus)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda hapus solusinya (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda hapus solusinya (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
SolutionName Nama Solusi |
(Wajib) Nama solusi yang akan dihapus. Selalu gunakan nama solusi, bukan nama tampilannya. |
Publikasikan penyesuaian Power Platform
Mempublikasikan semua penyesuaian di lingkungan.
Cuplikan YAML (Publikasikan)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.publish-customizations.PowerPlatformPublishCustomizations@2
displayName: 'Power Platform Publish Customizations '
inputs:
authenticationType: PowerPlatformSPN
PowerPlatformSPN: 'Dataverse service connection '
Parameter (Publikasikan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda publikasikan penyesuaian (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda publikasikan penyesuaian (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
Versi Solusi set Power Platform
Memperbarui versi solusi.
Cuplikan 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 | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda atur versi solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda atur versi solusi (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
SolutionName Nama Solusi |
(Wajib) Nama solusi untuk diatur versinya. Selalu gunakan nama solusi, bukan nama tampilannya. |
SolutionVersionNumber Nomor Versi Solusi |
(Diperlukan) Nomor versi yang ingin Anda atur. |
Meskipun nomor versi dapat di-hardcode dalam alur, namun sebaiknya gunakan variabel alur Azure DevOps seperti BuildId. Ini memberikan pilihan untuk menentukan bentuk sama persis dari nomor versi di dalam tab "Pilihan", misalnya: $(Year:yyyy)-$(Month:MM)-$(Day:dd)-$(rev:rr)-3
Definisi ini kemudian dapat digunakan dalam tugas Atur Versi Solusi dengan mengatur properti Nomor Versi dengan: $(Build.BuildId) bukan hard code 20200824.0.0.2.
Atau output skrip tugas sebaris powershell $(Get-Date -Format yyyy.MM.dd.HHmm) diatur ke variabel kosong bernama SolutionVersion sebagai Write-Host ("##vso[task.setvariable variable=SolutionVersion;]$version"), Atur Versi Solusi sebagai $(SolutionVersion).
Power Platform Tetapkan Variabel Koneksi
Mengatur variabel BuildTools.* untuk menyediakan akses tugas skrip kustom untuk menggunakan koneksi layanan sebagai sumber kebenaran tunggal.
Cuplikan 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 | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda atur variabel koneksinya. Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
timeoutInMinutes Waktu habis |
Menentukan waktu maksimum, dalam menit, bahwa tugas diizinkan untuk dijalankan sebelum dibatalkan oleh server. Nilai nol menunjukkan batas waktu tak terbatas. |
retryCountOnTaskFailure Jumlah percobaan ulang jika tugas gagal |
Menentukan jumlah percobaan ulang untuk tugas ini yang akan terjadi jika terjadi kegagalan tugas. Tidak didukung untuk tugas tanpa agen. |
ApplicationId ID Aplikasi untuk login |
(Diperlukan untuk nama pengguna/kata sandi) Id Aplikasi yang akan digunakan untuk login (Lihat catatan tambahan di bawah). |
RedirectUri URI pengalihan aplikasi tertentu |
(Diperlukan untuk nama pengguna/kata sandi) Pengalihan URI aplikasi yang ditentukan. Diperlukan saat menentukan ID Aplikasi. (Lihat catatan tambahan di bawah). |
Catatan
Saat menggunakan jenis otentikasi nama pengguna/kata sandi, Id Aplikasi dan Uri Pengalihan akan diperlukan. Dokumen autentikasi oauth ini memiliki penjelasan tentang mengapa Anda perlu membuat pendaftaran aplikasi untuk diautentikasi Dataverse. Saat Anda terhubung menggunakan otentikasi nama pengguna/kata sandi, koneksi berperilaku sebagai aplikasi yang terhubung atas nama pengguna Dataverse.
Sebarkan Paket Power Platform
Menerapkan paket ke lingkungan. Menyebarkan paket sebagai lawan satu file solusi memberikan pilihan untuk menyebarkan beberapa solusi, data, dan kode ke lingkungan.
Cuplikan YAML (Sebarkan)
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 (Sebarkan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda sebarkan paket (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda sebarkan paket (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Buat lingkungan Power Platform |
PackageFile File paket |
(Wajib) Jalur dan nama file dari assembly file paket (.dll). |
MaxAsyncWaitTime Waktu tunggu maksimum |
Waktu tunggu maksimum dalam menit untuk operasi asinkron; default adalah 60 menit (1 jam), sama dengan default Azure DevOps untuk tugas. |
Tugas manajemen lingkungan
Mengotomatisasi tugas manajemen siklus hidup lingkungan umum (ELM).
Power Platform Membuat lingkungan
Membuat Lingkungan baru. Membuat lingkungan baru juga secara otomatis membuat BuildTools.EnvironmentUrl
.
Penting
Bila diatur, BuildTools.EnvironmentUrl
akan digunakan sebagai sambungan layanan default untuk tugas berikutnya di alur. Setiap tugas yang dijelaskan di artikel ini hanya menggunakan titik akhir dari sambungan layanan bila BuildTools.EnvironmentUrl
tidak diatur.
Lingkungan baru hanya dapat disediakan jika lisensi atau kapasitas Anda memungkinkan pembuatan lingkungan tambahan. Untuk informasi lebih lanjut tentang cara melihat kapasitas Lihat rincian halaman kapasitas.
Cuplikan YAML (buat lingkungan)
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 (Buat lingkungan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda buat lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda buat lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
DisplayName Nama tampilan |
(Disyaratkan) nama tampilan lingkungan yang dibuat. |
LocationName Wilayah Penyebaran |
(Disyaratkan) Kawasan tempat lingkungan dibuat. |
EnvironmentSku Jenis lingkungan |
(Disyaratkan) Jenis instans untuk disebarkan. Pilihan adalah Sandbox, Produksi, Uji Coba, dan SubscriptionBasedTrial. |
AppsTemplate Aplikasi |
Untuk jenis lingkungan non-uji coba, aplikasi yang didukung adalah D365_CustomerService, D365_FieldService, D365_ProjectServiceAutomation, dan D365_Sales. |
CurrencyName Mata uang |
(Disyaratkan) Mata uang dasar untuk lingkungan yang dibuat. Mata uang tidak dapat diperbarui setelah lingkungan dibuat. |
LanguageName Bahasa |
(Disyaratkan) Bahasa dasar di lingkungan. |
DomainName Nama Domain |
(Disyaratkan) Ini adalah string khusus lingkungan yang membentuk bagian dari URL. Misalnya, untuk lingkungan dengan URL berikut: https://powerappsbuildtasks.crm.dynamics.com/ , nama domain adalah 'powerappsbuildtasks'.
Catatan: Jika Anda memasukkan nama domain yang sudah digunakan, tugas akan menambahkan nilai numerik ke nama domain, dimulai dengan 0. Untuk contoh di atas, URL mungkin menjadi |
Power Platform Menghapus lingkungan
Menghapus lingkungan.
Cuplikan YAML (Hapus lingkungan)
steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.delete-environment.PowerPlatformDeleteEnvironment@2
displayName: 'Power Platform Delete Environment '
inputs:
PowerPlatformEnvironment: 'My service connection'
Parameter (Hapus lingkungan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda hapus lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda hapus lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
Power Platform Tetapkan Pengguna
Tetapkan pengguna ke lingkungan target dengan peran keamanan yang ditentukan.
Cuplikan 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 (Tetapkan User-lingkungan)
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan yang ingin Anda tetapkan pengguna (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
User Power Platform Nama pengguna |
Microsoft Entra ID objek atau nama utama pengguna untuk ditetapkan ke lingkungan target. |
Role Nama atau ID peran keamanan |
Nama atau ID peran keamanan yang akan ditetapkan kepada pengguna. |
ApplicationUser Power Platform Nama pengguna aplikasi |
Menentukan apakah pengguna input adalah pengguna aplikasi (true|false). |
Power Platform Setel Ulang Lingkungan
Mengatur ulang lingkungan.
Cuplikan YAML (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'
Parameter (Reset-env)
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda atur ulang lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda atur ulang lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
Lingkungan cadangan Power Platform
Mencadangkan lingkungan.
Cuplikan YAML (cadangkan lingkungan)
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 (Cadangkan lingkungan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan yang ingin Anda cadangkan lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan yang ingin Anda cadangkan lingkungan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
BackupLabel Label cadangan |
(Wajib) Label yang akan ditetapkan ke cadangan. |
Salin lingkungan Power Platform
Menyalin lingkungan ke lingkungan target. Tersedia dua jenis salinan: penuh dan minimal. Salinan lengkap mencakup metadata data dan solusi (penyesuaian), sedangkan salinan minimal hanya mencakup metadata solusi dan bukan data aktual.
cuplikan YAML (salin lingkungan)
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
Parameter (Salin lingkungan)
Parameter | KETERANGAN |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan untuk lingkungan sumber yang ingin Anda salin (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan sumber yang ingin Anda salin (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
TargetEnvironmentUrl URL lingkungan target |
(Wajib) URL untuk lingkungan target yang akan disalin. |
CopyType Jenis salinan |
Jenis salinan untuk dilakukan: FullCopy atau MinimalCopy |
OverrideFriendlyName Timpa nama yang mudah diingat |
Ubah nama akrab lingkungan target ke nama lain (true|false). |
FriendlyName Nama yang mudah diingat |
Nama panggilan lingkungan target. |
SkipAuditData Lewati Data Audit |
Apakah akan melewatkan data audit selama operasi penyalinan. (benar|salah). |
Power Platform Pulihkan Lingkungan
Mengembalikan lingkungan ke cadangan yang ditentukan.
Cuplikan YAML (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'
Parameter (Pulihkan-lingkungan)
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformEnvironment URL Lingkungan Power Platform |
Titik akhir layanan untuk lingkungan sumber yang ingin Anda pulihkan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan sumber yang ingin Anda pulihkan (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
RestoreLatestBackup Cadangan terbaru untuk dipulihkan |
Apakah akan memulihkan cadangan terbaru atau menyediakan RestoreTimeStamp (true|false). |
RestoreTimeStamp TanggalWaktu cadangan |
WaktuTanggal cadangan dalam format 'bb/hh/tttt jj:mm' ATAU string 'terbaru'. |
TargetEnvironmentUrl URL lingkungan target |
(Wajib) URL untuk lingkungan target yang ingin Anda pulihkan. |
FriendlyName Nama lingkungan yang dipulihkan |
(Opsional) Nama lingkungan yang dipulihkan. |
DisableAdminMode Menonaktifkan mode Admin |
Apakah akan menonaktifkan mode administrasi (true|false). |
Ekspor Dataverse Data
Ekspor data dari lingkungan dengan skema yang disediakan.
Cuplikan 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 | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan tempat Anda ingin mengekspor data (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
SchemaFile Nama file XML skema |
Nama file XML skema. Ini dapat dibuat menggunakan alat Migrasi Konfigurasi. |
DataFile Nama file data |
Nama file untuk data yang akan diekspor (file zip). |
Overwrite Penimpaan konten |
Power Pages konten situs web untuk ditimpa (true|false). |
Impor Dataverse Data
Impor data ke lingkungan.
Cuplikan 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 | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan yang ingin Anda impor data (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
DataFile Nama file data |
Nama file untuk file data zip terkompresi) untuk diimpor, atau folder dengan data-schema.xml dan data.xml yang akan diimpor. |
Power Pages Tugas manajemen
Tugas untuk bekerja dengan Power Pages situs web.
Power Platform Unduh PAPortal
Unduh konten situs web Power Pages dari lingkungan Dataverse saat ini.
Cuplikan YAML (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
Parameter (download-paportal)
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan tempat Anda ingin mengunduh konten (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
WebsiteId ID situs web portal |
Power Pages ID situs web untuk diunduh. |
Overwrite Penimpaan konten |
Power Pages konten situs web untuk ditimpa (true|false). |
ModelVersion Model Data Situs |
Menunjukkan apakah data situs yang akan diupload akan menggunakan model1 data standar ( ) atau enhanced data ().2 Nilai default adalah '1'. |
Power Platform Unggah PAPortal
Unggah Power Pages konten situs web ke lingkungan saat ini Dataverse .
Cuplikan YAML (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'
Parameter (upload-paportal)
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan tempat Anda ingin mengunggah konten (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
UploadPath Jalur konten upload |
Jalur dari mana Power Pages konten situs web akan diunggah. |
ModelVersion Model Data Situs |
Menunjukkan apakah data situs yang akan diupload akan menggunakan model1 data standar ( ) atau enhanced data ().2 Nilai default adalah '1'. |
Katalog untuk Power Platform tugas (pratinjau)
Tugas ini melakukan tindakan terhadap katalog dalam dan Power Platform menyertakan yang berikut ini.
Catatan
Saat ini, tugas katalog untuk adalah Power Platform rilis pratinjau .
Instal item katalog
Menginstal item katalog ke lingkungan target.
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan tempat Anda ingin mengunggah konten (misalnya,). https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
Environment URL lingkungan target |
(Wajib) URL lingkungan yang ditargetkan tugas ini. |
CatalogItemId ID Item Katalog yang akan diinstal |
(Wajib) Item katalog yang akan diinstal pada lingkungan target. |
TargetEnvironmentUrl URL lingkungan target |
(Wajib) Url lingkungan target untuk penginstalan item katalog ke dalam (misalnya, "").https://YourOrg.crm.dynamics.com |
PollStatus Periksa status jajak pendapat |
(Opsional) Jajak pendapat untuk memeriksa status permintaan Anda (true|false). |
Parameter (catalog-install)
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
Kirim persetujuan Katalog
Kirim permintaan persetujuan katalog.
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan tempat Anda ingin mengunggah konten (misalnya, "").https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
Environment URL lingkungan target |
(Wajib) URL lingkungan yang ditargetkan tugas ini. |
CatalogSubmissionFile File pengajuan katalog |
(Wajib) Tentukan jalur dan nama file file pengiriman katalog. |
UsePackageSolutionZipFile Jenis file |
Jenis file: paket atau file zip solusi. |
SolutionZipFile Nama file zip solusi |
Tentukan jalur dan nama file file zip solusi. |
PollStatus Periksa status jajak pendapat |
(Opsional) Jajak pendapat untuk memeriksa status permintaan Anda (true|false). |
Parameter (katalog-kirim)
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 penginstalan/kirim katalog.
Parameter | Description |
---|---|
authenticationType Jenis autentikasi |
(diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan. |
PowerPlatformSPN Prinsipal Layanan Power Platform |
Titik akhir layanan untuk lingkungan tempat Anda ingin mengunggah konten (misalnya, "").https://powerappsbuildtools.crm.dynamics.com Ditentukan di dalam Sambungan Layanan dalam Pengaturan Proyek menggunakan jenis sambungan Power Platform. |
Environment URL lingkungan target |
(Wajib) URL lingkungan yang ditargetkan tugas ini. |
TrackingId Minta ID pelacakan |
(Wajib) Minta ID pelacakan. |
RequestType Jenis permintaan |
(Wajib) Jenis reqeust. (Nilai: Instal | Kirim). |
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
Alur membangun dan merilis
Sekarang setelah kita mengidentifikasi apa yang dapat dilakukan dengan menggunakan alat Build, mari Lihat bagaimana Anda dapat menerapkan alat ini ke Build dan alur rilis. Ikhtisar konseptual ditunjukkan di bawah ini. Mari lihat beberapa rincian penerapan jalur pipa menggunakan tugas alat Build di sub-bagian yang mengikutinya.
Untuk mempelajari lebih lanjut tentang cara membuat alur ini dan benar-benar melakukan penulisan alur menggunakan Microsoft Power Platform Build Tools, selesaikan build tools labs, yang dapat Anda unduh dari GitHub.
Informasi selengkapnya tentang Azure Pipelines: Menggunakan Azure Pipelines
Buat alur kerja: mengekspor solusi dari lingkungan pengembangan (DEV)
Gambar berikut menunjukkan tugas alat Build yang mungkin Anda tambahkan ke alur yang mengekspor solusi dari lingkungan pengembangan.
Alur build: membangun solusi terkelola
Gambar berikut menunjukkan tugas alat Build yang mungkin Anda tambahkan ke alur yang membangun solusi terkelola.
Alur kerja rilis: menyebarkan ke lingkungan produksi (PROD)
Gambar berikut menunjukkan tugas alat Build yang mungkin Anda tambahkan ke alur yang menyebarkan lingkungan produksi.