Get-PowerBIWorkspace

Modül:

MicrosoftPowerBIMgmt.Workspaces Module

Returns a list of Power BI workspaces.

Sözdizimi

List EnterprisePublishing

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

Description

Retrieves a list of Power BI workspaces that match the specified search criteria and scope. By default (without -First parameter) it shows the first 100 workspaces assigned to the user. Use -First and -Skip to fetch more workspaces or use -All to return all workspaces. The -First parameter can be used to return at most 5000 workspaces. Before you run this command, make sure you log in using Connect-PowerBIServiceAccount.

Örnekler

Example 1

PS C:\> Get-PowerBIWorkspace

Returns the first 100 Power BI workspaces the calling user is assigned to (-Scope Individual).

Example 2

PS C:\> Get-PowerBIWorkspace -All

Returns all Power BI workspaces the calling user is assigned to.

Example 3

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

Returns a workspace named 'Contoso Sales' (case insensitive with tolower) within the user's organization.

Example 3

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

Returns all Power BI workspaces along with related reports, dashboards, datasets, dataflows and workbooks within the user's organization.

Parametreler

-All

Indicates to show all the workspaces. -First and -Skip cannot be used with this parameter.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

All

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Deleted

Indicates to show only deleted workspaces. Only supported when -Scope Organization is specified.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

All

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Filter

OData filter, case-sensitive (element names start lowercase).

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

All

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-First

First (top) list of results. This value defaults to 100.

Parametre özellikleri

Tür:	Int32
Default value:	100
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Top

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Id

ID of the workspace to return.

Parametre özellikleri

Tür:	Guid
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	GroupId, WorkspaceId

Parametre kümeleri

Id

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Include

Retrieves related artifacts associated with the Power BI workspace. Only available when -Scope is Organization.

Parametre özellikleri

Tür:	ArtifactType[]
Default value:	None
Kabul edilen değerler:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Expand

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Name

Name of the workspace to return if one exists with that name. Case insensitive search.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

Name

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Orphaned

Indicates to show only orphaned workspaces. Only supported when -Scope Organization is specified.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

All

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Scope

Indicates scope of the call. Individual returns only workspaces assigned to the caller; Organization returns all workspaces within a tenant (must be an administrator to initiate). Individual is the default.

Parametre özellikleri

Tür:	PowerBIUserScope
Default value:	None
Kabul edilen değerler:	Individual, Organization
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Skip

Skips the first set of results.

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-Type

Type of the workspace to return. Case sensitive search.

Parametre özellikleri

Tür:	WorkspaceType
Default value:	None
Kabul edilen değerler:	Workspace, Group, PersonalGroup
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

Name

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

Id

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

All

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

-User

Filter workspaces to show ones which the user is contained within. Only available when -Scope is Organization.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

List

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

All

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
İşlem hattından özellik adına göre değer:	False
Kalan argümanlardan elde edilen değer:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Girişler

None

Çıkışlar

System.Collections.Generic.IEnumerable`1