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 Organization のみがサポートされており、このコマンドを呼び出すには管理者権限 (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" に設定されている場合、ワークスペースは共有容量に移行されます。

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

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

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

次の方法で共有