البرنامج التعليمي: تخصيص الوظائف الإضافية للبيئات (إصدار أولي)

[هذا المقال عبارة عن وثائق نسخة مسبقة وهو عرضة للتغيير.]

توفر الوظائف الإضافية إمكانات إضافية يمكن أن تستخدمها عمليات سير عمل 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

يمكنك استخدم النص التالي لإلغاء تعيين وظيفة إضافية. يجب عليك تغيير معرّف البيئة إلى آخر يتوافق مع بيئتك.

#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