Add-PowerBIWorkspaceUser

Referencia

Módulo:: MicrosoftPowerBIMgmt.Workspaces

Concede permisos a un usuario especificado para acceder a un área de trabajo de Power BI.

Sintaxis

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

Description

Concede permisos a un usuario especificado para acceder a un área de trabajo de Power BI mediante las entradas y el ámbito proporcionados especificados. Antes de ejecutar este comando, asegúrese de iniciar sesión con Connect-PowerBIServiceAccount.

Ejemplos

Ejemplo 1

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

Parámetros

-AccessRight

Permisos para asignar al usuario.

Tipo:	WorkspaceUserAccessRight
Alias:	UserAccessRight
Valores aceptados:	Member, Admin, Contributor, Viewer
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Id

Id. del área de trabajo a la que se debe agregar el usuario.

Tipo:	Guid
Alias:	GroupId, WorkspaceId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Identifier

Identificador de la entidad de seguridad que se va a agregar al grupo. En el caso de las aplicaciones y los grupos, este será su identificador de objeto (GUID). Para los usuarios, puede ser una dirección de correo electrónico.

Tipo:	String
Alias:	PrincipalId
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PrincipalType

Tipo de la entidad de seguridad que se va a agregar al grupo.

Tipo:	WorkspaceUserPrincipalType
Valores aceptados:	App, Group, User
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Scope

Indica el ámbito de la llamada. Individual funciona solo con áreas de trabajo asignadas al autor de la llamada; La organización funciona con todas las áreas de trabajo de un inquilino (debe ser un administrador para iniciar). Individual es el valor predeterminado.

Tipo:	PowerBIUserScope
Valores aceptados:	Individual, Organization
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserPrincipalName

Nombre principal de usuario (o UPN, normalmente una dirección de correo electrónico) para el usuario cuyos permisos deben agregarse.

Tipo:	String
Alias:	UserEmailAddress
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Workspace

Entidad del área de trabajo a la que se va a agregar el usuario.

Tipo:	Workspace
Alias:	Group
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

System.Object

Compartir a través de