Учебное руководство. Выделение надстроек для сред (предварительная версия)

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Надстройки предоставляют дополнительные возможности, которые могут использовать Power Apps, потоки Power Automate и другие ресурсы. Эти возможности можно назначать на уровне среды в Центре администрирования Power Platform, и они становятся доступными на основе ранее приобретенных лицензий. Дополнительные сведения об управлении надстройками, отчетности и контроле доступа см. в разделе Управление емкостью надстроек.

Из этого руководства вы узнаете, как выполнять следующие задачи:

• Выделить надстройку для среды вручную в Центре администрирования Power Platform.
• Выделять надстройки в большом масштабе с помощью PowerShell.
• Отменить назначение надстройки.

В качестве примера рассмотрим сценарий, в котором клиент, купивший кредиты AI Builder и потоки Power Automate на процесс, может назначить эти надстройки среде для учета их использования в этой среде.

Внимание

Это предварительная версия функции. Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Выделение надстройки для среды

Для начала войдите в систему в качестве администратора Power Platform и выделите кредиты AI Builder для среды, в которой они будут использоваться.

В пользовательском интерфейсе Центра администрирования Power Platform доступны не все надстройки. При появлении новых надстроек они часто сначала доступны только с помощью API и средств программирования и становятся доступными в пользовательском интерфейсе только после получения отзывов от клиентов. В качестве примера можно привести надстройку Power Automate на процесс, которую можно выделить с помощью PowerShell, как показано в следующем примере для PowerShell.

Центр администрирования Power Platform

Выделение надстройки вручную в Центре администрирования Power Platform

1. В Центре администрирования Power Platform выберите Ресурсы>Емкость.

2. Прокрутите вниз до раздела Надстройки и выберите ссылку Управление .

   

3. Выберите среду и просмотрите все различные надстройки, которые вы можете назначить. Имейте в виду, что вы можете настроить надстройки только для того, что вы уже купили.

   В этом примере мы добавляем в среду 500 кредитов AI Builder.

   

4. Выберите Сохранить.

PowerShell

Выделение надстройки с помощью PowerShell

Загрузите консоль PowerShell и выполните следующие команды, чтобы выделить надстройки для определенной среды. В этом примере в Центре администрирования Power Platform нужно выбрать ту же среду, что и в примере для выделения вручную, но при необходимости вы могли бы запросить и несколько сред и просмотреть каждую из них по очереди. В приведенном ниже примере мы использовали новый тип надстройки PowerAutomatePerProcess, который еще не доступен в пользовательском интерфейсе Центра администрирования Power Platform.

Список всех типов надстроек см. в разделе Определения. Тип внешней валюты.

#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

Отмена назначения надстройки

Вы можете отменить назначение надстройки. Это также часто делают администраторы, желающие освободить емкость для других целей.

Центр администрирования Power Platform

Отмена назначения надстройки в Центре администрирования Power Platform

1. Войдите в Центр администрирования Power Platform и выберите Ресурсы>Емкость.
2. Выберите Управление в разделе Надстройки.
3. Найдите свою среду и отмените выделение кредитов AI Builder, произведенное ранее в этой статье.
4. Выберите Сохранить.

PowerShell

Отмена назначения надстройки с помощью PowerShell

Для отмены назначения надстройки используйте приведенный ниже скрипт. Вы должны изменить environmentID, указав идентификатор, соответствующий вашей среде.

#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