Bagikan melalui

Tugas Microsoft Power Platform Build Tools

  • Artikel

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 for 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 masing-masing 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@0
  displayName: 'Power Platform Tool Installer'

# Installs specific versions of the Power Platform Build Tools
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@0
  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@0
  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@0
  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 selanjutnya 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 Anda perkenalkan secara tidak sengaja saat membangun solusi Anda.

Cuplikan YAML (Pemeriksa)

# Static analysis check of your solution
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.checker.PowerPlatformChecker@0
  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@0
  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: Perwakilan Layanan dan metode autentikasi 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 geo lain untuk digunakan, misalnya https://japan.api.advisor.powerapps.com. Untuk daftar geografi yang tersedia, lihat Menggunakan Power Platform API Checker.
FileLocation
Lokasi file untuk dianalisis		 Diperlukan saat mereferensikan file dari URL tanda tangan akses bersama (SAS). sasUriFile

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 Power Apps portal pembuat.
  • AppSource: Kumpulan aturan yang diperluas yang digunakan untuk mengesahkan aplikasi sebelum dapat dipublikasikan AppSource.
ErrorLevel
Tingkat kesalahan		 Dikombinasikan dengan kesalahan, parameter ambang menentukan tingkat keparahan kesalahan 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-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@0
  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@0
  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		 Layanan titik akhir Anda ingin mengimpor solusi ke (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		 Layanan titik akhir Anda ingin mengimpor solusi ke (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, $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

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.
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 tidak terkelola.

YAML cuplikan (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 standar untuk daftar lengkap nilai komponen.
SolutionUniqueName
Nama solusi		 Nama solusi yang unik.
AddRequiredComponents
Komponen apa pun yang diperlukan dari solusi lain bergantung pada komponen solusi		 (Opsional) Menunjukkan apakah komponen solusi lain yang diperlukan oleh komponen solusi yang Anda tambahkan juga harus ditambahkan ke solusi tidak terkelola.
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@0
  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@0
  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		 Layanan titik akhir yang ingin Anda tingkatkan 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		 Layanan titik akhir yang ingin Anda tingkatkan 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 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@0
  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@0
  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		 Layanan titik akhir yang ingin Anda tingkatkan 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		 Layanan titik akhir yang ingin Anda tingkatkan 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		 (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 ke (misalnya, $(Build.ArtifactStagingDirectory)$(SolutionName).zip ).

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.
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@0
  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@0
  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@0
  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		 Layanan titik akhir bahwa Anda ingin menghapus 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		 Layanan titik akhir bahwa Anda ingin menghapus 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 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@0
  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		 Layanan titik akhir bahwa Anda ingin mempublikasikan 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		 Layanan titik akhir bahwa Anda ingin mempublikasikan 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@0
  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		 Layanan titik akhir bahwa Anda ingin mengatur 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		 Layanan titik akhir bahwa Anda ingin mengatur 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 Mengatur variabel koneksi

Mengatur variabel BuildTools.* untuk menyediakan akses tugas skrip kustom untuk menggunakan koneksi layanan sebagai satu sumber kebenaran.

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		 Layanan titik akhir 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 hitungan 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
Application Id untuk login		 (Diperlukan untuk nama pengguna/kata sandi) Application Id yang digunakan untuk login (Lihat catatan tambahan di bawah).
RedirectUri
URI pengalihan aplikasi tertentu		 (Diperlukan untuk nama pengguna/kata sandi) Alihkan URI aplikasi yang ditentukan. Diperlukan saat menentukan ID Aplikasi. (Lihat catatan tambahan di bawah).

Catatan

Saat menggunakan jenis autentikasi nama pengguna/kata sandi, Id Aplikasi dan Uri Pengalihan akan diperlukan. Dokumen autentikasi oauth ini berisi penjelasan 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@0
  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		 Layanan titik akhir yang ingin Anda sebarkan paketnya (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		 Layanan titik akhir yang ingin Anda sebarkan paketnya (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 ditetapkan jika lisensi atau kapasitas 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@0
  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@0
  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		 Layanan titik akhir bahwa Anda ingin membuat 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		 Layanan titik akhir bahwa Anda ingin membuat 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 sedang 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@0
  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		 Layanan titik akhir bahwa Anda ingin menghapus 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		 Layanan titik akhir bahwa Anda ingin menghapus 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 tertentu.

YAML cuplikan (AssignUser-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.assign-user.PowerPlatformAssignUser@2
  displayName: 'Power Platform Assign User '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    User: EnvironmentUsername
    Role: 'Environment Maker'
    ApplicationUser: true

Parameter (AssignUser-env)

Parameter 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		 Layanan titik akhir untuk lingkungan yang ingin Anda tetapkan untuk 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
Peran keamanan nama atau ID		 Peran keamanan nama atau ID yang akan ditetapkan ke pengguna.
ApplicationUser
Power Platform Nama pengguna aplikasi		 Menentukan apakah pengguna input adalah pengguna aplikasi (true|false).

Power Platform Setel Ulang Lingkungan

Mengatur ulang lingkungan.

YAML cuplikan (Setel ulang-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		 Layanan titik akhir bahwa Anda ingin mengatur 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		 Layanan titik akhir bahwa Anda ingin mengatur 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@0
  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		 Layanan titik akhir bahwa Anda ingin mencadangkan 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		 Layanan titik akhir bahwa Anda ingin mencadangkan 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@0
  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@0
  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'
    DisableAdminMode: false

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		 Layanan titik akhir 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		 Layanan titik akhir 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.
DisableAdminMode
Menonaktifkan mode Admin		 Apakah akan menonaktifkan mode administrasi (true|false).

Power Platform Pulihkan Lingkungan

Mengembalikan lingkungan ke cadangan yang ditentukan.

YAML cuplikan (Pulihkan-env)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.restore-environment.PowerPlatformRestoreEnvironment@2
  displayName: 'Power Platform Restore Environment '
  inputs:
    PowerPlatformEnvironment: 'My service connection'
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: Build
    TargetEnvironmentUrl: 'https://contoso-test.crm.dynamics.com'
    RestoreLatestBackup: false
    RestoreTimeStamp: '12/01/2022 09:00'
    FriendlyName: 'Contoso Test'

Parameter (Restore-env)

Parameter 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		 Layanan titik akhir 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		 Layanan titik akhir 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
DateTime pencadangan		 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.

YAML cuplikan (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		 Layanan titik akhir 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

Mengimpor data ke lingkungan.

YAML cuplikan (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		 Layanan titik akhir untuk lingkungan yang ingin Anda impor datanya (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 zip terkompresi) file data yang akan 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.

YAML cuplikan (unduh-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 (unduh-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		 Layanan titik akhir 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 diunggah akan menggunakan model data standar (1) atau disempurnakan2(). Nilai defaultnya adalah '1'.

Power Platform Unggah PAPortal

Unggah Power Pages konten situs web ke lingkungan saat ini Dataverse .

YAML cuplikan (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		 Layanan ini titik akhir 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
Mengupload jalur konten		 Jalur dari mana Power Pages konten situs web akan diunggah.
ModelVersion
Model Data Situs		 Menunjukkan apakah data situs yang akan diunggah akan menggunakan model data standar (1) atau disempurnakan2(). Nilai defaultnya adalah '1'.

Katalog untuk Power Platform tugas (pratinjau)

Tugas ini melakukan tindakan terhadap katalog di Power Platform dan menyertakan yang berikut ini.

Catatan

Saat ini, tugas katalog untuk Power Platform adalah 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		 Layanan ini titik akhir 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 target 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
Memeriksa status polling		 (Opsional) Polling untuk memeriksa status permintaan Anda (true|false).

Parameter (katalog-instalasi)

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		 Layanan titik akhir 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 target tugas ini.
CatalogSubmissionFile
File pengiriman katalog		 (Wajib) Tentukan jalur dan nama file dari file pengiriman katalog.
UsePackageSolutionZipFile
Jenis file		 Jenis file: file zip paket atau solusi.
SolutionZipFile
Nama file zip solusi		 Tentukan jalur dan nama file file zip solusi.
PollStatus
Memeriksa status polling		 (Opsional) Polling 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 instal/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		 Layanan titik akhir 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 target tugas ini.
TrackingId
Minta ID pelacakan		 (Wajib) Minta ID pelacakan.
RequestType
Jenis permintaan		 (Wajib) Jenis reqeost. (Nilai: Instal | Kirim).

Parameter (katalog-status)

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.

Ekspor solusi dari lingkungan pengembangan (DEV).

Alur build: membangun solusi terkelola

Gambar berikut menunjukkan tugas alat Build yang mungkin Anda tambahkan ke alur yang membangun solusi terkelola.

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

Sebarkan ke lingkungan produksi (PROD).

Lihat Juga

Microsoft Power Platform Build Tools untuk Azure DevOps