Didacticiel : affecter des modules complémentaires aux environnements (version préliminaire)

Article
10/31/2023

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Les modules complémentaires fournissent des fonctionnalités supplémentaires que Power Apps, les flux Power Automate et d’autres ressources peuvent utiliser. Ces fonctionnalités peuvent être attribuées au niveau de l’environnement dans le centre d’administration Power Platform et sont mises à disposition en fonction des achats de licence antérieurs. Pour en savoir plus sur la gestion des modules complémentaires, les rapports et le contrôle d’accès, consultez la section Gestion de la capacité des modules complémentaires.

Dans ce tutoriel, vous allez découvrir comment :

Allouer manuellement un module complémentaire à un environnement dans le centre d’administration Power Platform.
Allouer des modules complémentaires, à grande échelle, à l’aide de PowerShell.
Annuler l’attribution du module complémentaire.

À titre d’exemple de ce scénario, un client qui a acheté AI Builder des crédits et Power Automate par flux de processus peut attribuer ces modules complémentaires à un environnement pour tenir compte de l’utilisation dans cet environnement.

Important

Cette fonctionnalité est une fonctionnalité en version préliminaire. Les fonctionnalités préliminaires ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

Allouer un module complémentaire de capacité à un environnement

Pour commencer, connectez-vous en tant que Power Platform Administrateur et allouez AI Builder des crédits à l’environnement dans lequel ils seront utilisés.

Tous les modules complémentaires ne sont pas disponibles dans l’interface Power Platform du centre d’administration. Au fur et à mesure que de nouveaux modules complémentaires deviennent disponibles, ils sont souvent d’abord mis en évidence à l’aide d’API et d’outils de programmabilité pour obtenir les commentaires des clients avant de les rendre plus généralement disponibles dans l’interface utilisateur. Un tel exemple est le module complémentaire Power Automate par processus, qui peut être alloué à l’aide de PowerShell, comme illustré dans l’exemple PowerShell suivant.

Centre d’administration Power Platform
PowerShell

Attribuez manuellement un module complémentaire depuis le Power Platform centre d’administration

Dans le Centre d’administration Power Platform, sélectionnez Ressources>Capacité.
Faites défiler jusqu’à la section Modules complémentaires et sélectionnez le lien Gérer.
Sélectionnez un environnement et passez en revue tous les différents modules complémentaires que vous pouvez attribuer. N’oubliez pas que vous ne pouvez ajuster les modules complémentaires que pour ceux que vous avez déjà achetés.

Dans cet exemple, nous ajoutons 500 AI Builder crédits à l’environnement.
Sélectionnez Enregistrer.

Allouez un module complémentaire à l’aide de PowerShell

Chargez votre console PowerShell et exécutez les commandes suivantes pour allouer des modules complémentaires à un environnement spécifique. Dans cet exemple, sélectionnez le même environnement utilisé dans l’exemple manuel dans le Power Platform centre d’administration, mais vous pouvez interroger plusieurs environnements et parcourir chacun d’eux, si nécessaire. Dans l’exemple ci-dessous, nous avons utilisé le nouveau PowerAutomatePerProcess type de module complémentaire, qui n’est pas encore disponible dans le Power Platform interface utilisateur du centre d’administration.

Pour une liste de tous les types de modules complémentaires, voir Définitions : type de devise externe.

#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

Annuler l’attribution du module complémentaire

Vous pouvez annuler l’attribution du module complémentaire. Ceci est également couramment effectué par les administrateurs qui souhaitent récupérer de la capacité à d’autres fins.

Centre d’administration Power Platform
PowerShell

Annulez l’attribution d’un module complémentaire depuis le Power Platform centre d’administration

Connectez-vous au centre d’administration Power Platform et sélectionnez l’onglet Ressources>Capacité.
Sélectionnez Gérer dans la section des modules complémentaires.
Trouvez votre environnement et supprimez le AI Builder allocation de crédits qui a été attribuée plus haut dans cet article.
Sélectionnez Enregistrer.

Annulez l’allocation d’un module complémentaire à l’aide de PowerShell

Utilisez le script suivant pour désattribuer un module complémentaire. Vous devez changer le ID environnement à celui qui correspond à votre environnement.

#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

Partager via