مشاركة عبر

Microsoft Power BI Cmdlets ل Windows PowerShell وPowerShell Core

مرحبا بك في مرجع PowerShell ل Microsoft Power BI. ستجد هنا موارد لوحدات PowerShell التي تستهدف Power BI.

وحدات PowerShell

يوجد أدناه جدول بوحدات Power BI PowerShell النمطية التي تمت تغطيتها في هذا المرجع.

‏‏الوصف اسم الوحدة رابط معرض PowerShell
الوحدة النمطية للقيمة المحتسبة ل Power BI Cmdlets غير متاح MicrosoftPowerBIMgmt1.2.1111
وحدة المسؤول ل Power BI Cmdlets MicrosoftPowerBIMgmt.Admin Module MicrosoftPowerBIMgmt.Admin
وحدة السعات ل Power BI Cmdlets MicrosoftPowerBIMgmt.Capacities Module MicrosoftPowerBIMgmt.Abilities
وحدة البيانات ل Power BI Cmdlets MicrosoftPowerBIMgmt.Data Module MicrosoftPowerBIMgmt.Data
وحدة ملف التعريف النمطية ل Power BI Cmdlets MicrosoftPowerBIMgmt.Profile Module MicrosoftPowerBIMgmt.Profile
الوحدة النمطية للتقارير ل Power BI MicrosoftPowerBIMgmt.Reports Module MicrosoftPowerBIMgmt.Reports
وحدة مساحات العمل ل Power BI MicrosoftPowerBIMgmt.Workspaces Module MicrosoftPowerBIMgmt.Workspaces

البيئات المدعومة وإصدارات PowerShell

  • Windows PowerShell v3.0 والإصدارات الأحدث مع .NET 4.7.1 أو أعلى.
  • PowerShell Core (الإصدار 6) والإصدارات الأحدث على أي نظام أساسي لنظام التشغيل يدعمه PowerShell Core.

التثبيت

تتوفر أوامر cmdlets في معرض PowerShell ويمكن تثبيتها في جلسة عمل PowerShell مرتفعة:

Install-Module -Name MicrosoftPowerBIMgmt

اختياريا، يمكنك تثبيت وحدات نمطية فردية (بناء على احتياجاتك) بدلا من وحدة القيمة المحتسبة، على سبيل المثال إذا كنت تريد الوحدة النمطية لمساحات العمل فقط:

Install-Module -Name MicrosoftPowerBIMgmt.Workspaces

إذا كان لديك إصدار سابق، فيمكنك التحديث إلى أحدث إصدار عن طريق تشغيل:

Update-Module -Name MicrosoftPowerBIMgmt

إلغاء التثبيت

إذا كنت ترغب في إلغاء تثبيت كافة أوامر Power BI PowerShell cmdlet، فقم بتشغيل ما يلي في جلسة PowerShell غير مقيدة:

Get-Module MicrosoftPowerBIMgmt* -ListAvailable | Uninstall-Module -Force

الاستخدام

يتم دعم نطاقين بواسطة أوامر cmdlets التي تتفاعل مع كيانات Power BI:

  • يتم استخدام الفرد للوصول إلى الكيانات التي تنتمي إلى المستخدم الحالي.
  • يتم استخدام المؤسسة للوصول إلى الكيانات عبر الشركة بأكملها. يسمح فقط لمسؤولي مستأجر Power BI بالاستخدام.

إذا لم تكن المعلمة -Scope موجودة على cmdlet، فإن الكيان لا يدعم واجهة برمجة التطبيقات الإدارية.

تسجيل الدخول إلى Power BI

Connect-PowerBIServiceAccount   # or use aliases: Login-PowerBIServiceAccount, Login-PowerBI

الحصول على مساحات العمل

احصل على مساحات عمل للمستخدم. بشكل افتراضي (أي بدون -First معلمة) يعرض أول 100 مساحة عمل تم تعيينها للمستخدم:

Get-PowerBIWorkspace

استخدم المعلمة -All لإظهار جميع مساحات العمل المعينة للمستخدم:

Get-PowerBIWorkspace -All

إذا كنت مسؤول مستأجر، فيمكنك عرض جميع مساحات العمل في المستأجر الخاص بك عن طريق إضافة -Scope Organization:

Get-PowerBIWorkspace -Scope Organization -All

حدّث مساحة العمل

تحديث اسم مساحة عمل المستخدم أو وصفها:

Set-PowerBIWorkspace -Scope Organization -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -Name "Test Name" -Description "Test Description"

إضافة مستخدم جديد إلى مساحة عمل

إضافة مستخدم إلى مساحة عمل معينة:

Add-PowerBIWorkspaceUser -Scope Organization -Id 3244f1c1-01cf-457f-9383-6035e4950fdc -UserEmailAddress john@contoso.com -AccessRight Admin

إزالة مستخدم من مساحة عمل معينة

إزالة أذونات المستخدم من مساحة عمل معينة:

Remove-PowerBIWorkspaceUser -Scope Organization -Id 3244f1c1-01cf-457f-9383-6035e4950fdc -UserEmailAddress john@contoso.com

الحصول على حالة ترحيل مساحة العمل

احصل على حالة ترحيل مساحة عمل Power BI:

Get-PowerBIWorkspaceMigrationStatus -Id 038f9a64-1fcd-42f2-957a-13a63b3d3235

استعادة مساحة عمل

لعرض مساحات العمل المحذوفة كمسؤول مستأجر:

Get-PowerBIWorkspace -Scope Organization -Deleted -All

