Add-PowerBIWorkspaceUser

リファレンス

モジュール:: MicrosoftPowerBIMgmt.Workspaces

Power BI ワークスペースにアクセスするためのアクセス許可を指定したユーザーに付与します。

構文

Add-PowerBIWorkspaceUser
   [-Scope <PowerBIUserScope>]
   -Id <Guid>
   -UserPrincipalName <String>
   -AccessRight <WorkspaceUserAccessRight>
   [<CommonParameters>]

Add-PowerBIWorkspaceUser
   [-Scope <PowerBIUserScope>]
   -Id <Guid>
   -AccessRight <WorkspaceUserAccessRight>
   -PrincipalType <WorkspaceUserPrincipalType>
   -Identifier <String>
   [<CommonParameters>]

Add-PowerBIWorkspaceUser
   [-Scope <PowerBIUserScope>]
   -UserPrincipalName <String>
   -AccessRight <WorkspaceUserAccessRight>
   -Workspace <Workspace>
   [<CommonParameters>]

Add-PowerBIWorkspaceUser
   [-Scope <PowerBIUserScope>]
   -AccessRight <WorkspaceUserAccessRight>
   -Workspace <Workspace>
   -PrincipalType <WorkspaceUserPrincipalType>
   -Identifier <String>
   [<CommonParameters>]

説明

指定された入力とスコープを使用して Power BI ワークスペースにアクセスするためのアクセス許可を、指定されたユーザーに付与します。このコマンドを実行する前に、Connect-PowerBIServiceAccount を使用してログインしていることを確認してください。

例

例 1

PS C:\> Add-PowerBIWorkspaceUser -Scope Organization -Id 23FCBDBD-A979-45D8-B1C8-6D21E0F4BE50 -UserEmailAddress john@contoso.com -AccessRight Admin

パラメーター

-AccessRight

ユーザーに割り当てるアクセス許可。

Type:	WorkspaceUserAccessRight
Aliases:	UserAccessRight
Accepted values:	Member, Admin, Contributor, Viewer
Position:	Named
Default value:	None
Required:	True
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

-Identifier

グループに追加するプリンシパルの識別子。アプリとグループの場合、これはオブジェクト識別子 (GUID) になります。ユーザーの場合は、電子メールアドレスを指定できます。

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

-PrincipalType

グループに追加するプリンシパルの種類。

Type:	WorkspaceUserPrincipalType
Accepted values:	App, Group, User
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

呼び出しのスコープを示します。個人は、呼び出し元に割り当てられたワークスペースのみに対して動作します。組織は、テナント内のすべてのワークスペースに対して動作します (開始するには管理者である必要があります)。 [個人] が既定値です。

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

-UserPrincipalName

アクセス許可を追加する必要があるユーザーのユーザープリンシパル名 (または UPN、一般的に電子メールアドレス)。

Type:	String
Aliases:	UserEmailAddress
Position:	Named
Default value:	None
Required:	True
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

次の方法で共有