Get-PowerBIWorkspace
إرجاع قائمة بمساحات عمل Power BI.
بناء الجملة
Get-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
[-Filter <String>]
[-User <String>]
[-Deleted]
[-Orphaned]
[-Type <WorkspaceType>]
[-First <Int32>]
[-Skip <Int32>]
[-Include <ArtifactType[]>]
[<CommonParameters>]
Get-PowerBIWorkspace
-Id <Guid>
[-Scope <PowerBIUserScope>]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[<CommonParameters>]
Get-PowerBIWorkspace
-Name <String>
[-Scope <PowerBIUserScope>]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[<CommonParameters>]
Get-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
[-Filter <String>]
[-User <String>]
[-Deleted]
[-Orphaned]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[-All]
[<CommonParameters>]
الوصف
استرداد قائمة بمساحات عمل Power BI التي تطابق معايير البحث والنطاق المحددين. بشكل افتراضي (بدون معلمة -First) يعرض أول 100 مساحة عمل معينة للمستخدم. استخدم -First -Skip لجلب المزيد من مساحات العمل أو استخدام -All لإرجاع كافة مساحات العمل. يمكن استخدام المعلمة -First لإرجاع 5000 مساحة عمل على الأكثر. قبل تشغيل هذا الأمر، تأكد من تسجيل الدخول باستخدام Connect-PowerBIServiceAccount.
أمثلة
مثال 1
PS C:\> Get-PowerBIWorkspace
إرجاع أول 100 مساحة عمل Power BI تم تعيين المستخدم المتصل إليها (-Scope فردي).
مثال 2
PS C:\> Get-PowerBIWorkspace -All
إرجاع كافة مساحات عمل Power BI التي تم تعيين المستخدم المتصل إليها.
مثال 3
PS C:\> Get-PowerBIWorkspace -Scope Organization -Filter "tolower(name) eq 'contoso sales'"
إرجاع مساحة عمل تسمى "Contoso Sales" (غير حساسة لحالة الأحرف مع tolower) داخل مؤسسة المستخدم.
مثال 3
PS C:\> Get-PowerBIWorkspace -Scope Organization -Include All
إرجاع كافة مساحات عمل Power BI إلى جانب التقارير ولوحات المعلومات ومجموعات البيانات وتدفقات البيانات والمصنفات ذات الصلة داخل مؤسسة المستخدم.
المعلمات
-All
يشير إلى إظهار كافة مساحات العمل. -لا يمكن استخدام -Skip و الأولى مع هذه المعلمة.
النوع: | SwitchParameter |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Deleted
يشير إلى إظهار مساحات العمل المحذوفة فقط. يتم دعمه فقط عند تحديد -Scope Organization.
النوع: | SwitchParameter |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Filter
عامل تصفية OData، حساس لحالة الأحرف (تبدأ أسماء العناصر بأحرف صغيرة).
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-First
قائمة النتائج الأولى (العلوية). هذه القيمة افتراضية إلى 100.
النوع: | Int32 |
الأسماء المستعارة: | Top |
Position: | Named |
القيمة الافتراضية: | 100 |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Id
معرف مساحة العمل المراد إرجاعها.
النوع: | Guid |
الأسماء المستعارة: | GroupId, WorkspaceId |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Include
استرداد البيانات الاصطناعية ذات الصلة المقترنة بمساحة عمل Power BI. يتوفر فقط عندما يكون -Scope هو المؤسسة.
النوع: | ArtifactType[] |
الأسماء المستعارة: | Expand |
القيم المقبولة: | Reports, Dashboards, Datasets, Dataflows, Workbooks, All |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Name
اسم مساحة العمل المراد إرجاعها إذا كانت موجودة بهذا الاسم. بحث غير حساس لحالة الأحرف.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Orphaned
يشير إلى إظهار مساحات العمل المعزولة فقط. يتم دعمه فقط عند تحديد -Scope Organization.
النوع: | SwitchParameter |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Scope
يشير إلى نطاق المكالمة. يقوم الفرد بإرجاع مساحات العمل المعينة للمتصل فقط؛ تقوم المؤسسة بإرجاع كافة مساحات العمل داخل المستأجر (يجب أن تكون مسؤولا لبدء العمل). الفرد هو الافتراضي.
النوع: | PowerBIUserScope |
القيم المقبولة: | Individual, Organization |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Skip
يتخطى المجموعة الأولى من النتائج.
النوع: | Int32 |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Type
نوع مساحة العمل التي يجب إرجاعها. البحث الحساس لحالة الأحرف.
النوع: | WorkspaceType |
القيم المقبولة: | Workspace, Group, PersonalGroup |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-User
قم بتصفية مساحات العمل لإظهار مساحات العمل التي يحتوي عليها المستخدم. يتوفر فقط عندما يكون -Scope هو المؤسسة.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
الإدخالات
None
المخرجات
System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Workspaces.Workspace, Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]