지정된 검색 조건 및 범위와 일치하는 Power BI 작업 영역 목록을 검색합니다.
기본적으로 -First 매개 변수가 없으면 사용자에게 할당된 처음 100개의 작업 영역이 표시됩니다. -First 및 -Skip 사용하여 더 많은 작업 영역을 가져오거나 -All 사용하여 모든 작업 영역을 반환합니다. -First 매개 변수는 최대 5,000개의 작업 영역을 반환하는 데 사용할 수 있습니다.
이 명령을 실행하기 전에 Connect-PowerBIServiceAccount를 사용하여 로그인해야 합니다.
예제
예제 1
PS C:\> Get-PowerBIWorkspace
호출하는 사용자가 할당된 처음 100개의 Power BI 작업 영역(-Scope Individual)을 반환합니다.
사용자 조직 내에서 '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를 참조하세요.