استخدام AllowSelfServicePurchase للوحدة النمطية MSCommerce PowerShell
تتوفر الآن الوحدة النمطية ل MSCommerce PowerShell في معرض PowerShell. تتضمن الوحدة النمطية قيمة المعلمة PolicyID ل AllowSelfServicePurchase التي تسمح لك بالتحكم في ما إذا كان يمكن للمستخدمين في مؤسستك إجراء عمليات شراء الخدمة الذاتية.
يمكنك استخدام الوحدة النمطية ل MSCommerce PowerShell من أجل:
- عرض الحالة الافتراضية لقيمة المعلمة AllowSelfServicePurchase — سواء تم تمكينها أو تعطيلها
- عرض قائمة بالمنتجات القابلة للتطبيق وما إذا كان الشراء الذاتي للخدمة يتم تمكينه أو تعطيله
- عرض الإعداد الحالي لمنتج معين أو تعديله إما لتمكينه أو تعطيله
المتطلبات
لاستخدام الوحدة النمطية ل MSCommerce PowerShell، ستحتاج إلى:
- جهاز Windows 10
- PowerShell 5 أو أقل. حاليا، PowerShell 6.x/7.x غير معتمد مع هذه الوحدة النمطية.
- إذن المسؤول للجهاز
- دور مسؤول الفوترة أو العام للمستأجر
تثبيت الوحدة النمطية ل MSCommerce PowerShell
يمكنك تثبيت وحدة MSCommerce PowerShell النمطية على Windows 10 مرة واحدة ثم استيرادها إلى كل جلسة PowerShell تبدأ بها. قم بتنزيل الوحدة النمطية ل MSCommerce PowerShell من معرض PowerShell.
لتثبيت وحدة MSCommerce PowerShell النمطية مع PowerShellGet، قم بتشغيل الأمر التالي:
Install-Module -Name MSCommerce
استيراد MSCommerce إلى جلسة عمل PowerShell
بعد تثبيت الوحدة النمطية على جهاز Windows 10، يمكنك استيرادها إلى كل جلسة PowerShell تبدأ بها. لاستيرادها إلى جلسة عمل PowerShell، تشغيل الأمر التالي:
Import-Module -Name MSCommerce
الاتصال إلى MSCommerce باستخدام بيانات الاعتماد الخاصة بك
للاتصال الوحدة النمطية PowerShell باستخدام بيانات الاعتماد، قم بتشغيل الأمر التالي.
Connect-MSCommerce
يربط هذا الأمر جلسة PowerShell الحالية ب مستأجر Azure Active Directory. يطالبك الأمر باسم المستخدم وكلمة المرور للمستأجر الذي تريد الاتصال به. إذا تم تمكين المصادقة متعددة العوامل للحصول على بيانات الاعتماد الخاصة بك، يمكنك استخدام الخيار التفاعلي لتسجيل الدخول.
عرض تفاصيل AllowSelfServicePurchase
لعرض وصف لقيمة المعلمة AllowSelfServicePurchase مع الحالة الافتراضية، استنادا إلى مؤسستك، يمكنك تشغيل الأمر التالي:
Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase
عرض قائمة منتجات شراء الخدمة الذاتية ووضعها
لعرض قائمة بجميع منتجات شراء الخدمة الذاتية المتوفرة ووضع كل منها، يمكنك تشغيل الأمر التالي:
Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase
يسرد الجدول التالي المنتجات المتوفرة ومنتجاتها.
| المنتج | ProductId |
|---|---|
| Power Apps لكل مستخدم | CFQ7TTC0KP0P |
| Power Automate لكل مستخدم | CFQ7TTC0KP0N |
| Power Automate RPA | CFQ7TTC0KXG6 |
| Power BI Premium (مستقل) | CFQ7TTC0KXG7 |
| Power BI Pro | CFQ7TTC0L3PB |
| Project (النظام 1)* | CFQ7TTC0HDB1 |
| Project (النظام 3)* | CFQ7TTC0HDB0 |
| Visio (النظام 1)* | CFQ7TTC0HD33 |
| Visio (النظام 2)* | CFQ7TTC0HD32 |
| Windows 365 Enterprise | CFQ7TTC0HHS9 |
| Windows 365 Business | CFQ7TTC0J203 |
| Windows 365 Business مع Windows المختلطة | CFQ7TTC0HX99 |
*تم تغيير هذه الم IDS. إذا قمت مسبقا بحظر المنتجات باستخدام الم IDS القديمة، يتم حظرها تلقائيا باستخدام الم IDS الجديدة. لا حاجة إلى أي عمل إضافي.
عرض حالة AllowSelfServicePurchase أو تعيينها
بعد عرض قائمة المنتجات المتوفرة لشراء الخدمة الذاتية، يمكنك عرض الإعداد لمنتج معين أو تعديله.
للحصول على إعداد النهج لمنتج معين، يمكنك تشغيل الأمر التالي:
Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N
لتمكين إعداد النهج لمنتج معين، يمكنك تشغيل الأمر التالي:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Enabled $True
لتعطيل إعداد النهج لمنتج معين، قم بتشغيل الأمر التالي:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Enabled $False
مثال برنامج نصي لتعطيل AllowSelfServicePurchase
يستعرض المثال التالي كيفية استيراد وحدة MSCommerce النمطية، تسجيل الدخول باستخدام حسابك، والحصول على ProductId ل Power Automate، ثم تعطيل AllowSelfServicePurchase لهذا المنتج.
Import-Module -Name MSCommerce
Connect-MSCommerce #sign-in with your global or billing administrator account when prompted
$product = Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase | where {$_.ProductName -match 'Power Automate'}
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product.ProductID -Enabled $false
إذا كانت هناك قيم متعددة للمنتج، يمكنك تشغيل الأمر بشكل فردي لكل قيمة كما هو موضح في المثال التالي:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[0].ProductID -Enabled $false
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[1].ProductID -Enabled $false
استكشاف الأخطاء وإصلاحها
المشكلة
تظهر رسالة الخطأ التالية:
معالج : فشل استرداد النهج باستخدام PolicyId 'AllowSelfServicePurchase', ErrorMessage - تم إغلاق الاتصال الأساسي: حدث خطأ غير متوقع في عملية إرسال.
قد يعود سبب ذلك إلى إصدار أقدم من "أمان طبقة النقل" (TLS). لتوصيل هذه الخدمة، ستحتاج إلى استخدام TLS 1.2 أو أكبر
الحل
الترقية إلى TLS 1.2. يتم تحديث بناء الجملة التالي بروتوكول أمان ServicePointManager إلى TLS1.2:
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12
لمعرفة المزيد، راجع كيفية تمكين TLS 1.2.
المحتوى ذي الصلة
الملاحظات
إرسال الملاحظات وعرضها المتعلقة بـ