Set-PowerBIWorkspace
Power BI 작업 영역을 업데이트합니다.
구문
Set-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
-Id <Guid>
[-Name <String>]
[-Description <String>]
[<CommonParameters>] Set-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
-Workspace <Workspace>
[<CommonParameters>] Set-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
-Id <Guid>
-CapacityId <Guid>
[<CommonParameters>] Description
Power BI 작업 영역의 이름 또는 설명을 업데이트합니다. 새 작업 영역 환경 미리 보기의 작업 영역만 지원됩니다. -Scope 조직만 지원되며 이 명령을 호출하려면 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있어야 합니다. 이 명령을 실행하기 전에 Connect-PowerBIServiceAccount를 사용하여 로그인해야 합니다.
예제
예제 1
PS C:\> Set-PowerBIWorkspace -Scope Organization -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -Name "Test Name" -Description "Test Description"현재 사용자가 관리자인 경우 지정된 ID와 일치하는 작업 영역을 호출자 조직의 작업 영역에 대해 지정된 이름 및 설명 값으로 업데이트합니다.
예제 2
PS C:\> $workspaces = Get-PowerBIWorkspace -Scope Organization
PS C:\> $workspace = $workspaces[0]
PS C:\> $workspace.Name = "Test Name"
PS C:\> $workspace.Description = "Test Description"
PS C:\> Set-PowerBIWorkspace -Scope Organization -Workspace $workspace현재 사용자가 관리자인 경우 지정된 작업 영역 개체를 호출자 조직의 작업 영역에 대해 지정된 이름 및 설명 값으로 업데이트합니다.
매개 변수
-CapacityId
작업 영역이 할당될 용량 개체 ID입니다. CapacityId가 "000000000-0000-0000-0000-000000000000000"으로 설정된 경우 작업 영역은 공유 용량으로 마이그레이션됩니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
업데이트할 작업 영역에 제공할 새 설명입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Id
업데이트할 작업 영역의 ID입니다.
| 형식: | Guid |
| 별칭: | GroupId, WorkspaceId |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
업데이트할 작업 영역에 제공할 새 이름입니다. 이름이 조직의 다른 작업 영역과 일치하면 업데이트 작업이 실패합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Scope
호출 범위를 나타냅니다. 이 cmdlet에서는 조직만 지원됩니다. 조직은 테넌트 내의 모든 작업 영역에 대해 작동합니다(시작하려면 관리자여야 합니다). 개인은 기본값입니다.
| 형식: | PowerBIUserScope |
| 허용되는 값: | Individual, Organization |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Workspace
업데이트할 작업 영역 엔터티입니다. 작업 영역은 개체의 이름 및 설명으로 업데이트됩니다.
| 형식: | Workspace |
| 별칭: | Group |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
System.Object