Esercitazione: assegnazione di componenti aggiuntivi agli ambienti (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

I componenti aggiuntivi forniscono funzionalità aggiuntive che i flussi Power Apps, Power Automate e altre risorse possono utilizzare. Queste funzionalità possono essere assegnate a livello di ambiente nell'interfaccia di amministrazione di Power Platform e vengono rese disponibili in base agli acquisti di licenze precedenti. Per ulteriori informazioni sulla gestione dei componenti aggiuntivi, sui report e sul controllo degli accessi, consulta Gestione della capacità dei componenti aggiuntivi.

In questa esercitazione si imparerà a:

• Assegnare manualmente un componente aggiuntivo a un ambiente nell'interfaccia di amministrazione di Power Platform.
• Assegnare i componenti aggiuntivi, su larga scala, utilizzando PowerShell.
• Annullare l'assegnazione di un componente aggiuntivo.

Come esempio di questo scenario, un cliente che ha acquistato crediti AI Builder e flussi Power Automate per processo può assegnare tali componenti aggiuntivi a un ambiente per tenerne conto dell'utilizzo in tale ambiente.

Importante

Questa è una funzionalità di anteprima. Le funzionalità di anteprima non sono destinate a essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.

Assegnare un componente aggiuntivo a un ambiente

Per iniziare, accedi come amministratore Power Platform e assegna crediti AI Builder all'ambiente in cui verranno utilizzati.

Non tutti i componenti aggiuntivi sono disponibili nell'interfaccia di amministrazione di Power Platform. Man mano che diventano disponibili nuovi componenti aggiuntivi, spesso vengono visualizzati per la prima volta utilizzando API e strumenti di programmabilità per ottenere il feedback dei clienti prima di renderli più generalmente disponibili nell'interfaccia utente. Un esempio di questo tipo è il componente aggiuntivo Power Automate per processo, che può essere allocato tramite PowerShell, come illustrato nell'esempio di PowerShell seguente.

Interfaccia di amministrazione di Power Platform

Assegnare manualmente un componente aggiuntivo dall'interfaccia di amministrazione di Power Platform

1. Nell'interfaccia di amministrazione di Power Platform seleziona Risorse>Capacità.

2. Scorri verso il basso fino alla sezione Componenti aggiuntivi e seleziona il collegamento Gestisci.

   

3. Seleziona un ambiente e rivedi tutti i vari componenti aggiuntivi che potresti assegnare. Tieni presente che puoi modificare solo i componenti aggiuntivi che hai acquistato in precedenza.

   In questo esempio, aggiungiamo 500 crediti AI Builder all'ambiente.

   

4. Seleziona Salva.

PowerShell

Assegnare un componente aggiuntivo utilizzando PowerShell

Carica la console di PowerShell ed esegui i seguenti comandi per allocare i componenti aggiuntivi a un ambiente specifico. In questo esempio, seleziona lo stesso ambiente utilizzato nell'esempio manuale nell'interfaccia di amministrazione di Power Platform, ma è possibile eseguire query per diversi ambienti e scorrere ciascuno di essi, come necessario. Nell'esempio seguente, abbiamo usato il nuovo tipo di componente aggiuntivo PowerAutomatePerProcess, che non è ancora disponibile nell'interfaccia di amministrazione di Power Platform.

Per un elenco di tutti i tipi di componenti aggiuntivi, vedi Definizioni: Tipo di valuta esterna.

#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

Annullare l'assegnazione di un componente aggiuntivo

Puoi annullare l'assegnazione di un componente aggiuntivo. Questa operazione viene comunemente eseguita anche dagli amministratori che desiderano recuperare la capacità per altri scopi.

Interfaccia di amministrazione di Power Platform

Annullare l'assegnazione di un componente aggiuntivo dall'interfaccia di amministrazione di Power Platform

1. Accedi all'interfaccia di amministrazione di Power Platform e seleziona Risorse>Capacità.
2. Seleziona Gestisci nella sezione Componenti aggiuntivi.
3. Trova il tuo ambiente e rimuovi i crediti AI Builder che sono stati assegnati in precedenza in questo articolo.
4. Seleziona Salva.

PowerShell

Annullare l'assegnazione di un componente aggiuntivo utilizzando PowerShell

Utilizza il seguente script per annullare l'assegnazione di un componente aggiuntivo. Devi cambiare l'ID ambiente con uno che corrisponde al tuo 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