Tutorial: Mengalokasikan add-on ke lingkungan (pratinjau)

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Add-on menyediakan kemampuan ekstra yang Power Apps, aliran, Power Automate 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 per alur Proses dapat menetapkan add-on tersebut ke lingkungan untuk memperhitungkan penggunaan di lingkungan tersebut.

Penting

Ini adalah fitur pratinjau. Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas terbatas. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.

Mengalokasikan add-on ke lingkungan

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

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

Power Platform Pusat admin

Mengalokasikan add-on secara manual dari Power Platform pusat admin

1. Power Platform Di pusat admin, pilih Kapasitas Sumber> Daya.

2. Gulir ke bawah ke bagian Add-on dan pilih tautan Kelola .

   

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

   

4. Pilih Simpan.

PowerShell

Mengalokasikan 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 bisa membuat kueri untuk beberapa lingkungan dan mengulang masing-masing lingkungan, sesuai kebutuhan. Pada contoh di bawah ini, kami menggunakan jenis add-on PowerAutomatePerProcess baru , yang belum tersedia di Power Platform UI pusat admin.

Untuk daftar semua tipe add-on, lihat Definisi: Tipe 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

Membatalkan penetapan add-on

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

Power Platform Pusat admin

Menghapus penetapan add-on dari Power Platform pusat admin

1. Masuk ke Power Platform pusat admin dan pilih Kapasitas Sumber> Daya.
2. Pilih Kelola di bagian Add-on .
3. Temukan lingkungan Anda dan hapus AI Builder alokasi kredit yang ditetapkan sebelumnya dalam artikel ini.
4. Pilih Simpan.

PowerShell

Menghapus penetapan add-on menggunakan PowerShell

Gunakan skrip berikut untuk menghapus penetapan add-on. Anda harus mengubah environmentID menjadi 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