教學課程：將附加元件配置至環境 (預覽版)
[本文章是發行前版本文件，且隨時可能變更。]
附加功能提供了 Power Apps、Power Automate 流程和其他資源可以使用的額外功能。 這些功能可以在 Power Platform 系統管理中心的環境層級進行指派，並根據先前購買的授權進行使用。 若要進一步瞭解附加元件管理、報告及存取控制，請參閱附加元件容量管理。
在本教學課程中，您將了解如何：
- 手動將附加元件配置至 Power Platform 系統管理中心的環境。
- 使用 PowerShell 大規模配置附加元件。
- 取消指派附加元件。
如需此案例的範例，已購買 AI Builder 點數和 Power Automate 依程序流程的客戶可以將這些附加元件指派至環境，以供該環境使用。
重要
這是預覽功能。
預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
將附加元件配置至環境
若要開始，請以 Power Platform 系統管理員身分登入，並將 AI Builder 點數配置至要使用的環境。
並非所有附加元件都可以在 Power Platform 系統管理中心 UI 中使用。 隨著新的附加功能推出，其通常會先透過 API 和可編程工具提供，以取得客戶的意見反應，然後再在 UI 中正式推出。 這類範例為 Power Automate 依程序附加元件，可使用 PowerShell 進行分配，如下列 PowerShell 範例中所示。
在 Power Platform 系統管理中心，選取資源>容量。
向下捲動至附加元件區段，然後選取管理連結。
![選取 [管理] 連結。](media/tutorial-allocate-addons1.png)
選取環境，然後檢閱您可以指派的所有附加元件。 請記住，您只能調整先前購買的附加元件。
在此範例中，我們將 500 個 AI Builder 點數新增到環境中。
選取儲存。
使用 PowerShell 配置附加元件
載入 PowerShell 主控台並執行下列命令，將附加元件配置至特定環境。 在此範例中，請選取 Power Platform 系統管理中心的手動範例中使用的相同環境，但您可以視需要查詢多個環境並遍歷每個環境。 在下列範例中，我們使用了新的 PowerAutomatePerProcess 附加元件類型，該類型在 Power Platform 系統管理中心 UI 中尚無法使用。
如需所有附加元件類型的清單，請參閱定義：外部貨幣類型。
#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 系統管理中心，然後選取資源>容量。
- 選取附加元件區段中的管理。
- 找到您的環境，然後移除本文先前指派的 AI Builder 點數配置。
- 選取儲存。
使用 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