Get-PowerBIWorkspace

Modul:

MicrosoftPowerBIMgmt.Workspaces

Vrátí seznam pracovních prostorů Power BI.

Syntax

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

Description

Načte seznam pracovních prostorů Power BI, které odpovídají zadaným kritériím a rozsahu hledání. Ve výchozím nastavení (bez parametru -First) zobrazuje prvních 100 pracovních prostorů přiřazených uživateli. Pomocí příkazu -First and -Skip můžete načíst více pracovních prostorů nebo použít -All k vrácení všech pracovních prostorů. Parametr -First se dá použít k vrácení maximálně 5000 pracovních prostorů. Před spuštěním tohoto příkazu se ujistěte, že se přihlásíte pomocí Connect-PowerBIServiceAccount.

Příklady

Příklad 1

PS C:\> Get-PowerBIWorkspace

Vrátí prvních 100 pracovních prostorů Power BI, ke kterým je volající uživatel přiřazen (-Scope Individual).

Příklad 2

PS C:\> Get-PowerBIWorkspace -All

Vrátí všechny pracovní prostory Power BI, ke kterým je volající uživatel přiřazen.

Příklad 3

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

Vrátí pracovní prostor s názvem Contoso Sales (nerozlišující malá a malá písmena s tolowerem) v organizaci uživatele.

Příklad 3

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

Vrátí všechny pracovní prostory Power BI spolu se souvisejícími sestavami, řídicími panely, datovými sadami, toky dat a sešity v organizaci uživatele.

Parametry

-All

Označuje, že se mají zobrazit všechny pracovní prostory. -First and -Skip nelze použít s tímto parametrem.

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

-Deleted

Označuje, že se mají zobrazit jenom odstraněné pracovní prostory. Podporuje se pouze v případě, že je zadána organizace rozsahu.

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

-Filter

Filtr OData, rozlišující velká a malá písmena (názvy elementů začínají malými písmeny).

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

-First

První (horní) seznam výsledků Tato hodnota má výchozí hodnotu 100.

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

-Id

ID pracovního prostoru, který se má vrátit.

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

-Include

Načte související artefakty přidružené k pracovnímu prostoru Power BI. K dispozici pouze v případě, že je -Scope organizace.

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

Název pracovního prostoru, který se má vrátit, pokud s tímto názvem existuje. Vyhledávání nerozlišuje malá a velká písmena.

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

-Orphaned

Označuje, že se mají zobrazit jenom osamocené pracovní prostory. Podporuje se pouze v případě, že je zadána organizace rozsahu.

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

-Scope

Označuje rozsah volání. Jednotlivé vrátí pouze pracovní prostory přiřazené volajícímu; Organizace vrátí všechny pracovní prostory v rámci tenanta (musí být správcem, který se má zahájit). Jednotlivec je výchozí.

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

-Skip

Přeskočí první sadu výsledků.

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

-Type

Typ pracovního prostoru, který se má vrátit. Hledání s rozlišováním velkých a velkých písmen

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

-User

Vyfiltrujte pracovní prostory tak, aby zobrazovaly ty, které uživatel obsahuje. K dispozici pouze v případě, že je -Scope organizace.

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

Vstupy

None

Výstupy

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