استعادة مساحة عمل محذوفة:

Restore-PowerBIWorkspace -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -RestoredName "TestWorkspace" -AdminEmailAddress "john@contoso.com"

استعادة مساحة عمل معزولة

تصبح مساحة العمل معزولة عندما لا يكون لديها مسؤولون معينون. إذا كنت مسؤول مستأجر، فقم بتشغيل ما يلي لعرض جميع مساحات العمل المعزولة:

Get-PowerBIWorkspace -Scope Organization -Orphaned -All

لتصحيح هذه المشكلة، استخدم:

Add-PowerBIWorkspaceUser -Scope Organization -Id f2a0fae5-1c37-4ee6-97da-c9d31851fe17 -UserPrincipalName 'john@contoso.com' -AccessRight Admin

الحصول على التقارير

احصل على جميع التقارير للمستخدم:

Get-PowerBIReport

إذا كنت مسؤول مستأجر، فيمكنك عرض جميع التقارير في المستأجر الخاص بك باستخدام -Scope Organizationتعيين:

Get-PowerBIReport -Scope Organization

الحصول على لوحات المعلومات

احصل على لوحات معلومات للمستخدم:

Get-PowerBIDashboard

إذا كنت مسؤول مستأجر، فيمكنك عرض جميع لوحات المعلومات في المستأجر الخاص بك عن طريق إضافة -Scope Organization:

Get-PowerBIDashboard -Scope Organization

الحصول على اللوحات

الحصول على اللوحات داخل لوحة المعلومات:

Get-PowerBITile -DashboardId 9a58d5e5-61bc-447c-86c4-e221128b1c99

الحصول على الواردات

الحصول على واردات Power BI:

Get-PowerBIImport

إنشَاء تقرير

قم بإنشاء تقرير في Power BI عن طريق تحميل ملف *.pbix:

New-PowerBIReport -Path .\newReport.pbix -Name 'New Report'

بشكل افتراضي، يتم وضع التقرير في مساحة العمل الخاصة بالمستخدم. لوضعها في مساحة عمل مختلفة، استخدم -WorkspaceId المعلمات أو -Workspace :

New-PowerBIReport -Path .\newReport.pbix -Name 'New Report' -WorkspaceId f95755a1-950c-46bd-a912-5aab4012a06d

تصدير تقرير

تصدير تقرير Power BI إلى ملف *.pbix:

Export-PowerBIReport -Id b48c088c-6f4e-4b7a-b015-d844ab534b2a -OutFile .\exportedReport.pbix

إذا كانت مساحة العمل موجودة خارج مساحة العمل الخاصة بي، فقم بالتصدير باستخدام WorkspaceId المعلمة أو -Workspace :

Export-PowerBIReport -Id b48c088c-6f4e-4b7a-b015-d844ab534b2a -OutFile .\exportedReport.pbix -WorkspaceId 3bdd9735-0ab5-4f21-bd5d-87e7f1d7fb84

الحصول على مجموعات البيانات

الحصول على مجموعات بيانات Power BI:

Get-PowerBIDataset

تحديث وضع تخزين مجموعة البيانات

قم بتعيين مجموعة بيانات Power BI لاستخدام Premium Files لوضع التخزين:

Set-PowerBIDataset -Id 038f9a64-1fcd-42f2-957a-13a63b3d3235 -TargetStorageMode PremiumFiles

الحصول على مصادر البيانات

احصل على مصادر بيانات Power BI لمجموعة بيانات:

Get-PowerBIDatasource -DatasetId 65d7d7e5-8af0-4e94-b20b-50a882ae15e1

الحصول على جداول

احصل على جداول Power BI المضمنة في مجموعة بيانات:

Get-PowerBITable -DatasetId 65d7d7e5-8af0-4e94-b20b-50a882ae15e1

استدعاء واجهة برمجة تطبيقات Power BI Rest

بالنسبة لواجهة برمجة تطبيقات Power BI التي تفتقر إلى أوامر cmdlets المقابلة، يمكنك إعادة استخدام الجلسة Connect-PowerBIServiceAccount المصادق عليها لإنشاء طلبات REST مخصصة:

Invoke-PowerBIRestMethod -Url 'reports/4eb4c303-d5ac-4a2d-bf1e-39b35075d983/Clone' -Method Post -Body ([pscustomobject]@{name='Cloned report'; targetModelId='adf823b5-a0de-4b9f-bcce-b17d774d2961'; targetWorkspaceId='45ee15a7-0e8e-45b0-8111-ea304ada8d7d'} | ConvertTo-Json -Depth 2 -Compress)

إذا كنت ترغب في استخدام جلسة العمل المصادق عليها خارج PowerShell، فاحصل على الرمز المميز للوصول باستخدام:

Get-PowerBIAccessToken -AsString

استكشاف الأخطاء وإصلاحها

للحصول على مزيد من المعلومات حول خطأ تم إرجاعه مرة أخرى من أوامر cmdlet، استخدم:

Resolve-PowerBIError -Last

يمكن أن تكون هذه المعلومات مفيدة لفتح تذاكر الدعم ل Power BI.

القضايا والملاحظات

إذا وجدت أي أخطاء أو ترغب في رؤية وظائف معينة مطبقة لأوامر PowerShell Cmdlets ل Power BI، فيرجى تقديم مشكلة.

إذا كانت مشكلتك أوسع من مجرد أوامر PowerShell cmdlet، فيرجى إرسال ملاحظاتك إلى مجتمع Power BI أو موقع دعم Power BI الرسمي.