Add-PowerBIWorkspaceUser
指定したユーザーに 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
ユーザーに割り当てるアクセス許可。
型: | WorkspaceUserAccessRight |
Aliases: | UserAccessRight |
指定可能な値: | Member, Admin, Contributor, Viewer |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
ユーザーを追加するワークスペースの ID。
型: | Guid |
Aliases: | GroupId, WorkspaceId |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Identifier
グループに追加するプリンシパルの識別子。 アプリとグループの場合、これはオブジェクト識別子 (GUID) になります。 ユーザーの場合、これは電子メール アドレスにすることができます。
型: | String |
Aliases: | PrincipalId |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PrincipalType
グループに追加するプリンシパルの種類。
型: | WorkspaceUserPrincipalType |
指定可能な値: | App, Group, User |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Scope
呼び出しのスコープを示します。 個々の操作は、呼び出し元に割り当てられたワークスペースに対してのみ行われます。組織は、テナント内のすべてのワークスペースに対して動作します (開始するには管理者である必要があります)。 既定値は [個人] です。
型: | PowerBIUserScope |
指定可能な値: | Individual, Organization |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserPrincipalName
アクセス許可を追加する必要があるユーザーのユーザー プリンシパル名 (UPN、通常は電子メール アドレス)。
型: | String |
Aliases: | UserEmailAddress |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Workspace
ユーザーを追加するワークスペース エンティティ。
型: | Workspace |
Aliases: | Group |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object