Tutorial: invoegtoepassingen toewijzen aan omgevingen (preview)

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Invoegtoepassingen bieden extra mogelijkheden die Power Apps-, Power Automate-stromen en andere bronnen kunnen gebruiken. Deze mogelijkheden kunnen op omgevingsniveau worden toegewezen in het Power Platform beheercentrum en worden beschikbaar gesteld op basis van eerdere licentieaankopen. Zie Capaciteitsbeheer voor invoegtoepassingen voor meer informatie over het beheer van invoegtoepassingen, rapportage en toegangscontrole.

In deze zelfstudie komen de volgende onderwerpen aan bod:

• Handmatig een invoegtoepassing toewijzen aan een omgeving in het Power Platform beheercentrum.
• Op schaal invoegtoepassingen toewijzen met behulp van PowerShell.
• De toewijzing van een invoegtoepassing ongedaan maken.

Als voorbeeld van dit scenario: een klant die heeft AI Builder-tegoeden en Power Automate per processtromen aangeschaft die invoegtoepassingen kunnen toewijzen aan een omgeving om het gebruik in die omgeving in kaart te brengen.

Belangrijk

Dit is een preview-functie. Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Een invoegtoepassing toewijzen aan een omgeving

Meld u om te beginnen aan als een Power Platform-beheerder en wijs AI Builder-tegoeden toe aan de omgeving waar ze zullen worden gebruikt.

Niet alle invoegtoepassingen zijn beschikbaar in de Power Platform -gebruikersinterface van het beheercentrum. Wanneer nieuwe invoegtoepassingen beschikbaar komen, worden ze vaak eerst aan de oppervlakte gebracht met behulp van API- en programmeertools om feedback van klanten te krijgen voordat ze algemeen beschikbaar worden gemaakt in de gebruikersinterface. Zo'n voorbeeld is de Power Automate per proces-invoegtoepassing, die kan worden toegewezen met behulp van PowerShell, zoals weergegeven in het volgende PowerShell-voorbeeld.

Power Platform Beheercentrum

Wijs handmatig een invoegtoepassing toe vanuit het Power Platform beheercentrum

1. Selecteer in het Power Platform beheercentrum de optie Resources>Capaciteit.

2. Scroll naar beneden naar de sectie Invoegtoepassing en selecteer de koppeling Beheren.

   

3. Selecteer een omgeving en bekijk alle verschillende invoegtoepassingen die u zou kunnen toewijzen. Houd er rekening mee dat u alleen invoegtoepassingen kunt aanpassen voor degenen die u eerder hebt gekocht.

   In dit voorbeeld tellen we 500 op bij AI Builder-tegoeden voor de omgeving

   

4. Selecteer Opslaan.

PowerShell

Een invoegtoepassing toewijzen met behulp van PowerShell

Laad uw PowerShell-console en voer de volgende opdrachten uit om invoegtoepassingen toe te wijzen aan een specifieke omgeving. Selecteer in dit voorbeeld dezelfde omgeving die wordt gebruikt in het handmatige voorbeeld in het Power Platform beheercentrum, maar u kunt verschillende omgevingen zoeken en deze desgewenst lussen. In onderstaand voorbeeld hebben we het nieuwe invoegtoepassingstype PowerAutomatePerProces gebruikt, dat nog niet beschikbaar is in de Power Platform-gebruikersinterface van het beheercentrum.

Zie voor een lijst met alle soorten invoegtoepassingen: Definities: Type externe valuta.

#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

De toewijzing van een invoegtoepassing ongedaan maken

U kunt de toewijzing van een invoegtoepassing ongedaan maken Dit wordt ook vaak gedaan door beheerders die capaciteit willen vrijmaken voor andere doeleinden.

Power Platform Beheercentrum

U maakt een invoegtoepassing ongedaan vanuit het Power Platform beheercentrum

1. Meld u aan bij het Power Platform beheercentrum en selecteer Resources>Capaciteit.
2. Selecteer Beheren in de sectie Invoegtoepassingen.
3. Zoek uw omgeving en verwijder de AI Builder-toewijzing van tegoeden die eerder in dit artikel is toegewezen.
4. Selecteer Opslaan.

PowerShell

Een invoegtoepassing ongedaan maken met behulp van PowerShell

Gebruik het volgende script om de toewijzing van een invoegtoepassing ongedaan te maken. U moet de Omgeving-id wijzigen naar een die past bij uw omgeving.

#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