Get-PowerBIWorkspace

  • Odwołanie
Moduł:
MicrosoftPowerBIMgmt.Workspaces

Zwraca listę obszarów roboczych usługi Power BI.

Składnia

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

Opis

Pobiera listę obszarów roboczych usługi Power BI spełniających określone kryteria wyszukiwania i zakres. Domyślnie (bez -First parametru) jest wyświetlanych pierwszych 100 obszarów roboczych przypisanych do użytkownika. Użyj opcji -First i -Skip, aby pobrać więcej obszarów roboczych lub użyć opcji -All, aby zwrócić wszystkie obszary robocze. Parametr -First może służyć do zwracania co najwyżej 5000 obszarów roboczych. Przed uruchomieniem tego polecenia upewnij się, że logujesz się przy użyciu polecenia Connect-PowerBIServiceAccount.

Przykłady

Przykład 1

PS C:\> Get-PowerBIWorkspace

Zwraca pierwsze 100 obszarów roboczych usługi Power BI przypisanych do użytkownika wywołującego (-Scope Individual).

Przykład 2

PS C:\> Get-PowerBIWorkspace -All

Zwraca wszystkie obszary robocze usługi Power BI przypisane do użytkownika wywołującego.

Przykład 3

PS C:\> Get-PowerBIWorkspace -Scope Organization -Filter "tolower(name) eq 'contoso sales'"

Zwraca obszar roboczy o nazwie "Contoso Sales" (bez uwzględniania wielkości liter z funkcją tolower) w organizacji użytkownika.

Przykład 3

PS C:\> Get-PowerBIWorkspace -Scope Organization -Include All

Zwraca wszystkie obszary robocze usługi Power BI wraz z powiązanymi raportami, pulpitami nawigacyjnymi, zestawami danych, przepływami danych i skoroszytami w organizacji użytkownika.

Parametry

-All

Wskazuje, aby wyświetlić wszystkie obszary robocze. -First i -Skip nie można używać z tym parametrem.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Deleted

Wskazuje, aby pokazywać tylko usunięte obszary robocze. Obsługiwane tylko wtedy, gdy określono wartość -Scope Organization.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Filtr OData, wielkość liter (nazwy elementów zaczynają się małymi literami).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-First

Pierwsza (górna) lista wyników. Ta wartość jest domyślnie 100.

Type:Int32
Aliases:Top
Position:Named
Default value:100
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Identyfikator obszaru roboczego do zwrócenia.

Type:Guid
Aliases:GroupId, WorkspaceId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Include

Pobiera powiązane artefakty skojarzone z obszarem roboczym usługi Power BI. Dostępne tylko wtedy, gdy -Scope to Organizacja.

Type:ArtifactType[]
Aliases:Expand
Accepted values:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nazwa obszaru roboczego, który ma być zwracany, jeśli istnieje o tej nazwie. Wyszukiwanie bez uwzględniania wielkości liter.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Orphaned

Wskazuje, aby pokazywać tylko oddzielone obszary robocze. Obsługiwane tylko wtedy, gdy określono wartość -Scope Organization.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Wskazuje zakres wywołania. Osoba zwraca tylko obszary robocze przypisane do elementu wywołującego; Organizacja zwraca wszystkie obszary robocze w ramach dzierżawy (musi być administratorem do zainicjowania). Osoba jest domyślna.

Type:PowerBIUserScope
Accepted values:Individual, Organization
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Skip

Pomija pierwszy zestaw wyników.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Typ obszaru roboczego do zwrócenia. Wyszukiwanie z uwzględnieniem wielkości liter.

Type:WorkspaceType
Accepted values:Workspace, Group, PersonalGroup
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-User

Filtruj obszary robocze, aby wyświetlić te, w których znajduje się użytkownik. Dostępne tylko wtedy, gdy -Scope to Organizacja.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

Dane wyjściowe

System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Workspaces.Workspace, Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]