Set-PowerBIWorkspace

モジュール:
MicrosoftPowerBIMgmt.Workspaces Module

Power BI ワークスペースを更新します。

構文

Properties (既定) 

Set-PowerBIWorkspace
    -Id <Guid>
    [-Scope <PowerBIUserScope>]
    [-Name <String>]
    [-Description <String>]
    [<CommonParameters>]

Workspace 

Set-PowerBIWorkspace
    -Workspace <Workspace>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

Capacity 

Set-PowerBIWorkspace
    -Id <Guid>
    -CapacityId <Guid>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

説明

Power BI ワークスペースの名前または説明を更新します。 新しいワークスペース エクスペリエンス プレビューのワークスペースのみがサポートされます。 サポートされているのは -Scope 組織のみであり、このコマンドを呼び出すには、適切なアクセス許可またはロール (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
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Capacity
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Properties
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Id

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

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:グループID, WorkspaceId

パラメーター セット

Properties
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
Capacity
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Properties
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Scope

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

パラメーターのプロパティ

型:PowerBIUserScope
規定値:None
指定可能な値:Individual, Organization
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Workspace

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

パラメーターのプロパティ

型:Workspace
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:グループ

パラメーター セット

Workspace
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

None

出力

System.Object