Add-PowerBIWorkspaceUser

Moduł:

MicrosoftPowerBIMgmt.Workspaces Module

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

Składnia

UserEmailWithId (Domyślna)

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

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.

Właściwości parametru

Typ:	WorkspaceUserAccessRight
Domyślna wartość:	None
Dopuszczalne wartości:	Member, Admin, Contributor, Viewer
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	UserAccessRight

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Id

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

Właściwości parametru

Typ:	Guid
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Identyfikator grupy, Identyfikator obszaru roboczego

Zestawy parametrów

UserEmailWithId

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

PrincipalTypeWithId

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Identyfikator główny

Zestawy parametrów

PrincipalTypeWithId

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

PrincipalTypeWithWorkspace

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-PrincipalType

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

Właściwości parametru

Typ:	WorkspaceUserPrincipalType
Domyślna wartość:	None
Dopuszczalne wartości:	App, Group, User
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

PrincipalTypeWithId

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

PrincipalTypeWithWorkspace

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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ą.

Właściwości parametru

Typ:	PowerBIUserScope
Domyślna wartość:	None
Dopuszczalne wartości:	Individual, Organization
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-UserPrincipalName

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	UserEmailAddress (Adres e-mail użytkownika)

Zestawy parametrów

UserEmailWithId

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

UserEmailWithWorkspace

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Workspace

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

Właściwości parametru

Typ:	Workspace
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Grupa

Zestawy parametrów

UserEmailWithWorkspace

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

PrincipalTypeWithWorkspace

Position:	Named
Obowiązkowy:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Dane wyjściowe

System.Object