Samouczek: przydzielanie dodatków do środowisk (wersja zapoznawcza)

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Dodatki zapewniają dodatkowe możliwości, z których może korzystać usługa Power Apps, przepływy Power Automate i inne zasoby. Te funkcje można przypisać na poziomie środowiska w centrum administracyjnym Power Platform i są dostępne na podstawie wcześniejszych zakupów licencji. Aby dowiedzieć się więcej o zarządzaniu dodatkami, raportowaniem i kontrolą dostępu, zobacz Zarządzanie pojemnością dodatków.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

• Ręczne przydzielanie dodatku do środowiska w centrum administracyjnym Power Platform.
• Alokowanie dodatków na dużą skalę przy użyciu programu PowerShell.
• Cofanie przydziału dodatku.

W przykładzie tego scenariusza klient, który zakupił kredyty AI Builder i przepływy Power Automate na proces, może przypisać te dodatki do środowiska, aby uwzględniać użycie tego środowiska.

Ważne

Jest to funkcja w wersji zapoznawczej. Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Przydzielanie dodatku do środowiska

Zacznij od zalogowania się jako administrator Power Platform i przydzielenia kredytów AI Builder do środowiska, w którym zostaną one użyte.

Nie wszystkie dodatki są dostępne w interfejsie użytkownika centrum administracyjnego Power Platform. Wraz z pojawianiem się nowych dodatków są one często najpierw dostępne za pomocą interfejsów API i narzędzi do programowania, co pozwala im otrzymać opinie klientów przed bardziej ogólnym wprowadzeniem w interfejsie użytkownika. Taki przykład to dodatek Power Automate na proces, który można przydzielić przy użyciu programu PowerShell, jak pokazano w poniższym przykładzie programu PowerShell.

Power Platform Centrum administracyjne

Ręczne przydzielanie dodatku z centrum administracyjnego Power Platform

1. W centrum administracyjnym Power Platform wybierz Zasoby>Pojemność.

2. Przewiń w dół do sekcji Dodatki i wybierz link Zarządzaj.

   

3. Wybierz środowisko i przejrzyj wszystkie dodatki, które można przypisać. Należy pamiętać, że można dostosowywać tylko te dodatki, które zostały wcześniej zakupione.

   W tym przykładzie dodamy 500 kredytów AI Builder do środowiska.

   

4. Wybierz pozycję Zapisz.

Program PowerShell

Alokowanie dodatku na przy użyciu programu PowerShell

Załaduj konsolę programu PowerShell i wykonaj następujące polecenia, aby zaalokować dodatki do określonego środowiska. W tym przykładzie wybierz to samo środowisko, które zostało użyte w przykładzie ręcznym w centrum administracyjnym Power Platform, ale można utworzyć zapytanie dotyczące kilku środowisk i w razie potrzeby zastosować pętlę w poszczególnych środowiskach. W poniższym przykładzie użyty został typ dodatku PowerAutomatePerProcess, który nie jest jeszcze dostępny w interfejsie użytkownika centrum administracyjnego Power Platform.

Aby uzyskać listę wszystkich typów dodatków, zobacz temat Definicje: typ waluty zewnętrznej.

#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

Cofanie przydziału dodatku

Przydział dodatku można cofnąć. Jest to również często stosowany przez administratorów, którzy chcą ponownie zastosować pojemność dla innych celów.

Power Platform Centrum administracyjne

Cofanie przydziału dodatku z centrum administracyjnego Power Platform

1. Zaloguj się do centrum administracyjnego Power Platform wybierz Zasoby>Pojemność.
2. Wybierz opcję Zarządzaj w sekcji Dodatki.
3. Znajdź środowisko i usuń alokację kredytów AI Builder przypisaną wcześniej w tym artykule.
4. Wybierz pozycję Zapisz.

Program PowerShell

Cofanie przydziału dodatku na przy użyciu programu PowerShell

Aby cofnąć przydział dodatku, użyj następującego skryptu. Zmień identyfikator environmentID na odpowiadający środowisku.

#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