Udostępnij za pośrednictwem


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.

Typ:WorkspaceUserAccessRight
Aliasy:UserAccessRight
Dopuszczalne wartości:Member, Admin, Contributor, Viewer
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

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

Typ:Guid
Aliasy:GroupId, WorkspaceId
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Identifier

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

Typ:String
Aliasy:PrincipalId
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrincipalType

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

Typ:WorkspaceUserPrincipalType
Dopuszczalne wartości:App, Group, User
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Scope

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

Typ:PowerBIUserScope
Dopuszczalne wartości:Individual, Organization
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserPrincipalName

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

Typ:String
Aliasy:UserEmailAddress
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Workspace

Jednostka obszaru roboczego, do których ma zostać dodany użytkownik.

Typ:Workspace
Aliasy:Group
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

System.Object