Get-PowerBIWorkspace

모듈:

MicrosoftPowerBIMgmt.Workspaces

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

지정된 검색 조건 및 범위와 일치하는 Power BI 작업 영역 목록을 검색합니다. 기본적으로 (-First 매개 변수 제외) 사용자에게 할당된 처음 100개의 작업 영역이 표시됩니다. -First 및 -Skip을 사용하여 더 많은 작업 영역을 가져오거나 -All을 사용하여 모든 작업 영역을 반환합니다. -First 매개 변수는 최대 5,000개의 작업 영역을 반환하는 데 사용할 수 있습니다. 이 명령을 실행하기 전에 Connect-PowerBIServiceAccount를 사용하여 로그인해야 합니다.

예제

예 1

PS C:\> Get-PowerBIWorkspace

호출하는 사용자가 할당된 처음 100개의 Power BI 작업 영역(-Scope Individual)을 반환합니다.

예제 2

PS C:\> Get-PowerBIWorkspace -All

호출하는 사용자가 할당된 모든 Power BI 작업 영역을 반환합니다.

예제 3

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

사용자 조직 내에서 'Contoso Sales'(tolower와 대/소문자를 구분하지 않는 경우)라는 작업 영역을 반환합니다.

예제 3

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

사용자 조직 내의 관련 보고서, 대시보드, 데이터 세트, 데이터 흐름 및 통합 문서와 함께 모든 Power BI 작업 영역을 반환합니다.

매개 변수

-All

모든 작업 영역을 표시하도록 나타냅니다. -First 및 -Skip은 이 매개 변수와 함께 사용할 수 없습니다.

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

-Deleted

삭제된 작업 영역만 표시하도록 나타냅니다. -Scope Organization이 지정된 경우에만 지원됩니다.

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

-Filter

OData 필터, 대/소문자 구분(요소 이름 시작 소문자).

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

-First

결과의 첫 번째(위쪽) 목록입니다. 이 값은 기본적으로 100입니다.

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

-Id

반환할 작업 영역의 ID입니다.

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

-Include

Power BI 작업 영역과 연결된 관련 아티팩트 검색 -Scope가 조직인 경우에만 사용할 수 있습니다.

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

해당 이름을 가진 작업 영역이 있는 경우 반환할 작업 영역의 이름입니다. 대/소문자를 구분하지 않는 검색입니다.

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

-Orphaned

분리된 작업 영역만 표시하도록 나타냅니다. -Scope Organization이 지정된 경우에만 지원됩니다.

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

-Scope

호출 범위를 나타냅니다. 개별은 호출자에게 할당된 작업 영역만 반환합니다. 조직은 테넌트 내의 모든 작업 영역을 반환합니다(시작하려면 관리자여야 합니다). 개인은 기본값입니다.

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

-Skip

첫 번째 결과 집합을 건너뜁니다.

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

-Type

반환할 작업 영역의 형식입니다. 대/소문자를 구분하는 검색입니다.

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

-User

작업 영역을 필터링하여 사용자가 포함된 작업 영역을 표시합니다. -Scope가 조직인 경우에만 사용할 수 있습니다.

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

입력

None

출력

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