Get-PowerBIWorkspace
Vrátí seznam pracovních prostorů Power BI.
Syntaxe
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 oboru hledání. Ve výchozím nastavení (bez parametru -First) zobrazuje prvních 100 pracovních prostorů přiřazených uživateli. Pomocí -First a -Skip můžete načíst více pracovních prostorů nebo použít -All k vrácení všech pracovních prostorů. Parametr -First lze použít k vrácení maximálně 5 000 pracovních prostorů. Před spuštěním tohoto příkazu se ujistěte, že se přihlašujete 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 jednotlivce).
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 velká 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 a -Skip nelze s tímto parametrem použít.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Deleted
Označuje, že se mají zobrazit jenom odstraněné pracovní prostory. Podporuje se pouze při zadání -Scope organizace.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Filter
Filtr OData, rozlišují se malá a velká písmena (názvy elementů začínají malými písmeny).
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-First
První (horní) seznam výsledků Tato hodnota je ve výchozím nastavení 100.
Typ: | Int32 |
Aliasy: | Top |
Position: | Named |
Default value: | 100 |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Id
ID pracovního prostoru, který se má vrátit.
Typ: | Guid |
Aliasy: | GroupId, WorkspaceId |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Include
Načte související artefakty přidružené k pracovnímu prostoru Power BI. K dispozici pouze v případech, kdy -Scope je organizace.
Typ: | ArtifactType[] |
Aliasy: | Expand |
Přípustné hodnoty: | Reports, Dashboards, Datasets, Dataflows, Workbooks, All |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Name
Název pracovního prostoru, který se má vrátit, pokud existuje s tímto názvem. Vyhledávání bez rozlišování velkých a malých písmen
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Orphaned
Označuje, že se mají zobrazit pouze osamocené pracovní prostory. Podporuje se pouze při zadání -Scope organizace.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Scope
Označuje rozsah volání. Jednotlivec 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í.
Typ: | PowerBIUserScope |
Přípustné hodnoty: | Individual, Organization |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Skip
Přeskočí první sadu výsledků.
Typ: | Int32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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
Typ: | WorkspaceType |
Přípustné hodnoty: | Workspace, Group, PersonalGroup |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-User
Vyfiltrujte pracovní prostory tak, aby zobrazovaly ty, které uživatel obsahuje. K dispozici pouze v případech, kdy -Scope je organizace.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | 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]]