Tugas Microsoft Power Platform Build Tools

Tugas Build yang tersedia dijelaskan di bagian berikut. Setelah itu, kami menampilkan beberapa contoh Azure Pipelines memanfaatkan tugas-tugas ini. Untuk informasi tentang alat build dan cara mengunduhnya, lihat Microsoft Power Platform Build Tools for Azure Pipelines.

Tugas pembantu

Tugas penolong yang tersedia akan dijelaskan berikutnya.

Power Platform Installer Alat

Tugas ini diperlukan untuk ditambahkan satu kali sebelum tugas Power Platform Build Tools lainnya di alur bangun dan rilis. Tugas ini menginstal sekumpulan alat khusus Power Platform yang diperlukan oleh agen untuk menjalankan tugas build Microsoft Power Platform. Tugas ini tidak memerlukan konfigurasi tambahan 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 default Power Platform Build Tools and adds the pac cli to the `PATH` environment variable
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.tool-installer.PowerPlatformToolInstaller@2
  displayName: 'Power Platform Tool Installer'
  inputs:
    AddToolsToPath: true

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

Parameter (Penginstal)

Parameters Deskripsi
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.
AddToolsToPath
Tambahkan Alat ke Path		 Menambahkan pac cli ke PATH variabel lingkungan. Memungkinkan Anda menggunakan pac cli dari tugas skrip tanpa perlu menyiapkan jalur secara manual.
PowerAppsAdminVersion
XrmToolingPackageDeploymentVersion
MicrosoftPowerAppsCheckerVersion
CrmSdkCoreToolsVersion
Versi alat		 Versi alat yang spesifik untuk digunakan.

Power Platform SiapaSaya

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)

Parameters Deskripsi
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 Lingkungan Buat Power Platform
PowerPlatformEnvironment
Power Platform URL lingkungan		 Layanan titik akhir untuk lingkungan yang ingin dihubungkan. Ditentukan dalam sambungan layanan di pengaturan proyek. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Layanan titik akhir untuk lingkungan yang ingin dihubungkan. Ditentukan dalam sambungan layanan di pengaturan proyek.

Pemeriksaan kualitas

Di bagian berikutnya tersedia tugas untuk memeriksa kualitas solusi.

Pemeriksa Power Platform

Tugas ini menjalankan pemeriksaan analisis statis atas solusi Anda terhadap sekumpulan aturan praktik terbaik untuk mengidentifikasi pola bermasalah yang mungkin dimasukkan secara tidak disengaja saat membuat solusi.

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)

Parameters Deskripsi
PowerPlatformSPN
Sambungan Layanan		 (Diperlukan) Koneksi ke lingkungan Microsoft Power Platform berlisensi diperlukan untuk menggunakan pemeriksa Power Platform. Koneksi layanan ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi selengkapnya: lihat BuildTools.EnvironmentUrl di bawah Lingkungan Buat Power Platform

Catatan: Prinsipal Layanan dan metode autentikasi nama pengguna/kata sandi tersedia untuk tugas pemeriksa. Untuk informasi selengkapnya tentang cara mengonfigurasi prinsipal layanan yang akan digunakan dengan tugas ini, lihat Mengonfigurasi koneksi prinsipal layanan untuk lingkungan Power Platform.
UseDefaultPACheckerEndpoint
Gunakan titik akhir Pemeriksa Power Platform default		 Secara default (benar), lokasi geografi layanan pemeriksa akan menggunakan geografi yang sama dengan lingkungan yang Anda hubungkan.
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 API Pemeriksa Power Platform.
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 bila file SAS tidak analisis. 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: Seperangkat aturan ini sama dengan yang dijalankan dari portal Power Apps maker.
  • Marketplace: Seperangkat aturan yang diperluas yang digunakan untuk mensertifikasi aplikasi sebelum dapat diterbitkan ke Marketplace.
ErrorLevel
Tingkat kesalahan		 Dikombinasikan dengan kesalahan, parameter ambang batas 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 benar, gagal jika analisis Power Apps Checker memberikan hasil sebagai Gagal atau FinishedWithErrors.
ArtifactDestinationName
Nama artefak DevOps		 Tentukan nama Azure Artifacts untuk file pemeriksa .sarif.

Tugas solusi

