Get-PowerBIWorkspace

Moduł:

MicrosoftPowerBIMgmt.Workspaces Module

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

Składnia

List (Domyślna)

Get-PowerBIWorkspace
    [-Scope <PowerBIUserScope>]
    [-Filter <String>]
    [-User <String>]
    [-Deleted]
    [-Orphaned]
    [-Type <WorkspaceType>]
    [-First <Int32>]
    [-Skip <Int32>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

Id

Get-PowerBIWorkspace
    -Id <Guid>
    [-Scope <PowerBIUserScope>]
    [-Type <WorkspaceType>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

Name

Get-PowerBIWorkspace
    -Name <String>
    [-Scope <PowerBIUserScope>]
    [-Type <WorkspaceType>]
    [-Include <ArtifactType[]>]
    [<CommonParameters>]

All

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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

All

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Deleted

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

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

All

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Filter

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

All

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-First

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

Właściwości parametru

Typ:	Int32
Domyślna wartość:	100
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Do góry

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Id

Identyfikator obszaru roboczego do zwrócenia.

Właściwości parametru

Typ:	Guid
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Identyfikator grupy, Identyfikator obszaru roboczego

Zestawy parametrów

Id

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Include

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

Właściwości parametru

Typ:	ArtifactType[]
Domyślna wartość:	None
Dopuszczalne wartości:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Rozwiń

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Name

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

Name

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Orphaned

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

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

All

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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ą.

Właściwości parametru

Typ:	PowerBIUserScope
Domyślna wartość:	None
Dopuszczalne wartości:	Individual, Organization
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Skip

Pomija pierwszy zestaw wyników.

Właściwości parametru

Typ:	Int32
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Type

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

Właściwości parametru

Typ:	WorkspaceType
Domyślna wartość:	None
Dopuszczalne wartości:	Workspace, Group, PersonalGroup
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

Name

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

Id

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

All

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-User

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

List

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

All

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

System.Collections.Generic.IEnumerable`1