Condividi tramite


Add-PowerBIWorkspaceUser

Concede le autorizzazioni a un utente specificato per accedere a un'area di lavoro di Power BI.

Sintassi

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

Descrizione

Concede le autorizzazioni a un utente specificato per accedere a un'area di lavoro di Power BI usando gli input e l'ambito specificati. Prima di eseguire questo comando, assicurarsi di accedere usando Connect-PowerBIServiceAccount.

Esempio

Esempio 1

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

Parametri

-AccessRight

Autorizzazioni da assegnare all'utente.

Tipo:WorkspaceUserAccessRight
Alias:UserAccessRight
Valori accettati:Member, Admin, Contributor, Viewer
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

ID dell'area di lavoro a cui deve essere aggiunto l'utente.

Tipo:Guid
Alias:GroupId, WorkspaceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Identifier

Identificatore dell'entità da aggiungere al gruppo. Per App e gruppi, questo sarà il relativo identificatore di oggetto (GUID). Per gli utenti, può trattarsi di un indirizzo di posta elettronica.

Tipo:String
Alias:PrincipalId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrincipalType

Tipo dell'entità da aggiungere al gruppo.

Tipo:WorkspaceUserPrincipalType
Valori accettati:App, Group, User
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Indica l'ambito della chiamata. I singoli operano solo su aree di lavoro assegnate al chiamante; L'organizzazione opera su tutte le aree di lavoro all'interno di un tenant (deve essere un amministratore per avviare). Individual è l'impostazione predefinita.

Tipo:PowerBIUserScope
Valori accettati:Individual, Organization
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserPrincipalName

Nome dell'entità utente (o UPN, in genere un indirizzo di posta elettronica) per l'utente le cui autorizzazioni devono essere aggiunte.

Tipo:String
Alias:UserEmailAddress
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Workspace

Entità dell'area di lavoro a cui aggiungere l'utente.

Tipo:Workspace
Alias:Group
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object