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>]

説明

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-0000000000000" に設定されている場合、ワークスペースは共有容量に移行されます。

型:	Guid
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

更新するワークスペースに指定する新しい説明。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

更新するワークスペースの ID。

型:	Guid
Aliases:	GroupId, WorkspaceId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-Name

更新するワークスペースに付ける新しい名前。名前が組織内の別のワークスペースと一致する場合、更新操作は失敗します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Scope

呼び出しのスコープを示します。このコマンドレットでは、Organization のみがサポートされています。組織は、テナント内のすべてのワークスペースに対して動作します (開始するには管理者である必要があります)。既定値は [個人] です。

型:	PowerBIUserScope
指定可能な値:	Individual, Organization
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Workspace

更新するワークスペースエンティティ。ワークスペースは、オブジェクトの名前と説明で更新されます。

型:	Workspace
Aliases:	Group
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

System.Object

次の方法で共有