Compartir a través de

Add-PowerBIWorkspaceUser

Módulo:
MicrosoftPowerBIMgmt.Workspaces Module

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

Sintaxis

UserEmailWithId (Es el valor predeterminado). 

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

PrincipalTypeWithId 

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

UserEmailWithWorkspace 

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

PrincipalTypeWithWorkspace 

Add-PowerBIWorkspaceUser
    -AccessRight <WorkspaceUserAccessRight>
    -Workspace <Workspace>
    -PrincipalType <WorkspaceUserPrincipalType>
    -Identifier <String>
    [-Scope <PowerBIUserScope>]
    [<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.

Propiedades del parámetro

Tipo:WorkspaceUserAccessRight
Valor predeterminado:None
Valores aceptados:Member, Admin, Contributor, Viewer
Admite caracteres comodín:False
DontShow:False
Alias:UserAccessRight

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

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

Propiedades del parámetro

Tipo:Guid
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:IdentificadorDeGrupo, WorkspaceId

Conjuntos de parámetros

UserEmailWithId
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
PrincipalTypeWithId
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PrincipalId

Conjuntos de parámetros

PrincipalTypeWithId
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
PrincipalTypeWithWorkspace
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PrincipalType

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

Propiedades del parámetro

Tipo:WorkspaceUserPrincipalType
Valor predeterminado:None
Valores aceptados:App, Group, User
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

PrincipalTypeWithId
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
PrincipalTypeWithWorkspace
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:PowerBIUserScope
Valor predeterminado:None
Valores aceptados:Individual, Organization
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-UserPrincipalName

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Dirección de correo electrónico del usuario

Conjuntos de parámetros

UserEmailWithId
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
UserEmailWithWorkspace
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Workspace

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

Propiedades del parámetro

Tipo:Workspace
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Grupo

Conjuntos de parámetros

UserEmailWithWorkspace
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
PrincipalTypeWithWorkspace
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

System.Object