Get-PowerBIWorkspace

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 parametru -First) jest wyświetlanych pierwszych 100 obszarów roboczych przypisanych do użytkownika. Użyj -First i -Skip, aby pobrać więcej obszarów roboczych lub użyć -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 Użytkownik indywidualny).

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 elementem 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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Deleted

Wskazuje, że mają być wyświetlane tylko usunięte obszary robocze. Obsługiwane tylko w przypadku określenia organizacji -Scope.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Filter

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

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-First

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

Typ:	Int32
Aliasy:	Top
Position:	Named
Domyślna wartość:	100
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Id

Identyfikator obszaru roboczego do zwrócenia.

Typ:	Guid
Aliasy:	GroupId, WorkspaceId
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Include

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

Typ:	ArtifactType[]
Aliasy:	Expand
Dopuszczalne wartości:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Name

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

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Orphaned

Wskazuje, aby pokazywać tylko oddzielone obszary robocze. Obsługiwane tylko w przypadku określenia organizacji -Scope.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Scope

Wskazuje zakres wywołania. Osoba zwraca tylko obszary robocze przypisane do wywołującego; Organizacja zwraca wszystkie obszary robocze w dzierżawie (musi być administratorem do zainicjowania). Jednostka jest wartością domyślną.

Typ:	PowerBIUserScope
Dopuszczalne wartości:	Individual, Organization
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Skip

Pomija pierwszy zestaw wyników.

Typ:	Int32
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Type

Typ obszaru roboczego do zwrócenia. Wyszukiwanie uwzględniające wielkość liter.

Typ:	WorkspaceType
Dopuszczalne wartości:	Workspace, Group, PersonalGroup
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-User

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

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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]]