Tutorial: Mengalokasikan add-on ke lingkungan

Add-on menyediakan kemampuan tambahan yang Power Apps, Power Automate alur, dan sumber daya lainnya dapat digunakan. Kemampuan ini dapat ditetapkan di tingkat lingkungan di Power Platform pusat admin dan tersedia berdasarkan pembelian lisensi sebelumnya. Untuk mempelajari selengkapnya tentang manajemen add-on, pelaporan, dan kontrol akses, lihat Manajemen kapasitas add-on.

Dalam tutorial ini, Anda akan belajar untuk:

• Alokasikan add-on secara manual ke lingkungan di Power Platform pusat admin.
• Alokasikan add-on, dalam skala besar, menggunakan PowerShell.
• Batalkan penetapan add-on.

Sebagai contoh skenario ini, pelanggan yang telah membeli AI Builder kredit dan Power Automate alur per Proses dapat menetapkan add-on tersebut ke lingkungan untuk memperhitungkan penggunaan di lingkungan tersebut.

Alokasikan add-on ke lingkungan

Untuk memulai, masuk sebagai Power Platform administrator dan alokasikan AI Builder kredit ke lingkungan tempat kredit tersebut akan digunakan.

Tidak semua add-on tersedia di Power Platform UI pusat admin. Saat add-on baru tersedia, add-on tersebut sering kali muncul pertama kali menggunakan API dan alat pemrograman untuk mendapatkan umpan balik pelanggan sebelum membuatnya lebih tersedia secara umum di UI. Contoh tersebut adalah Power Automate add-on per Proses, yang dapat dialokasikan menggunakan PowerShell, seperti yang ditunjukkan dalam contoh PowerShell berikut.

Petunjuk / Saran

Untuk referensi REST API lengkap, kunjungi Alokasi mata uang.

Power Platform Pusat Admin

Alokasikan add-on secara manual dari Power Platform pusat admin

1. Masuk ke pusat admin Power Platform.

2. Di panel navigasi, pilih Perizinan.

3. Di panel Lisensi , pilih Add-on kapasitas.

4. Pilih tab Add-on .

5. Pilih tautan Kelola .

   

6. Pilih lingkungan dan tinjau semua berbagai add-on yang dapat Anda tetapkan. Ingat bahwa Anda hanya dapat menyesuaikan add-on untuk add-on yang telah Anda beli sebelumnya.

   Dalam contoh ini, kami menambahkan 500 AI Builder kredit ke lingkungan.

   

7. Pilih Simpan.

Power Automate / Logic Apps

Mengalokasikan add-on menggunakan alur Power Automate atau Logic Apps

Tambahkan tindakan baru ke kanvas, mencari "Alokasikan dan batalkan alokasi mata uang untuk lingkungan". Atur parameter ke nilai numerik yang lebih tinggi untuk melakukan penugasan.

PowerShell

Alokasikan add-on menggunakan PowerShell

Muat konsol PowerShell Anda dan jalankan perintah berikut untuk mengalokasikan add-on ke lingkungan tertentu. Dalam contoh ini, pilih lingkungan yang sama yang digunakan dalam contoh manual di Power Platform pusat admin, tetapi Anda dapat mengkueri beberapa lingkungan dan mengulangi masing-masing lingkungan, sesuai kebutuhan. Dalam contoh di bawah ini, kami menggunakan jenis add-on PowerAutomatePerProcess baru , yang belum tersedia di Power Platform UI pusat admin.

Untuk daftar semua jenis add-on, lihat Definisi: Jenis Mata Uang Eksternal.

#Install the module
Install-Module -Name Az.Accounts

# Set variables for your session
$TenantId = "YOUR_TENANT_GUID_FROM_Microsoft Entra ID"
$EnvironmentId = "YOUR_POWER_PLATFORM_ENVIRONMENT_ID_HERE"

Write-Host "Creating a session against the Power Platform API"

Connect-AzAccount
$AccessToken = Get-AzAccessToken -TenantId $TenantId -ResourceUrl "https://api.powerplatform.com/"

$headers = @{ 'Authorization' = 'Bearer '+$AccessToken.Token }
$headers.Add('Content-Type', 'application/json')

$patchRequestBody =  "{`"currencyAllocations`": `"[{currencyType: `"PowerAutomatePerProcess`", allocated:1}]`" }"

Write-Host "Calling patch to adjust add-on allocations..."

$patchRequestResponse = Invoke-RestMethod -Method Patch -Uri "https://api.powerplatform.com/licensing/environments/$EnvironmentId/allocations?api-version=2022-03-01-preview" 
-Headers $headers -Body $patchRequestBody

$patchRequestResponse

Referensi API Power Platform: Alokasi Mata Uang - Alokasi Mata Uang Patch Berdasarkan Lingkungan

Batalkan penetapan add-on

Anda dapat membatalkan penetapan add-on. Ini juga biasanya dilakukan oleh admin yang ingin merebut kembali kapasitas untuk tujuan lain.

Power Platform Pusat Admin

Batalkan penetapan add-on dari Power Platform pusat admin

1. Masuk ke pusat admin Power Platform.
2. Di panel navigasi, pilih Perizinan.
3. Di panel Lisensi , pilih Add-on kapasitas.
4. Pilih Kelola di bagian Add-on .
5. Temukan lingkungan Anda dan hapus AI Builder alokasi kredit yang ditetapkan sebelumnya dalam artikel ini.
6. Pilih Simpan.

Power Automate / Logic Apps

Membatalkan penjagaan add-on menggunakan alur Power Automate atau Logic Apps

Tambahkan tindakan baru ke kanvas, mencari "Alokasikan dan batalkan alokasi mata uang untuk lingkungan". Atur parameter ke nilai numerik yang lebih rendah untuk melakukan pembatalan penetapan.

PowerShell

Batalkan penetapan add-on menggunakan PowerShell

Gunakan skrip berikut untuk membatalkan penetapan add-on. Anda harus mengubah environmentID menjadi salah satu yang cocok dengan lingkungan Anda.

#Install the module
Install-Module -Name Az.Accounts

# Set variables for your session
$TenantId = "YOUR_TENANT_GUID_FROM_Microsoft Entra ID"
$EnvironmentId = "YOUR_POWER_PLATFORM_ENVIRONMENT_ID_HERE"

Write-Host "Creating a session against the Power Platform API"

Connect-AzAccount
$AccessToken = Get-AzAccessToken -TenantId $TenantId -ResourceUrl "https://api.powerplatform.com/"

$headers = @{ 'Authorization' = 'Bearer '+$AccessToken.Token }
$headers.Add('Content-Type', 'application/json')

$patchRequestBody =  "{`"currencyAllocations`": `"[{currencyType: `"PowerAutomatePerProcess`", allocated:0}]`" }"

Write-Host "Calling patch to adjust add-on allocations..."

$patchRequestResponse = Invoke-RestMethod -Method Patch -Uri "https://api.powerplatform.com/licensing/environments/$EnvironmentId/allocations?api-version=2022-03-01-preview" 
-Headers $headers -Body $patchRequestBody

$patchRequestResponse

Referensi API Power Platform: Alokasi Mata Uang - Alokasi Mata Uang Patch Berdasarkan Lingkungan