Partilhar via


Add-PowerBIWorkspaceUser

Dá permissões a um utilizador especificado para aceder a um espaço de trabalho Power BI.

Syntax

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 permissões a um utilizador especificado para aceder a um espaço de trabalho Power BI utilizando as entradas e âmbito fornecidos especificados. Antes de executar este comando, certifique-se de que inicia sessão utilizando o Connect-PowerBIServiceAccount.

Exemplos

Exemplo 1

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

Parâmetros

-AccessRight

Permissões para atribuir ao utilizador.

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 do espaço de trabalho a que o utilizador deve ser adicionado.

Type:Guid
Aliases:GroupId, WorkspaceId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Identifier

Identificador do principal para adicionar ao grupo. Para apps e grupos, este será o seu identificador de objetos (GUID). Para os utilizadores, este pode ser um endereço de e-mail.

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

-PrincipalType

O tipo de principal a adicionar ao grupo.

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

-Scope

Indica o alcance da chamada. O indivíduo opera contra apenas espaços de trabalho atribuídos ao chamador; A organização opera contra todos os espaços de trabalho dentro de um inquilino (deve ser um administrador para iniciar). Individual é o padrão.

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

-UserPrincipalName

Nome Principal do Utilizador (ou UPN, geralmente um endereço de e-mail) para o utilizador cujas permissões precisam de ser adicionadas.

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

-Workspace

A entidade do espaço de trabalho para adicionar o utilizador.

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

Entradas

None

Saídas

System.Object