Set-PowerBIWorkspace

참조

모듈:: MicrosoftPowerBIMgmt.Workspaces

Power BI 작업 영역을 업데이트.

Syntax

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-00000000000000"으로 설정된 경우 작업 영역은 공유 용량으로 마이그레이션됩니다.

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

-Description

업데이트할 작업 영역에 제공할 새 설명입니다.

Type:	String
Position:	Named
Default value:	None
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:	True
Accept wildcard characters:	False

-Name

업데이트할 작업 영역에 제공할 새 이름입니다. 이름이 조직의 다른 작업 영역과 일치하면 업데이트 작업이 실패합니다.

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

-Scope

호출 범위를 나타냅니다. 이 cmdlet에서는 조직만 지원됩니다. 조직은 테넌트 내의 모든 작업 영역에 대해 작동합니다(시작하려면 관리자여야 합니다). 개인은 기본값입니다.

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

-Workspace

업데이트할 작업 영역 엔터티입니다. 작업 영역은 개체의 이름 및 설명으로 업데이트됩니다.

Type:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

입력

None

출력

System.Object

다음을 통해 공유