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]]