Rangkaian tugas ini dapat mengotomatisasi tindakan solusi. Tugas lingkungan yang diuraikan nanti di bagian ini yang membuat, menyalin, atau memulihkan lingkungan akan menimpa koneksi layanan dengan lingkungan yang baru dibuat. Tugas ini memungkinkan untuk mengerjakan tugas solusi terhadap lingkungan yang dibuat saat diminta.

Solusi Impor 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

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang Anda inginkan untuk mengimpor solusi ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang Anda inginkan untuk mengimpor solusi ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
SolutionInputFile
File input solusi		 (Diperlukan) Jalur dan nama file dari file .zip solusi untuk diimpor ke lingkungan target (misalnya $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Catatan: Variabel memberi Anda cara mudah untuk mendapatkan bit 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 di Dataverse, namun tidak memutakhirkan solusi hingga tugas Terapkan Pemutakhiran 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		 Usang. Sistem akan mengonversi komponen solusi yang tidak dikelola menjadi terkelola saat Anda mengimpor solusi terkelola.
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; defaultnya adalah 60 menit (1 jam), sama dengan Azure DevOps default 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.

Komponen Tambahkan Solusi Power Platform

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 (Tambah)

Parameters Deskripsi
ComponentId
ID komponen solusi		 Nama skema atau ID komponen untuk ditambahkan ke solusi target.
ComponentType
Power Platform URL lingkungan		 Nilai yang mewakili komponen solusi yang Anda tambahkan. Lihat Menggunakan jenis komponen yang telah ditentukan untuk daftar lengkap nilai komponen.
SolutionUniqueName
Nama solusi		 Nama unik solusi ini.
AddRequiredComponents
Setiap komponen yang diperlukan dari solusi lain tergantung pada komponen solusi tersebut		 (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 atau ID lingkungan dari 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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang Anda inginkan untuk memutakhirkan solusi ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang Anda inginkan untuk memutakhirkan solusi ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat 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; defaultnya adalah 60 menit (1 jam), sama dengan Azure DevOps default untuk tugas.

Note

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 koneksi dan variabel lingkungan untuk penyebaran otomatis

Solusi Ekspor 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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang Anda inginkan untuk memutakhirkan solusi ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang Anda inginkan untuk memutakhirkan solusi ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
SolutionName
Nama solusi		 (Diperlukan) Nama solusi yang akan diekspor. Selalu gunakan nama solusi, bukan nama tampilannya.
SolutionOutputFile
File output solusi		 (Diperlukan) Jalur dan nama file dari file solution.zip untuk mengekspor lingkungan sumber ke (misalnya $(Build.ArtifactStagingDirectory)$(SolutionName).zip).

Catatan: Variabel memberi Anda cara mudah untuk mendapatkan bit 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; defaultnya adalah 60 menit (1 jam), sama dengan Azure DevOps default 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)

Parameters Deskripsi
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)

Parameters Deskripsi
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.

Solusi Hapus Power Platform

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda hapus solusinya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda hapus solusinya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
SolutionName
Nama solusi		 (Wajib) Nama solusi yang akan dihapus. Selalu gunakan nama solusi, bukan nama tampilannya.

Kustomisasi Publikasi 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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda publikasikan kustomisasinya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda publikasikan kustomisasinya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform

Versi Set Solusi 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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda atur versi solusinya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda atur versi solusinya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat 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 dikodekan secara permanen dalam alur, disarankan untuk menggunakan 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 pengodean keras 20200824.0.0.2.

Selain itu, 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"), Set Versi Solusi sebagai $(SolutionVersion).

Variabel Atur Koneksi Power Platform

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

Variabel berikut diatur:

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

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda atur variabel koneksinya. Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
timeoutInMinutes
Jeda Waktu		 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 untuk digunakan login (Lihat catatan tambahan di bawah).
RedirectUri
Mengalihkan URI aplikasi tertentu		 (Diperlukan untuk nama pengguna/kata sandi) Pengalihan URI dari aplikasi yang ditentukan. Diperlukan saat menentukan Id Aplikasi (Lihat catatan tambahan di bawah).

Note

Saat menggunakan jenis autentikasi nama pengguna/kata sandi, Id Aplikasi dan Uri Pengalihan akan diperlukan. Dokumen authenticate oauth ini memiliki penjelasan mengapa Anda perlu membuat pendaftaran aplikasi untuk diautentikasi dengan Dataverse. Saat Anda terhubung menggunakan autentikasi nama pengguna/kata sandi, koneksi berperilaku sebagai aplikasi yang terhubung atas nama pengguna ke Dataverse.

