Add-PowerBIWorkspaceUser

Nadaje określonemu użytkownikowi uprawnienia dostępu do obszaru roboczego usługi Power BI.

Składnia

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

Opis

Przyznaje określonemu użytkownikowi uprawnienia dostępu do obszaru roboczego usługi Power BI przy użyciu podanych danych wejściowych i określonego zakresu. Przed uruchomieniem tego polecenia upewnij się, że logujesz się przy użyciu polecenia Connect-PowerBIServiceAccount.

Przykłady

Przykład 1

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

Parametry

-AccessRight

Uprawnienia do przypisywania do użytkownika.

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

Identyfikator obszaru roboczego, do który należy dodać użytkownika.

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

-Identifier

Identyfikator podmiotu zabezpieczeń, który ma zostać dodany do grupy. W przypadku aplikacji i grup będzie to identyfikator obiektu (GUID). W przypadku użytkowników może to być adres e-mail.

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

-PrincipalType

Typ podmiotu zabezpieczeń, który ma zostać dodany do grupy.

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

-Scope

Wskazuje zakres wywołania. Poszczególne operacje są wykonywane tylko w obszarach roboczych przypisanych do elementu wywołującego; Organizacja działa w odniesieniu do wszystkich obszarów roboczych w ramach dzierżawy (musi być administratorem do zainicjowania). Jednostka jest wartością domyślną.

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

-UserPrincipalName

Główna nazwa użytkownika (lub nazwa UPN, zazwyczaj adres e-mail) użytkownika, którego uprawnienia należy dodać.

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

-Workspace

Jednostka obszaru roboczego do dodania użytkownika.

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

Dane wejściowe

None

Dane wyjściowe

System.Object