Partilhar via

Add-PowerBIWorkspaceUser

Módulo:
MicrosoftPowerBIMgmt.Workspaces Module

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

Sintaxe

UserEmailWithId (Predefinição) 

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

Propriedades dos parâmetros

Tipo:WorkspaceUserAccessRight
Default value:None
Valores aceites:Member, Admin, Contributor, Viewer
Suporta carateres universais:False
NãoMostrar:False
Aliases:UserAccessRight

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Id

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

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Id do Grupo, WorkspaceId

Conjuntos de parâmetros

UserEmailWithId
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
PrincipalTypeWithId
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:PrincipalId

Conjuntos de parâmetros

PrincipalTypeWithId
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PrincipalTypeWithWorkspace
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PrincipalType

O tipo do principal a ser adicionado ao grupo.

Propriedades dos parâmetros

Tipo:WorkspaceUserPrincipalType
Default value:None
Valores aceites:App, Group, User
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

PrincipalTypeWithId
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PrincipalTypeWithWorkspace
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PowerBIUserScope
Default value:None
Valores aceites:Individual, Organization
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:UserEmailAddress

Conjuntos de parâmetros

UserEmailWithId
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
UserEmailWithWorkspace
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Workspace

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

Propriedades dos parâmetros

Tipo:Workspace
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Grupo

Conjuntos de parâmetros

UserEmailWithWorkspace
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
PrincipalTypeWithWorkspace
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

System.Object