Tutorial: Alocar complementos para ambientes (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Os complementos oferecem recursos extras que o Power Apps, os fluxos do Power Automate e outros recursos podem utilizar. Esses recursos podem ser atribuídos no nível do ambiente no centro de administração do Power Platform e são disponibilizados com base em compras de licença anteriores. Para saber mais sobre gerenciamento do complemento, relatório e controle de acesso, consulte Gerenciamento de capacidade do complemento.

Neste tutorial, você aprenderá a:

• Alocar manualmente um complemento para um ambiente no centro de administração do Power Platform.
• Alocar complementos, em escala, usando o PowerShell.
• Cancelar atribuição de um complemento.

Como exemplo desse cenário, um cliente que comprou créditos do AI Builder e o Power Automate por fluxos Process pode atribuir esses complementos a um ambiente a fim de contabilizar o uso nesse ambiente.

Importante

Esse é um recurso de versão preliminar. A versão preliminar dos recursos não foi criada para uso em ambientes de produção e pode ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Alocar um complemento para um ambiente

Para começar, entre como administrador do Power Platform e aloque créditos do AI Builder para o ambiente onde eles serão usados.

Nem todos os complementos estão disponíveis na interface do usuário do centro de administração do Power Platform. À medida que forem disponibilizados, novos complementos normalmente aparecerão pela primeira vez usando API e ferramentas de programação para obter comentários do cliente antes de disponibilizá-los mais geralmente na interface do usuário. Esse exemplo é o complemento do Power Automate por Process, que pode ser alocado usando o PowerShell, conforme mostrado no exemplo do PowerShell a seguir.

Power Platform centro de administração

Alocar manualmente um complemento no centro de administração do Power Platform

1. No centro de administração do Power Platform, selecione Recursos>Capacidade.

2. Role até a seção Complementos e selecione o link Gerenciar.

   

3. Selecione um ambiente e revise todos os complementos variados que você pode atribuir. Lembre-se de que você só pode ajustar complementos para aqueles comprados anteriormente.

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

   

4. Selecione Salvar.

PowerShell

Alocar um complemento usando o PowerShell

Carregue o console do PowerShell e execute os comandos a seguir a fim de alocar complementos para um ambiente específico. Neste exemplo, selecione o mesmo ambiente usado no exemplo manual no centro de administração do Power Platform, embora você possa consultar diversos ambientes e percorrer todos deles, conforme necessário. No exemplo abaixo, usamos o novo tipo de complemento PowerAutomatePerProcess, que ainda não está disponível na interface do usuário do centro de administração do Power Platform.

Para obter uma lista de todos os tipos de complemento, 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 atribuição de um complemento

Você cancelar atribuição de um complemento. Isso também costuma ser feito por administradores que desejam recuperar capacidade com outras finalidades.

Power Platform centro de administração

Cancelar atribuição de um complemento no centro de administração do Power Platform

1. Entre no centro de administração do Power Platform e selecione Recursos>Capacidade.
2. Selecione Gerenciar na seção Complementos.
3. Encontre o ambiente e remova a alocação de créditos do AI Builder atribuída anteriormente neste artigo.
4. Selecione Salvar.

PowerShell

Cancelar atribuição de um complemento usando o PowerShell

Use o script a seguir para cancelar atribuição de um complemento. Você deve alterar o environmentID para um que corresponda ao 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