Tutorial: Alocar suplementos a ambientes (pré-visualização)

Artigo
08/08/2023

[Este artigo inclui documentação pré-versão e está sujeito a alterações.]

Os suplementos fornecem capacidades adicionais que os fluxos do Power Apps, Power Automate e outros recursos, podem utilizar. Estas capacidades podem ser atribuídas ao nível do ambiente no centro de administração do Power Platform e são disponibilizadas com base em compras de licenças anteriores. Para mais informações sobre a gestão de suplementos, relatórios e controlo de acesso, consulte Gestão de capacidade de suplementos.

Neste tutorial, vai aprender a:

Aloque manualmente um suplemento a um ambiente no centro de administração do Power Platform.
Alocar suplementos em escala utilizando o PowerShell.
Cancelar a atribuição de um suplemento.

Como exemplo deste cenário, um cliente que tenha comprado créditos do AI Builder e fluxos por Processo do Power Automate, pode atribuir esses suplementos a um ambiente para contabilizar a utilização nesse ambiente.

Importante

Esta é uma caraterística de pré-visualização. As funcionalidades de pré-visualização não se destinam à produção e poderão ter funcionalidades restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Alocar um suplemento de capacidade a um ambiente

Para começar, inicie sessão como administrador do Power Platform e aloque créditos do AI Builder ao ambiente onde serão utilizados.

Nem todos os suplementos estão disponíveis na IU do centro de administração do Power Platform. À medida que os novos suplementos ficam disponíveis, são frequentemente disponibilizados pela primeira vez utilizando API e ferramentas de capacidade de programação para obterem feedback dos clientes antes de os disponibilizar de modo mais geral na IU. Este exemplo é o suplemento por Processo do Power Automate, que pode ser alocado utilizando o PowerShell, como mostrado no seguinte exemplo do PowerShell.

Power Platform Centro de administração
PowerShell

Alocar manualmente um suplemento a partir do centro de administração do Power Platform

No centro de administração do Power Platform, selecione Recursos>Capacidade.
Desloque-se para baixo até à secção Suplementos e selecione a ligação Gerir.
Selecione um ambiente e reveja todos os vários suplementos que pode atribuir. Tenha em atenção que só pode ajustar os suplementos para os que comprou anteriormente.

Neste exemplo, adicionamos 500 créditos do AI Builder ao ambiente.
Selecione Guardar.

Alocar um suplemento utilizando o PowerShell

Carregue a sua consola do PowerShell e execute os seguintes comandos para alocar suplementos a um ambiente específico. Neste exemplo, selecione o mesmo ambiente utilizado no exemplo manual no centro de administração do Power Platform, mas poderá consultar vários ambientes e percorrer através de cada um, como necessário. No exemplo abaixo, utilizámos o novo tipo de suplemento PowerAutomatePerProcess, que ainda não está disponível na IU do centro de administração do Power Platform.

Para uma lista de todos os tipos de suplementos, consulte Definições: Tipo de Moeda Externa.

#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

Cancelar a atribuição de um suplemento

Pode cancelar a atribuição de um suplemento. Este processo também é normalmente feito por admins que pretendem recuperar capacidade para outras finalidades.

Power Platform Centro de administração
PowerShell

Cancelar a atribuição de um suplemento a partir do centro de administração do Power Platform

Inicie sessão no centro de administração do Power Platform e selecione Recursos>Capacidade.
Selecione Gerir, na secção Suplementos.
Localize o seu ambiente e remova os créditos do AI Builder que foram atribuídos anteriormente neste artigo.
Selecione Guardar.

Cancelar a atribuição de um suplemento utilizando o PowerShell

Utilize o script seguinte para cancelar a atribuição de um suplemento. Tem de alterar o environmentID para um que corresponda ao seu ambiente.

#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

Partilhar via