Sebarkan Paket Power Platform

Menerapkan paket ke lingkungan. Menyebarkan paket sebagai lawan satu file solusi memberikan pilihan untuk menyebarkan beberapa solusi, data, dan kode ke lingkungan.

Cuplikan YAML (Sebarkan)

steps:
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.deploy-package.PowerPlatformDeployPackage@2
  displayName: 'Power Platform Deploy Package '
  inputs:
    authenticationType: PowerPlatformSPN
    PowerPlatformSPN: 'Dataverse service connection '
    PackageFile: 'C:\Users\Public\package.dll'
    MaxAsyncWaitTime: 120

Parameter (Sebarkan)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda sebarkan paketnya ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat Power Platform
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda sebarkan paketnya ke (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform. Informasi lebih lanjut: lihat BuildTools.EnvironmentUrl di Lingkungan Buat 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; defaultnya adalah 60 menit (1 jam), sama dengan Azure DevOps default untuk tugas.

Tugas manajemen lingkungan

Mengotomatisasi tugas manajemen siklus hidup lingkungan umum (ELM).

Lingkungan Buat Power Platform

Membuat Lingkungan baru. Membuat lingkungan baru juga secara otomatis membuat BuildTools.EnvironmentUrl.

Important

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.

Sebuah lingkungan baru hanya dapat disediakan jika lisensi atau kapasitas Anda memungkinkan pembuatan lingkungan tambahan. Untuk informasi lebih lanjut tentang cara melihat kapasitas Lihat rincian halaman kapasitas.

Cuplikan YAML (buat lingkungan)

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

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

Parameter (Buat lingkungan)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda buat lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda buat lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi 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
Apps		 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 masukkan nama domain yang sudah digunakan, tugas akan menambahkan nilai numerik ke nama domain, dimulai dengan 0. Untuk contoh di atas, URL mungkin menjadi https://powerappsbuildtasks0.crm.dynamics.com/.

Power Platform Hapus 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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda hapus lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda hapus lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi 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 (AssignUser-env)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda tetapkan penggunaannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
User
Power Platform nama pengguna		 Nama utama pengguna atau ID objek Microsoft Entra 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 (benar|salah).

Power Platform Atur 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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda atur ulang lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda atur ulang lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.

Power Platform Cadangkan Lingkungan

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan yang ingin Anda cadangkan lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan yang ingin Anda cadangkan lingkungannya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
BackupLabel
Label cadangan		 (Wajib) Label yang akan ditetapkan ke cadangan.

Power Platform Salin Lingkungan

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

Parameter (Salin lingkungan)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan untuk lingkungan sumber yang ingin Anda salin (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan sumber yang ingin Anda salin (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi 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 ramah pengguna		 Nama panggilan lingkungan target.
SkipAuditData
SkipAuditData		 Apakah akan melewati data audit selama operasi penyalinan. (benar|salah).
MaxAsyncWaitTime
Waktu tunggu maksimum		 Waktu tunggu maksimum dalam menit untuk operasi asinkron; defaultnya adalah 60 menit (1 jam), sama dengan Azure DevOps default untuk tugas.

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 (Restore-env)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformEnvironment
Power Platform URL lingkungan		 Titik akhir layanan untuk lingkungan sumber yang ingin Anda pulihkan (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan sumber yang ingin Anda pulihkan (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
RestoreLatestBackup
Cadangan terbaru untuk dipulihkan		 Apakah akan memulihkan cadangan terbaru atau memberikan RestoreTimeStamp (benar|salah).
RestoreTimeStamp
TanggalWaktu pencadangan		 TanggalWaktu pencadangan dalam format 'bb/hh/tttt jj:mm' ATAU string 'terbaru'.
TargetEnvironmentUrl
URL lingkungan target		 (Diperlukan) URL untuk lingkungan target yang akan Anda pulihkan.
FriendlyName
Nama lingkungan yang dipulihkan		 (Opsional) Nama lingkungan yang dipulihkan.
DisableAdminMode
Menonaktifkan mode Admin		 Apakah akan menonaktifkan mode administrasi (true|false).

Ekspor Data Dataverse

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda ekspor datanya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
SchemaFile
Nama file XML skema		 Nama file XML skema. Ini dapat dibuat menggunakan Configuration Migration tool.
DataFile
Nama file data		 Nama file untuk data yang akan diekspor (file zip).
Overwrite
Timpa konten		 Konten situs web Power Pages untuk ditimpa (benar|salah).

Impor Data Dataverse

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda impor datanya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi 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.

Tugas Manajemen Power Pages

Tugas untuk bekerja dengan situs web Power Pages.

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan sumber yang ingin Anda unduh kontennya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
WebsiteId
ID situs web portal		 ID situs web Power Pages untuk diunduh.
Overwrite
Timpa konten		 Konten situs web Power Pages untuk ditimpa (benar|salah).
ModelVersion
Model Data Situs		 Menunjukkan apakah data situs yang akan diunggah akan menggunakan (1) or model data stAndar yang ditingkatkan (2). Nilai default adalah '1'.

Power Platform Unggah PAPortal

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

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)

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda unggah kontennya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
UploadPath
Jalur unggah konten		 Jalur dari tempat konten situs web Power Pages akan diunggah.
ModelVersion
Model Data Situs		 Menunjukkan apakah data situs yang akan diunggah akan menggunakan (1) or model data stAndar yang ditingkatkan (2). Nilai default adalah '1'.

Katalog untuk tugas Power Platform (pratinjau)

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

Note

Saat ini, tugas katalog untuk Power Platform adalah rilis pratinjau.

Menginstal item katalog

Menginstal item katalog ke lingkungan target.

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda unggah kontennya (misalnya, https://powerappsbuildtools.crm.dynamics.com). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
Environment
URL lingkungan target		 (Diperlukan) Url lingkungan yang ditargetkan tugas ini.
CatalogItemId
ID Item Katalog yang akan diinstal		 (Diperlukan) Item katalog yang akan diinstal pada lingkungan target.
TargetEnvironmentUrl
URL lingkungan target		 (Diperlukan) Url lingkungan target untuk penginstalan item katalog (misalnya, "https://YourOrg.crm.dynamics.com").
PollStatus
Memeriksa status jajak pendapat		 (Opsional) Jajak pendapat untuk memeriksa status permintaan Anda (benar|salah).

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.

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda unggah kontennya (misalnya, "https://powerappsbuildtools.crm.dynamics.com"). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
Environment
URL lingkungan target		 (Diperlukan) Url lingkungan yang ditargetkan tugas ini.
CatalogSubmissionFile
File pengiriman katalog		 (Diperlukan) Tentukan jalur dan nama file dari file pengiriman katalog.
UsePackageSolutionZipFile
Jenis file		 Jenis file: paket atau file zip solusi.
SolutionZipFile
Nama file zip solusi		 Tentukan jalur dan nama file dari file zip solusi.
PollStatus
Memeriksa status jajak pendapat		 (Opsional) Jajak pendapat untuk memeriksa status permintaan Anda (benar|salah).

Parameter (catalog-submit)

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.

Parameters Deskripsi
authenticationType
Jenis autentikasi		 (diperlukan untuk SPN) Tentukan PowerPlatformEnvironment untuk sambungan nama pengguna/sandi atau PowerPlatformSPN untuk sambungan rahasia klien/prinsipal layanan.
PowerPlatformSPN
Power Platform Prinsipal Layanan		 Titik akhir layanan untuk lingkungan yang ingin Anda unggah kontennya (misalnya, "https://powerappsbuildtools.crm.dynamics.com"). Ditentukan dalam Koneksi Layanan di Pengaturan Proyek menggunakan jenis koneksi Power Platform.
Environment
URL lingkungan target		 (Diperlukan) Url lingkungan yang ditargetkan tugas ini.
TrackingId
ID pelacakan permintaan		 (Diperlukan) ID pelacakan permintaan.
RequestType
Jenis permintaan		 (Diperlukan) Jenis permintaan. (Nilai: Instal | Kirim).

Parameter (catalog-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 selengkapnya tentang membuat alur ini dan benar-benar melakukan penulisan alur langsung menggunakan Microsoft Power Platform Build Tools, selesaikan lab alat build, yang dapat Anda unduh dari GitHub.

Informasi selengkapnya tentang Azure Pipelines: Gunakan 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.

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

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.

Sebarkan ke lingkungan produksi (PROD).

Lihat Juga

Microsoft Power Platform Build Tools untuk Azure DevOps

  • Last updated on