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 Lingkungan Catatan: 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: Pemeriksa solusi: Kumpulan aturan ini sama dengan yang dijalankan dari portal Power Apps pembuat. AppSource: Kumpulan aturan yang diperluas yang digunakan untuk mensertifikasi aplikasi sebelum dapat dipublikasikan AppSource.
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.

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

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.

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 menjadihttps://powerappsbuildtasks0.crm.dynamics.com/.

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.

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.

Lihat Juga

Microsoft Power Platform Alat Pembuatan untuk Azure DevOps