Tutorial: Add-Ons an Umgebungen zuweisen (Vorschauversion)

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Add-Ons bieten zusätzliche Funktionen, die Power Apps, Power Automate Flows und andere Ressourcen nutzen können. Diese Funktionen können auf Umgebungsebene im Power Platform Admin Center zugewiesen werden und werden auf der Grundlage vorheriger Lizenzkäufe zur Verfügung gestellt. Weitere Informationen zur Add-On-Verwaltung, Berichterstellung und Zugriffssteuerung finden Sie unter Add-On-Kapazitätsverwaltung.

In diesem Tutorial erhalten Sie Informationen zu Folgendem:

• Einer Umgebung im Power Platform Admin Center manuell ein Add-On zuweisen.
• Add-Ons mithilfe von PowerShell im großen Stil zuweisen.
• Die Zuweisung eines Add-Ons aufheben.

In diesem Szenario wurde als Beispiel AI Builder Gutschriften und Power Automate-Pro-Prozessflows erworben und diese Add-Ons können jetzt einer Umgebung zugewiesen werden, um die Nutzung in dieser Umgebung zu berücksichtigen.

Wichtig

Dies ist eine Vorschauversion. Funktionen in der Vorschauversion sind nicht für den produktiven Einsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen stehen vor der offiziellen Veröffentlichung zur Verfügung, damit Kunden frühzeitig Zugriff erhalten und Feedback geben können.

Ein Add-On einer Umgebung zuordnen

Melden Sie sich zunächst als Power Platform Administrierender an und weisen Sie der Umgebung, in der die Add-Ons verwendet werden sollen, AI Builder Gutschriften zu.

Nicht alle Add-Ons sind in der Power Platform Admin Center-Benutzeroberfläche verfügbar. Wenn neue Add-Ons verfügbar werden, werden sie häufig zunächst mithilfe von API- und Programmiertools angezeigt, um Kundenfeedback einzuholen, bevor sie allgemein über die Benutzeroberfläche zur Verfügung gestellt werden. Ein solches Beispiel ist das Power Automate-Pro-Prozess-Add-On, das mithilfe von PowerShell zugewiesen werden kann, wie im folgenden PowerShell-Beispiel gezeigt.

Power Platform Admin-Center

Ein Add-On manuell über das Power Platform Admin Center zuweisen

1. Wählen Sie im Power Platform Admin Center Ressourcen>Kapazität aus.

2. Scrollen Sie nach unten zum Abschnitt Add-Ons und wählen Sie den Link Verwalten aus.

   

3. Wählen Sie eine Umgebung aus und sehen Sie sich die verschiedenen Add-Ons an, die Sie zuweisen können. Beachten Sie, dass Sie nur Add-Ons anpassen können, die Sie zuvor erworben haben.

   In diesem Beispiel fügen wir der Umgebung 500 AI Builder Gutschriften hinzu.

   

4. Wählen Sie Speichern.

PowerShell

Ein Add-Ons mithilfe von PowerShell zuordnen

Laden Sie Ihre PowerShell-Konsole und führen Sie die folgenden Befehle aus, um Add-Ons einer bestimmten Umgebung zuzuordnen. Wählen Sie in diesem Beispiel dieselbe Umgebung aus, die im manuellen Beispiel im Power Platform Admin Center verwendet wird, aber Sie können nach Bedarf mehrere Umgebungen abfragen und jede einzelne durchlaufen. Im folgenden Beispiel haben wir den neuen Add-On-Typ PowerAutomatePerProcess verwendet, der noch nicht in der Power Platform Admin Center-Benutzeroberfläche verfügbar ist.

Eine Liste aller Add-On-Typen finden Sie unter Definitionen: Externer Währungstyp.

#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

Die Zuweisung eines Add-Ons aufheben

Sie können die Zuweisung eines Add-Ons aufheben. Dies wird häufig auch von Administrierenden durchgeführt, die Kapazitäten für andere Zwecke zurückgewinnen möchten.

Power Platform Admin-Center

Die Zuweisung eines Add-Ons über das Power Platform Admin Center aufheben

1. Melden Sie sich im Power Platform Admin Center an und wählen Sie Ressourcen>Kapazität aus.
2. Wählen Sie im Abschnitt Add-OnVerwalten aus.
3. Finden Sie Ihre Umgebung und entfernen Sie die AI Builder Gutschriftenzuweisung, die Sie weiter oben in diesem Artikel zugewiesen haben.
4. Wählen Sie Speichern.

PowerShell

Die Zuordnung eines Add-Ons mithilfe von PowerShell aufheben

Verwenden Sie das folgende Skript, um die Zuordnung eines Add-Ons aufzuheben. Sie müssen die Umgebungs-ID auf eine ändern, die zu Ihrer Umgebung passt.

#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