Condividi tramite

Add-PowerBIWorkspaceUser

Modulo:
MicrosoftPowerBIMgmt.Workspaces Module

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

Sintassi

UserEmailWithId (Impostazione predefinita) 

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

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.

Proprietà dei parametri

Tipo:WorkspaceUserAccessRight
Valore predefinito:None
Valori accettati:Member, Admin, Contributor, Viewer
Supporta i caratteri jolly:False
DontShow:False
Alias:UserAccessRight

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

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

Proprietà dei parametri

Tipo:Guid
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ID del Gruppo, WorkspaceId

Set di parametri

UserEmailWithId
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False
PrincipalTypeWithId
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:ID principale

Set di parametri

PrincipalTypeWithId
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
PrincipalTypeWithWorkspace
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PrincipalType

Tipo dell'entità da aggiungere al gruppo.

Proprietà dei parametri

Tipo:WorkspaceUserPrincipalType
Valore predefinito:None
Valori accettati:App, Group, User
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

PrincipalTypeWithId
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
PrincipalTypeWithWorkspace
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:PowerBIUserScope
Valore predefinito:None
Valori accettati:Individual, Organization
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UserPrincipalName

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:UserEmailAddress

Set di parametri

UserEmailWithId
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
UserEmailWithWorkspace
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Workspace

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

Proprietà dei parametri

Tipo:Workspace
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Gruppo

Set di parametri

UserEmailWithWorkspace
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
PrincipalTypeWithWorkspace
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Output

System.Object