Set-PowerBIWorkspace

參考

模組:: MicrosoftPowerBIMgmt.Workspaces

更新 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"

如果目前的使用者是系統管理員，這會更新工作區，以呼叫端組織中工作區的指定名稱和描述值，比對指定的標識符。

範例 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

將指派工作區的容量物件標識碼。如果 CapacityId 設定為 “00000000-0000-0000-0000-00000000000000”，工作區將會移轉至共用容量。

類型:	Guid
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Description

要提供給工作區更新的新描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

要更新的工作區標識碼。

類型:	Guid
別名:	GroupId, WorkspaceId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Name

要提供給工作區更新的新名稱。如果名稱符合組織中的另一個工作區，更新作業將會失敗。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Scope

表示呼叫的範圍。此 Cmdlet 僅支持組織。組織會針對租使用者內的所有工作區運作（必須是系統管理員才能起始）。個人是預設值。

類型:	PowerBIUserScope
接受的值:	Individual, Organization
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Workspace

要更新的工作區實體。工作區將會以對象的名稱和描述來更新。

類型:	Workspace
別名:	Group
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

System.Object

共用方式為