Dukungan PowerShell untuk Power Apps dan Power Automate
Dengan cmdlet PowerShell untuk Power Platform pembuat dan administrator, Anda dapat mengotomatiskan banyak tugas pemantauan dan manajemen. Tugas yang hanya mungkin dilakukan secara manual hari ini di Power Apps, Power Automate, atau pusat Power Platform aktivitas.
Cmdlet
Cmdlet adalah fungsi yang ditulis dalam bahasa skrip PowerShell yang menjalankan perintah di PowerShell. Menjalankan cmdlet ini Power Apps memungkinkan Anda berinteraksi dengan Platform Aplikasi Bisnis tanpa harus melalui portal admin di browser web.
Anda dapat menggabungkan cmdlet dengan fungsi PowerShell lainnya untuk menulis skrip kompleks yang dapat mengoptimalkan alur kerja Anda. Anda masih dapat menggunakan cmdlet jika Anda bukan admin di penyewa, tetapi Anda terbatas pada sumber daya yang Anda miliki. Akun pengguna administratif menggunakan cmdlet yang dimulai dengan Admin.
Cmdlet tersedia di Galeri PowerShell sebagai dua modul terpisah:
Untuk informasi tentang modul admin Power Apps, lihat mulai menggunakan modul admin Power Apps dan Microsoft.PowerApps.Administration.PowerShell.
Catatan
Mengenai dukungan Dynamics 365 Government Community Cloud (GCC) level 2:
Titik akhir default adalah "prod". Jika pengguna ingin menjalankan skrip PowerShell yang menargetkan lingkungan GCC, parameter -Endpoint perlu diubah menjadi "usgov" untuk GCC Moderate, atau "usgovhigh" untuk GCC High, atau "dod" untuk GCC DOD.
Add-PowerAppsAccount -Endpoint "usgov"
Mulai menggunakan PowerShell
Jika Anda baru menggunakan PowerShell dan memerlukan bantuan untuk menemukan dan meluncurkannya, buka Memulai PowerShell. Jika Anda memerlukan bantuan untuk menggunakan PowerShell atau cmdlet, buka Sistem Bantuan PowerShell.
Prasyarat
PowerShell dalam artikel ini memerlukan Windows PowerShell versi 5.x. Untuk memeriksa versi PowerShell yang berjalan di komputer, jalankan perintah berikut:
$PSVersionTable.PSVersion
Jika Anda memiliki versi lama, buka Memutakhirkan Windows PowerShell yang ada.
Penting
Modul yang dijelaskan dalam dokumen ini menggunakan .NET Framework, yang tidak kompatibel dengan PowerShell 6.0 dan yang lebih baru. Versi yang lebih baru ini menggunakan .NET Core.
Instalasi modul
Untuk menjalankan cmdlet PowerShell bagi pembuat aplikasi:
Jalankan PowerShell sebagai administrator.
Impor modul yang diperlukan.
Install-Module -Name Microsoft.PowerApps.Administration.PowerShell Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobberAtau, jika Anda tidak memiliki hak admin di komputer Anda, gunakan
-Scope CurrentUserparameter untuk instalasi.Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Scope CurrentUser Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber -Scope CurrentUserJika Anda diminta untuk menerima perubahan pada nilai InstallationPolicy repositori, terima
[A] Yeske semua modul dengan mengetikA, lalu tekanEnteruntuk setiap modul.
Sebelum mengakses perintah, Anda dapat memberikan kredensial menggunakan perintah berikut. Kredensial diperbarui hingga delapan jam sebelum Anda diminta untuk masuk lagi.
# Opens a prompt to collect credentials (Microsoft Entra account and password). Add-PowerAppsAccount# Here is how you can pass in credentials (to avoid opening a prompt). $pass = ConvertTo-SecureString "password" -AsPlainText -Force Add-PowerAppsAccount -Username user@contoso.com -Password $pass
Pembaruan modul
Anda dapat memeriksa versi semua modul PowerShell Anda menggunakan Get-Module.
Get-Module
Dan Anda dapat memperbarui semua modul PowerShell Anda ke yang terbaru menggunakan Update-Module.
Update-Module
Sebagai alternatif, periksa Power Platform versi modul, menggunakan Get-Module dan -Name parameter.
Get-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Get-Module -Name "Microsoft.PowerApps.PowerShell"
Power Platform Perbarui modul PowerShell, menggunakan Update-Module dan -Name parameter.
Update-Module -Name "Microsoft.PowerApps.Administration.PowerShell"
Update-Module -Name "Microsoft.PowerApps.PowerShell"
cmdlet Power Apps untuk pembuat aplikasi
Prasyarat
Pengguna dengan lisensi yang valid Power Apps dapat melakukan operasi dalam cmdlet ini. Namun, mereka hanya memiliki akses ke sumber daya, seperti aplikasi dan alur, yang dibuat atau dibagikan dengan mereka.
Cmdlet pembuat - daftar cmdlet
Catatan
Kami telah memperbarui beberapa nama fungsi cmdlet dalam rilis terbaru untuk menambahkan awalan yang sesuai untuk mencegah tabrakan. Lihat tabel berikut untuk gambaran umum tentang apa yang telah berubah.
| Kegunaan | Cmdlet |
|---|---|
| Menambahkan aplikasi kanvas ke solusi Microsoft Dataverse | Set-PowerAppAsSolutionaware |
| Membaca dan memperbarui lingkungan |
Get-AdminPowerAppEnvironment(sebelumnya Get-PowerAppsEnvironment) Get-FlowEnvironment Restore-PowerAppEnvironment(sebelumnya Restore-AppVersion) |
| Membaca, memperbarui, dan menghapus aplikasi Canvas |
Get-AdminPowerApp(sebelumnya Get-App) Remove-AdminPowerApp(sebelumnya Remove-App) Publish-AdminPowerApp (sebelumnya Publish-App) |
| Membaca, memperbarui, dan izin aplikasi Canvas |
Get-AdminPowerAppRoleAssignment(sebelumnya Get-AppRoleAssignment) Remove-AdminPowerAppRoleAssignment(sebelumnya Remove-AppRoleAssignment) |
| Membaca, memperbarui, dan menghapus alur |
Get-AdminFlow Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow |
| Membaca, memperbarui, dan izin alur |
Get-AdminFlowOwnerRole Set-AdminFlowOwnerRole Remove-AdminFlowOwnerRole |
| Baca dan tanggapi persetujuan alur |
Get-AdminFlowApprovalRequest Remove-AdminFlowApprovals |
| Baca dan hapus koneksi |
Get-AdminPowerAppConnection(sebelumnya Get-Connection) Remove-AdminPowerAppConnection(sebelumnya Remove-Connection) |
| Membaca, memperbarui, dan hapus izin koneksi |
Get-AdminPowerAppConnectionRoleAssignment(sebelumnya Get-ConnectionRoleAssignment) Set-AdminPowerAppConnectionRoleAssignment(sebelumnya Set-ConnectionRoleAssignment) Remove-AdminPowerAppConnectionRoleAssignment(sebelumnya Remove-ConnectionRoleAssignment) |
| Baca dan hapus konektor |
Get-AdminPowerAppConnector(sebelumnya Get-Connector) Remove-AdminPowerAppConnector(sebelumnya Remove-Connector) |
| Menambah, membaca, memperbarui, dan menghapus izin konektor kustom |
Get-AdminPowerAppConnectorRoleAssignment(sebelumnya Get-ConnectorRoleAssignment) Get-PowerAppConnectorRoleAssignment(sebelumnya Set-ConnectorRoleAssignment) Remove-PowerAppConnectorRoleAssignment(sebelumnya Remove-ConnectorRoleAssignment) |
| Membaca, menambahkan, dan menghapus pola URL kebijakan |
Get-PowerAppPolicyUrlPatterns New-PowerAppPolicyUrlPatterns Remove-PowerAppPolicyUrlPatterns |
| Baca, daftar, dan Hapus aplikasi manajemen |
Get-PowerAppManagementApp Get-PowerAppManagementApps New-PowerAppManagementApp Remove-PowerAppManagementApp |
| Baca, buat, pembaruan, dan impor kunci perlindungan |
Get-PowerAppRetrieveAvailableTenantProtectionKeys Get-PowerAppGenerateProtectionKey Get-PowerAppRetrieveTenantProtectionKey New-PowerAppImportProtectionKey Set-PowerAppTenantProtectionKey |
cmdlet Power Apps untuk administrator
Untuk informasi selengkapnya tentang Power Apps dan Power Automate cmdlet untuk admin, lihat Mulai menggunakan PowerShell untuk Power Platform Administrator.
Tips
Gunakan
Get-Helpdiikuti dengan aCmdletNameuntuk mendapatkan daftar contoh.
Setelah Anda mengetik tanda hubung
-, Anda dapat menekanTabuntuk menelusuri tag input. Tempatkan bendera ini setelah nama cmdlet.
Contoh perintah:
Get-Help Get-AdminPowerAppEnvironment
Get-Help Get-AdminPowerAppEnvironment -Examples
Get-Help Get-AdminPowerAppEnvironment -Detailed
Contoh pengoperasian
Berikut adalah beberapa skenario umum yang menunjukkan cara menggunakan cmdlet baru dan yang sudah ada Power Apps .
- Perintah lingkungan
- Perintah Power Apps
- Perintah Power Automate
- Perintah koneksi API
- Perintah kebijakan pencegahan kehilangan data (DLP)
- Cmdlet pengecualian sumber daya DLP
- Perintah izin uji blok
Perintah lingkungan
Gunakan perintah ini untuk mendapatkan rincian dan memperbarui lingkungan di penyewa.
Tampilkan daftar semua lingkungan
Get-AdminPowerAppEnvironment
Mengembalikan daftar setiap lingkungan di seluruh penyewa Anda, dengan detail masing-masing (misalnya, nama lingkungan (guid), nama tampilan, lokasi, pembuat, dan lainnya).
Rincian tampilan lingkungan default Anda
Get-AdminPowerAppEnvironment –Default
Menampilkan rincian hanya lingkungan default penyewa.
Menampilkan rincian lingkungan tertentu
Get-AdminPowerAppEnvironment –EnvironmentName 'EnvironmentName'
Catatan
Bidang EnvironmentName adalah pengidentifikasi unik, yang berbeda dari DisplayName (lihat bidang pertama dan kedua dalam output pada gambar berikut).
Perintah Power Apps
Operasi ini digunakan untuk membaca dan memodifikasi data Power Apps dalam penyewa.
Menampilkan daftar semua Power Apps
Get-AdminPowerApp
Mengembalikan daftar semua Power Apps penyewa, dengan detail masing-masing (misalnya, nama aplikasi (guid), nama tampilan, pembuat, dan lainnya).
Menampilkan daftar semua Power Apps yang sesuai dengan nama tampilan input
Get-AdminPowerApp 'DisplayName'
Perintah ini mencantumkan semua Power Apps penyewa Anda yang cocok dengan nama tampilan.
Catatan
Gunakan kutipan di sekitar nilai input yang berisi spasi. Misalnya, gunakan "Nama Aplikasi Saya".
Menyoroti aplikasi
Set-AdminPowerAppAsFeatured –AppName 'AppName'
Aplikasi unggulan dikelompokkan dan didorong ke bagian atas daftar di pemutar seluler Power Apps.
Catatan
Seperti lingkungan, bidang AppName adalah pengidentifikasi unik, yang berbeda dari DisplayName. Jika anda ingin melakukan operasi berdasarkan nama tampilan, beberapa fungsi akan memungkinkan anda menggunakan alur (lihat fungsi berikutnya).
Membuat aplikasi aplikasi hero, menggunakan alur
Get-AdminPowerApp 'DisplayName' | Set-AdminPowerAppAsHero
Sebuah aplikasi hero muncul di bagian atas daftar di Power Apps pemutar seluler. Hanya boleh satu aplikasi hero.
Karakter pipa | antara dua cmdlet mengambil output dari cmdlet pertama dan meneruskannya sebagai nilai input kedua, jika fungsi ditulis untuk mengakomodasi pipa.
Catatan
Aplikasi harus sudah menjadi aplikasi unggulan sebelum diubah menjadi Pahlawan.
Menampilkan jumlah aplikasi yang dimiliki setiap pengguna
Get-AdminPowerApp | Select –ExpandProperty Owner | Select –ExpandProperty displayname | Group
Anda dapat menggabungkan fungsi PowerShell asli dengan cmdlet Power Apps untuk memanipulasi data lebih jauh. Di sini kita menggunakan fungsi Select untuk mengisolasi atribut pemilik (objek) dari objek Get-AdminApp. Kita kemudian mengisolasi nama dari objek pemilik dengan alur output ke fungsi Select lainnya. Akhirnya, meneruskan output fungsi pilih Select ke fungsi Group mengembalikan tabel bagus yang mencakup hitungan jumlah aplikasi pemilik.
Menampilkan jumlah aplikasi di setiap lingkungan
Get-AdminPowerApp | Select -ExpandProperty EnvironmentName | Group | %{ New-Object -TypeName PSObject -Property @{ DisplayName = (Get-AdminPowerAppEnvironment -EnvironmentName $_.Name | Select -ExpandProperty displayName); Count = $_.Count } }
Unduh Rincian pengguna Power Apps
Get-AdminPowerAppsUserDetails -OutputFilePath '.\adminUserDetails.txt' –UserPrincipalName 'admin@bappartners.onmicrosoft.com'
Perintah di atas menyimpan Power Apps detail pengguna (informasi penggunaan dasar tentang pengguna input melalui nama prinsipal pengguna mereka) dalam file teks yang ditentukan. Ini membuat file baru jika tidak ada file yang ada dengan nama itu, dan menimpa file teks jika sudah ada.
Mengekspor daftar lisensi pengguna yang ditetapkan
Get-AdminPowerAppLicenses -OutputFilePath '<licenses.csv>'
Ekspor semua lisensi pengguna yang ditetapkan (Power Apps dan Power Automate) dalam penyewa Anda menjadi file View.CSV tabular. File yang diekspor berisi layanan mandiri, pendaftaran, rencana uji coba internal, dan paket yang bersumber dari Microsoft Entra ID. Paket uji coba internal tidak dapat dilihat oleh admin di pusat admin Microsoft 365.
Ekspor dapat memakan waktu lama untuk penyewa dengan pengguna Microsoft Power Platform berjumlah besar.
Catatan
Output cmdlet Get-AdminPowerAppLicenses hanya mencakup lisensi untuk pengguna yang telah mengakses layanan Power Platform (misalnya, Power Apps, Power Automate, atau pusat admin Power Platform). Pengguna yang telah memiliki lisensi yang ditetapkan dalam Microsoft Entra ID (biasanya melalui Microsoft 365 pusat admin) tetapi belum pernah mengakses Power Platform layanan tidak akan memiliki lisensi mereka yang disertakan dalam output .csv yang dihasilkan. Selain itu, karena Power Platform layanan lisensi menyimpan lisensi dalam cache, pembaruan yang dilakukan pada penetapan lisensi di Microsoft Entra ID dapat memakan waktu hingga tujuh hari untuk tercermin dalam output bagi pengguna yang belum mengakses layanan baru-baru ini.
Atur pengguna yang masuk sebagai pemilik aplikasi Canvas
Set-AdminPowerAppOwner –AppName 'AppName' -AppOwner $Global:currentSession.userId –EnvironmentName 'EnvironmentName'
Mengubah peran pemilik PowerApp ke pengguna saat ini, dan menggantikan pemilik asli sebagai jenis peran "dapat melihat".
Catatan
Bidang AppName dan EnvironmentName adalah pengidentifikasi unik (guid), bukan nama tampilan.
Menampilkan daftar aplikasi kanvas yang dihapus di lingkungan
Get-AdminDeletedPowerAppsList -EnvironmentName 'EnvironmentName'
Perintah ini menampilkan semua aplikasi kanvas yang baru saja dihapus, karena mungkin masih dipulihkan.
Memulihkan aplikasi Canvas yang telah dihapus
Get-AdminRecoverDeletedPowerApp -AppName 'AppName' -EnvironmentName 'EnvironmentName'
Perintah ini memulihkan aplikasi kanvas yang Get-AdminDeletedPowerAppsList dapat ditemukan melalui cmdlet. Aplikasi kanvas apa pun yang tidak ditampilkan di Get-AdminDeletedPowerAppsList tidak dapat dipulihkan.
Menetapkan lingkungan formulir kustom SharePoint
Cmdlet berikut dapat digunakan untuk menentukan dan memverifikasi formulir kustom SharePoint lingkungan yang disimpan, bukan lingkungan default. Ketika lingkungan yang ditetapkan untuk SharePoint formulir kustom berubah, lingkungan ini adalah tempat formulir kustom yang baru dibuat disimpan. Formulir kustom yang ada tidak secara otomatis bermigrasi ke lingkungan yang berbeda saat cmdlet ini digunakan. Kemampuan pengguna untuk membuat formulir kustom di lingkungan yang ditetapkan mengharuskan pengguna tersebut memiliki peran Pembuat Lingkungan. Pengguna dapat diberi peran Pembuat Lingkungan di pusat admin Power Platform.
Lingkungan apa pun yang bukan lingkungan default dapat dihapus. Jika lingkungan formulir kustom yang ditetapkan SharePoint dihapus, formulir kustom dihapus bersamanya.
Get-AdminPowerAppSharepointFormEnvironment
Perintah ini mengembalikan untuk lingkungan yang saat ini ditetapkan untuk formulir kustom yang EnvironmentName baru dibuat SharePoint . Jika lingkungan belum pernah ditetapkan, lingkungan default akan dihasilkan.
Set-AdminPowerAppSharepointFormEnvironment –EnvironmentName 'EnvironmentName'
Perintah ini menunjuk lingkungan tempat formulir kustom yang baru dibuat SharePoint , bukan lingkungan default. Formulir kustom yang ada tidak secara otomatis bermigrasi ke lingkungan yang baru ditetapkan. Hanya lingkungan produksi yang dapat ditetapkan untuk SharePoint formulir khusus.
Reset-AdminPowerAppSharepointFormEnvironment
Tindakan ini mereset lingkungan default sebagai lingkungan yang ditetapkan untuk menyimpan formulir kustom SharePoint.
Tampilkan pengaturan penyewa untuk kemampuan berbagi aplikasi dengan Semua Orang
$settings = Get-TenantSettings
$settings.PowerPlatform.PowerApps.disableShareWithEveryone
Setelan ini mengontrol apakah pengguna dengan pembuat lingkungan peran keamanan dapat berbagi aplikasi kanvas dengan Semua Orang di organisasi. Bila pengaturan diatur ke true, hanya pengguna dengan peran admin (admin Power Platform Dynamics 365,Admin layanan,Admin Microsoft Entra penyewa) yang dapat berbagi aplikasi dengan Semua Orang di organisasi.
Terlepas dari nilai pengaturan penyewa ini, pembuat dengan hak istimewa berbagi dapat berbagi aplikasi dengan grup keamanan dari berbagai ukuran. Kontrol ini hanya menentukan apakah singkatan Semua Orang dapat digunakan saat berbagi.
Mengubah pengaturan penyewa untuk kemampuan berbagi aplikasi dengan Semua Orang
$settings = Get-TenantSettings
$settings.powerPlatform.powerApps.disableShareWithEveryone = $True
Set-TenantSettings -RequestBody $settings
Tampilkan konten pesan kesalahan tata kelola organisasi Anda
Jika Anda menentukan konten pesan kesalahan tata kelola untuk muncul dalam pesan kesalahan, konten dalam pesan kesalahan ditampilkan saat pembuat mengamati bahwa mereka tidak memiliki izin untuk berbagi aplikasi dengan Semua Orang. Lihat perintah konten pesan kesalahan tata kelola PowerShell.
Mengaitkan alur dalam konteks ke aplikasi
Mengaitkan alur dalam konteks suatu aplikasi ke aplikasi tersebut untuk membuat dependensi antara aplikasi dan alur. Untuk mempelajari lebih lanjut tentang alur konteks, lihat Kemampuan Power Automate apa saja yang disertakan dalam lisensi Power Apps?
Add-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]
EnvironmentName dan FlowName dapat ditemukan dalam URL alur:
Untuk alur Non-Solusi, URL terlihat seperti ini:
https://preview.flow.microsoft.com/manage/environments/839eace6-59ab-4243-97ec-a5b8fcc104e7/flows/6df8ec2d-3a2b-49ef-8e91-942b8be3202t/detailsGUID setelah
environments/adalah EnvironmentName dan GUID setelahflows/adalah FlowNameUntuk alur Solusi, URL terlihat seperti ini:
https://us.flow.microsoft.com/manage/environments/66495a1d-e34e-e330-9baf-0be559e6900b/solutions/fd140aaf-4df4-11dd-bd17-0019b9312238/flows/53d829c4-a5db-4f9f-8ed8-4fb49da69ee1/detailsGUID setelah
environments/adalah EnvironmentName dan GUID setelahflows/adalah FlowNameAppName untuk aplikasi kanvas dapat ditemukan di halaman detail aplikasi kanvas.
AppName untuk aplikasi berbasis model dapat ditemukan di penjelajah solusi.
Untuk melihat contoh, ketik:
get-help Add-AdminFlowPowerAppContext -examples.Untuk mendapatkan informasi lebih lanjut, ketik:
get-help Add-AdminFlowPowerAppContext -detailed.Untuk mendapatkan informasi teknis, ketik:
get-help Add-AdminFlowPowerAppContext -full.
Menghapus alur dalam konteks suatu aplikasi
Gunakan perintah PowerShell ini untuk menghapus dependensi antara alur dan aplikasi. Remove-AdminFlowPowerAppContext akan menghapus konteks aplikasi dari alur tertentu.
Remove-AdminFlowPowerAppContext -EnvironmentName <String> -FlowName <String> -AppName <String> [-ApiVersion <String>] [<CommonParameters>]
- To see the examples, type: "get-help Remove-AdminFlowPowerAppContext -examples".
- For more information, type: "get-help Remove-AdminFlowPowerAppContext -detailed".
- For technical information, type: "get-help Remove-AdminFlowPowerAppContext -full".
Perintah Power Automate
Gunakan perintah penting ini untuk melakukan administrasi yang terkait dengan Power Automate.
Untuk daftar Power Automate lengkap dan Power Apps cmdlet untuk admin, lihat Mulai menggunakan PowerShell untuk Power Platform Administrator.
Menampilkan semua alur
Get-AdminFlow
Menghasilkan daftar semua alur pada penyewa.
Menampilkan Rincian peran pemilik alur
Get-AdminFlowOwnerRole –EnvironmentName 'EnvironmentName' –FlowName 'FlowName'
Menghasilkan rincian detail pemilik alur yang ditentukan.
Catatan
Seperti Lingkungan dan PowerApps, FlowName adalah pengidentifikasi unik (guid), yang berbeda dari nama tampilan aliran.
Menampilkan detail pengguna alur
Get-AdminFlowUserDetails –UserId $Global:currentSession.userId
Menghasilkan rincian pengguna mengenai penggunaan alur. Dalam contoh ini, kami menggunakan ID pengguna dari pengguna sesi PowerShell yang masuk saat ini sebagai input.
Menghapus detail pengguna alur
Remove-AdminFlowUserDetails –UserId 'UserId'
Menghapus rincian pada pengguna alur sepenuhnya dari database Microsoft. Semua alur yang dimiliki pengguna harus dihapus sebelum rincian alur pengguna dapat dibersihkan.
Catatan
Bidang UserId adalah ID Objek rekaman pengguna Microsoft Entra , yang dapat ditemukan di portal Microsoft Azure di bawah Microsoft Entra ID>ID Objek Profil>Pengguna>. Anda harus menjadi admin untuk mengakses data ini dari sini.
Mengekspor semua alur ke file CSV
Get-AdminFlow | Export-Csv -Path '.\FlowExport.csv'
Ekspor semua alur di penyewa Anda ke file tampilan tabular .csv.
Tambahkan alur ke dalam Dataverse solusi
Add-AdminFlowsToSolution -EnvironmentName <String>
Memigrasikan semua aliran nonsolusi di lingkungan.
Variasi parameter dapat digunakan untuk memigrasikan alur tertentu saja, menambahkan ke solusi tertentu, atau hanya memigrasikan sejumlah alur dalam satu waktu.
Untuk detail teknis, lihat Add-AdminFlowsToSolution.
Perintah koneksi API
Lihat dan Kelola sambungan API di penyewa Anda.
Menampilkan semua sambungan asli di lingkungan default
Get-AdminPowerAppEnvironment -Default | Get-AdminPowerAppConnection
Menampilkan daftar semua sambungan API yang Anda miliki di lingkungan default. Koneksi native terdapat pada tab Dataverse>Connections (Koneksi) di Power Apps.
Tampilkan semua konektor kustom dalam penyewa
Get-AdminPowerAppConnector
Menghasilkan daftar semua detail konektor kustom pada penyewa.
Catatan
Get-AdminPowerAppConnector tidak mencantumkan konektor kustom yang ada dalam solusi. Ini adalah batasan yang diketahui.
Perintah kebijakan pencegahan kehilangan data (DLP)
Cmdlet ini mengontrol kebijakan DLP pada penyewa Anda.
Membuat kebijakan DLP
New-DlpPolicy
Membuat kebijakan DLP baru untuk penyewa admin yang masuk.
Mengambil daftar objek DLP
Get-DlpPolicy
Mendapatkan objek kebijakan untuk penyewa admin yang masuk.
Catatan
- Saat melihat kebijakan DLP menggunakan PowerShell, nama tampilan konektor berasal dari saat kebijakan DLP dibuat atau saat konektor terakhir dipindahkan dalam kebijakan. Perubahan baru pada nama tampilan konektor tidak akan tercermin.
- Saat menampilkan kebijakan DLP menggunakan PowerShell, konektor baru dalam grup default yang belum dipindahkan tidak akan dikembalikan.
Untuk kedua masalah yang diketahui ini, solusinya adalah memindahkan konektor yang terpengaruh ke grup lain dalam kebijakan dan kemudian memindahkannya kembali ke grup yang benar. Setelah melakukan ini, masing-masing konektor akan terlihat dengan nama yang benar.
Memperbarui kebijakan DLP
Set-DlpPolicy
Rincian pembaruan kebijakan, seperti nama tampilan kebijakan.
Menghapus kebijakan
Remove-DlpPolicy
Menghapus kebijakan DLP.
Cmdlet pengecualian sumber daya DLP
Cmdlet ini memungkinkan Anda mengecualikan atau membatalkan pengecualian sumber daya tertentu dari kebijakan DLP.
Ambil daftar sumber daya pengecualian yang ada untuk kebijakan DLP
Get-PowerAppDlpPolicyExemptResources -TenantId -PolicyName
Buat daftar sumber daya pengecualian baru untuk kebijakan DLP
New-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -NewDlpPolicyExemptResources
Perbarui daftar sumber daya pengecualian baru untuk kebijakan DLP
Set-PowerAppDlpPolicyExemptResources -TenantId -PolicyName -UpdatedExemptResources
Hapus daftar sumber daya pengecualian baru untuk kebijakan DLP
Remove-PowerAppDlpPolicyExemptResources -TenantId -PolicyName
Untuk mengecualikan sumber daya dari kebijakan DLP, Anda memerlukan informasi berikut:
- ID Penyewa (GUID)
- ID Kebijakan Dilaporkan (GUID)
- ID Sumber Daya (diakhiri dengan GUID)
- Jenis sumber daya
Anda dapat mengambil ID dan jenis sumber daya menggunakan cmdlet PowerShell Get-PowerApp untuk aplikasi dan Get-Flow untuk alur.
Contoh skrip penghapusan
Untuk mengecualikan alur dengan ID f239652e-dd38-4826-a1de-90a2aea584d9 dan aplikasi dengan ID 06002625-7154-4417-996e-21d7a60ad624, kita dapat menjalankan cmdlet berikut:
1. PS D:\> $flow = Get-Flow -FlowName f239652e-dd38-4826-a1de-90a2aea584d9
2. PS D:\> $app = Get-PowerApp -AppName 06002625-7154-4417-996e-21d7a60ad624
3. PS D:\> $exemptFlow = [pscustomobject]@{
4. >> id = $flow.Internal.id
5. >> type = $flow.Internal.type
6. >> }
7. PS D:\> $exemptApp = [pscustomobject]@{
8. >> id = $app.Internal.id
9. >> type = $app.Internal.type
10. >> }
11. PS D:\> $exemptResources = [pscustomobject]@{
12. >> exemptResources = @($exemptFlow, $exemptApp)
13. >> }
14. PS D:\> New-PowerAppDlpPolicyExemptResources -TenantId b1c07da8-2ae2-47e7-91b8-d3418892f507 -PolicyName 65da474a-70aa-4a59-9ae1-65a2bebbf98a -NewDlpPolicyExemptResources $exemptResources
15.
16. exemptResources
17. ---------------
18. {@{id=/providers/Microsoft.ProcessSimple/environments/Default-b1c07da8-2ae2-47e7-91b8-d3418892f507/flows/f239652e-dd38-4826-a1de-90a2aea584d9; type=Microsoft.ProcessSimple/environments/flows}, @{id=/providers/Microsoft.PowerApps/apps/06002625-7154-4417-996e-21d7a60ad..
Pengalaman pembebasan DLP dalam skenario berikut
| # | Skenario | Pengalaman |
|---|---|---|
| 1 | Pengguna meluncurkan aplikasi yang tidak kompatibel dengan DLP tetapi dikecualikan untuk DLP. | Peluncurkan aplikasi tetap berjalan dengan atau tanpa pemberlakuan DLP. |
| 2 | Pembuat menyimpan aplikasi yang tidak kompatibel dengan DLP tetapi dikecualikan untuk DLP | Dengan atau tanpa pembebasan DLP, kepatuhan DLP tidak memblokir operasi penyimpanan aplikasi. Peringatan ketidakpatuhan DLP ditampilkan terlepas dari pengecualian DLP. |
| 3 | Pembuat menyimpan alur yang tidak kompatibel dengan DLP tetapi dikecualikan untuk DLP | Dengan atau tanpa pengecualian DLP, kepatuhan DLP tidak memblokir operasi penyimpanan alur. Peringatan ketidakpatuhan DLP tidak muncul. |
Perintah konten pesan kesalahan tata kelola
Cmdlet berikut dapat mengarahkan pengguna akhir Anda ke materi referensi tata kelola organisasi Anda. Perintah ini mencakup tautkan dokumentasi tata kelola dan kontak tata kelola saat diminta oleh kontrol tata kelola. Misalnya, saat konten pesan kesalahan tata kelola diatur, konten tersebut muncul dalam Power Apps pesan penegakan runtime kebijakan Pencegahan Kehilangan Data.
Atur konten pesan kesalahan tata kelola
New-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{
ErrorMessageDetails = @{
enabled = $True
url = "https://contoso.org/governanceMaterial"
}
ContactDetails= @{
enabled = $True
email = "admin@contoso.com"
}
}
URL pesan kesalahan tata kelola dan email dapat ditampilkan secara independen atau bersama-sama. Anda dapat mengaktifkan atau menonaktifkan pesan kesalahan tata kelola dengan enabled bidang.
Skenario konten pesan kesalahan tata kelola
| # | Skenario | Ketersediaan |
|---|---|---|
| 1 | Pengguna meluncurkan aplikasi yang dibuat menggunakan Power Apps yang tidak kompatibel dengan DLP | Tersedia secara umum |
| 2 | Maker membagikan aplikasi kanvas Power Apps tetapi tidak memiliki hak berbagi | Tersedia secara umum |
| 3 | Maker membagikan Power Apps aplikasi kanvas dengan Semua Orang , tetapi tidak memiliki hak istimewa untuk berbagi dengan Semua Orang | Tersedia secara umum |
| 4 | Pembuat menyimpan aplikasi yang dibuat menggunakan Power Apps yang tidak kompatibel dengan DLP | Tersedia secara umum |
| 5 | Pembuat menyimpan alur Power Automate yang tidak kompatibel dengan DLP | Tersedia secara umum |
| 6 | Pengguna meluncurkan aplikasi tanpa keanggotaan grup keamanan ke grup keamanan yang terkait dengan Dataverse lingkungan | Tersedia secara umum |
Tampilkan konten pesan kesalahan tata kelola
Get-PowerAppDlpErrorSettings -TenantId 'TenantId'
Perbarui konten pesan kesalahan tata kelola
Set-PowerAppDlpErrorSettings -TenantId 'TenantId' -ErrorSettings @{
ErrorMessageDetails = @{
enabled = $True
url = "https://contoso.org/governanceMaterial"
}
ContactDetails= @{
enabled = $True
email = "admin@contoso.com"
}
}
Menerapkan kebijakan DLP untuk melanggar koneksi - lingkungan
Cmdlet ini memungkinkan Anda menerapkan kebijakan DLP untuk melanggar koneksi di tingkat lingkungan atau penyewa.
Menerapkan kebijakan DLP untuk koneksi yang melanggar
Anda dapat menerapkan kebijakan DLP pada koneksi di lingkungan. Memberlakukan menonaktifkan koneksi yang ada yang melanggar kebijakan DLP dan memungkinkan koneksi yang sebelumnya dinonaktifkan yang tidak lagi melanggar kebijakan DLP.
Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName [Environment ID]
Contoh skrip penegakan lingkungan
Start-DLPEnforcementOnConnectionsInEnvironment -EnvironmentName c4a07cd6-cb14-e987-b5a2-a1dd61346963
Menerapkan kebijakan DLP untuk melanggar koneksi - penyewa
Anda dapat menerapkan kebijakan DLP pada koneksi di penyewa. Memberlakukan menonaktifkan koneksi yang ada yang melanggar kebijakan DLP dan memungkinkan koneksi yang sebelumnya dinonaktifkan yang tidak lagi melanggar kebijakan DLP.
Start-DLPEnforcementOnConnectionsInTenant
Perintah izin uji blok
Perintah:
Remove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans
Cmdlet rencana izin yang diizinkan dapat digunakan untuk menambah atau menghapus akses ke jenis izin tertentu dari penyewa. Paket persetujuan "Internal" dapat berupa lisensi uji coba atau paket pengembang yang mana pengguna dapat mendaftar sendiri melalui Power Apps/portal Power Automate/Power Automate untuk desktop. Paket persetujuan "Langganan ad-hoc" atau "Viral" adalah lisensi uji coba yang dapat didaftarkan sendiri oleh pengguna https://signup.microsoft.com. Admin dapat menetapkan pengguna melalui Microsoft Entra ID atau Microsoft 365 portal admin.
Secara default, semua jenis rencana persetujuan diizinkan dalam penyewa. Namun, Power Platform admin mungkin ingin memblokir pengguna agar tidak menetapkan lisensi uji coba sendiri tetapi mempertahankan kemampuan untuk menetapkan lisensi uji coba atas nama pengguna. Aturan ini dapat dicapai dengan Remove-AllowedConsentPlans -Types "Internal" menggunakan perintah dan menonaktifkan pengaturan AllowAdHocSubscriptions di Microsoft Entra ID.
Penting
Saat menggunakan Remove-AllowedConsentPlans, semua paket yang ada dari jenis yang ditentukan dihapus dari semua pengguna di penyewa dan tidak dapat dipulihkan. Perintah ini memblokir semua penugasan masa depan dari jenis itu. Power Platform Jika admin ingin mengaktifkan kembali paket jenis itu, mereka dapat menggunakan Add-AllowedConsentPlans. Jika mereka ingin melihat status rencana persetujuan yang diizinkan saat ini, mereka dapat menggunakan Get-AllowedConsentPlans.
Jika Anda memiliki pertanyaan
Jika Anda memiliki komentar, saran, atau pertanyaan, posting di Administrasi Power Apps Dewan komunitas.
Baca juga
Mulai menggunakan Power Apps modul admin.
Microsoft.PowerApps.Administration.PowerShell
Pratinjau: Ikhtisar Kemampuan program dan Ekstensibilitas
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk