다음을 통해 공유

Get-PowerBIWorkspace

  • 참조
모듈:
MicrosoftPowerBIMgmt.Workspaces

Power BI 작업 영역 목록을 반환합니다.

구문

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 이 매개 변수와 함께 사용할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Deleted

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Filter

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-First

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

형식:Int32
별칭:Top
Position:Named
Default value:100
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

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

형식:Guid
별칭:GroupId, WorkspaceId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Include

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

형식:ArtifactType[]
별칭:Expand
허용되는 값:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Orphaned

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Scope

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

형식:PowerBIUserScope
허용되는 값:Individual, Organization
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Skip

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

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Type

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

형식:WorkspaceType
허용되는 값:Workspace, Group, PersonalGroup
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-User

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용: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]]