Tutorial: asignar complementos a entornos (versión preliminar)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Los complementos brindan capacidades adicionales que Power Apps, Power Automate fluyen y otros recursos pueden utilizar. Estas capacidades se pueden asignar a nivel de entorno en el Power Platform centro de administración y están disponibles en función de compras de licencias anteriores. Para obtener más información sobre la gestión de complementos, los informes y el control de acceso, consulte Gestión de la capacidad de complementos.

En este tutorial, obtendrá información sobre cómo:

• Asignar un complemento manjualmente a un entorno en el centro de administración de Power Platform.
• Asigne complementos, a escala, mediante PowerShell.
• Desasignar un complemento.

Como ejemplo de este escenario, un cliente que ha comprado AI Builder créditos y flujos de Power Automate por proceso puede asignar esos complementos a un entorno para contabilizar el uso en ese entorno.

Importante

Esta es una característica en versión preliminar. Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Asignar capacidad de complemento a un entorno

Para empezar, inicie sesión como Power Platform Administrador y asigne AI Builder créditos al entorno en el que se utilizarán.

No todos los complementos están disponibles en la interfaz de usuario del Power Platform centro de administración. A medida que los nuevos complementos están disponibles, a menudo aparecen primero mediante la API y las herramientas de programación para obtener comentarios de los clientes antes de que estén disponibles de forma más general en la interfaz de usuario. Un ejemplo de este tipo es el complemento de Power Automate por proceso, que se puede asignar mediante PowerShell, como se muestra en el siguiente ejemplo de PowerShell.

Power Platform Centro de administración

Asigne manualmente un complemento desde el centro de administración de Power Platform

1. En el Centro de administración de Power Platform, seleccione Recursos>Capacidad.

2. Desplácese hacia abajo hasta la sección Complementos y seleccione el enlace Administrar.

   

3. Seleccione un entorno y revise todos los diversos complementos que podría asignar. Tenga en cuenta que solo puede ajustar complementos para aquellos que haya comprado previamente.

   En este ejemplo, agregamos 500 créditos de AI Builder al entorno.

   

4. Seleccione Guardar.

Potencia Shell

Asigne complementos, a escala, mediante PowerShell

Cargue su consola PowerShell y ejecute los siguientes comandos para asignar complementos a un entorno específico. En este ejemplo, seleccione el mismo entorno utilizado en el ejemplo manual en el centro de administración de Power Platform, pero podría consultar varios entornos y recorrer cada uno, según sea necesario. En el siguiente ejemplo, usamos el nuevo tipo de complemento PowerAutomatePerProcess, que aún no está disponible en la interfaz de usuario del centro de administración de Power Platform.

Para obtener una lista de todos los tipos de complementos, consulte Definiciones: Tipo de moneda 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

Desasignar un complemento

Puede desasignar un complemento. Esto también lo suelen hacer los administradores que desean reclamar capacidad para otros fines.

Power Platform Centro de administración

Desasignar manualmente un complemento desde el centro de administración de Power Platform

1. Inicie sesión en el centro de administración de Power Platform y seleccione Recursos>Capacidad.
2. Seleccione Administrar en la sección Complementos.
3. Encuentre su entorno y elimine la asignación de créditos de AI Builder que se asignó anteriormente en este artículo.
4. Seleccione Guardar.

Potencia Shell

Dessignar complementos, a escala, mediante PowerShell

Utilice el siguiente script para cancelar la asignación de un complemento. Debes cambiar el ID de entorno a uno que coincida con su entorno.

#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