Get-PowerBIWorkspace

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

구문

List (기본값)

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

지정된 검색 조건 및 범위와 일치하는 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
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

All
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Deleted

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
All
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Filter

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
All
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-First

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

매개 변수 속성

형식:Int32
Default value:100
와일드카드 지원:False
DontShow:False
별칭:최상위

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Id

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

매개 변수 속성

형식:Guid
Default value:None
와일드카드 지원:False
DontShow:False
별칭:그룹ID, WorkspaceId

매개 변수 집합

Id
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Include

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

매개 변수 속성

형식:

ArtifactType[]

Default value:None
허용되는 값:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
와일드카드 지원:False
DontShow:False
별칭:확장하다

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

Name
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Orphaned

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
All
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Scope

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

매개 변수 속성

형식:PowerBIUserScope
Default value:None
허용되는 값:Individual, Organization
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Skip

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

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Type

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

매개 변수 속성

형식:WorkspaceType
Default value:None
허용되는 값:Workspace, Group, PersonalGroup
와일드카드 지원:False
DontShow:False

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Name
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
Id
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
All
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-User

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

List
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
All
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

System.Collections.Generic.IEnumerable`1