Add-PowerBIWorkspaceUser

Referência

Módulo:: MicrosoftPowerBIMgmt.Workspaces

Concede permissões a um usuário especificado para acessar um espaço de trabalho do Power BI.

Sintaxe

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 usuário especificado para acessar um espaço de trabalho do Power BI usando as entradas fornecidas e o escopo especificado. Antes de executar este comando, certifique-se de que inicia sessão utilizando 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 usuário.

Tipo:	WorkspaceUserAccessRight
Aliases:	UserAccessRight
Valores aceites:	Member, Admin, Contributor, Viewer
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Id

ID do espaço de trabalho ao qual o usuário deve ser adicionado.

Tipo:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Identifier

Identificador do principal a ser adicionado ao grupo. Para Aplicativos e Grupos, esse será o identificador de objeto (GUID). Para os utilizadores, este pode ser um endereço de e-mail.

Tipo:	String
Aliases:	PrincipalId
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-PrincipalType

O tipo do principal a ser adicionado ao grupo.

Tipo:	WorkspaceUserPrincipalType
Valores aceites:	App, Group, User
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Scope

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

Tipo:	PowerBIUserScope
Valores aceites:	Individual, Organization
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-UserPrincipalName

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

Tipo:	String
Aliases:	UserEmailAddress
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Workspace

A entidade do espaço de trabalho à qual adicionar o usuário.

Tipo:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

System.Object

Partilhar via