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