Add-DataGatewayClusterUser

Odwołanie

Moduł:: DataGateway

Dodawanie użytkownika i skojarzonych uprawnień do klastra

Składnia

Add-DataGatewayClusterUser
   [-Scope <PowerBIUserScope>]
   -GatewayClusterId <Guid>
   -PrincipalObjectId <Guid>
   [-AllowedDataSourceTypes <DatasourceType[]>]
   -Role <GatewayPrincipalRole>
   [-RegionKey <String>]
   [<CommonParameters>]

Opis

Dodawanie użytkownika i skojarzonych uprawnień do klastra

Przykłady

Przykład 1

PS C:\> $userToAdd = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> $dsTypes = New-Object 'System.Collections.Generic.List[Microsoft.PowerBI.ServiceContracts.Api.DatasourceType]'
PS C:\> $dsTypes.Add([Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.DataSourceType]::Sql)
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $dsTypes -Role ConnectionCreatorWithReshare

W tym przykładzie dodano użytkownika "testUpn@tenant.com" w roli ConnectionCreatorWithReshare do klastra bramy dla typów źródeł danych SQL.

Przykład 2

PS C:\> $userToAdd = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $null -Role Admin

Przykład 3

PS C:\> $userToAdd = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $null -Role Admin -RegionKey brazilsouth

W tym przykładzie dodano użytkownika "adminTestUpn@tenant.com" w roli Administratora do klastra bramy dla wszystkich typów źródeł danych. Należy pamiętać, że AllowedDataSourceTypes musi mieć wartość null, gdy rola jest administratorem (co oznacza, że wszystkie typy źródeł danych są dozwolone). To polecenie jest uruchamiane w regionie Południowo-Brazylii, więc podany identyfikator klastra bramy powinien znajdować się w tym regionie.

Przykład 4

PS C:\> $userToAdd = $(Get-AzADServicePrincipal -ApplicationId DC8F2C49-9087-4B27-966B-3DB5094C2E77).Id
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $null -Role Admin -RegionKey brazilsouth

W tym przykładzie dodano jednostkę usługi dla identyfikatora aplikacji DC8F2C49-9087-4B27-966B-3DB5094C2E77 w roli Administratora do klastra bramy dla wszystkich typów źródeł danych. Aby uzyskać więcej informacji, zobacz get-AzADServicePrincipal. Należy pamiętać, że AllowedDataSourceTypes musi mieć wartość null, gdy rola jest administratorem (co oznacza, że wszystkie typy źródeł danych są dozwolone). To polecenie jest uruchamiane w regionie Południowo-Brazylii, więc podany identyfikator klastra bramy powinien znajdować się w tym regionie.

Parametry

-AllowedDataSourceTypes

Typy źródeł danych, które są dozwolone dla tej kombinacji użytkownika/roli. Musi to być wartość null, jeśli rola jest administratorem (co oznacza, że wszystkie typy źródeł danych są dozwolone). Lista typu źródła danych może ulec zmianie na podstawie obsługiwanych źródeł danych. Uwaga: ten parametr dotyczy tylko usług PowerApps i Flow.

Typ:	DatasourceType[]
Dopuszczalne wartości:	Sql, AnalysisServices, SAPHana, File, Folder, Oracle, Teradata, SharePointList, Web, OData, DB2, MySql, PostgreSql, Sybase, Extension, SAPBW, AzureTables, AzureBlobs, Informix, ODBC, Excel, SharePoint, PubNub, MQ, BizTalk, GoogleAnalytics, CustomHttpApi, Exchange, Facebook, HDInsight, AzureMarketplace, ActiveDirectory, Hdfs, SharePointDocLib, PowerQueryMashup, OleDb, AdoDotNet, R, LOB, Salesforce, CustomConnector, SAPBWMessageServer, AdobeAnalytics, Essbase, AzureDataLakeStorage, SapErp, UIFlow, CDPA, EventHub, Unknown
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-GatewayClusterId

Klaster bramy, do którego należy dodać użytkownika

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

-PrincipalObjectId

Identyfikator obiektu głównego usługi Azure Active Directory (AAD) (tj. identyfikator użytkownika) do dodania do klastra bramy

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

-RegionKey

Region platformy Azure skojarzony z określonym klastrem bramy. Brak podania -RegionKey spowoduje uruchomienie polecenia w regionie domyślnym dla dzierżawy. Aby uzyskać listę dostępnych parametrów regionu, uruchom polecenie Get-DataGatewayRegion

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

-Role

Rola, która ma być stosowana do tego użytkownika w klastrze. Użytkownicy mogą być dodawani jako administratorzy, twórcy połączeń (mogą używać) lub twórcy połączeń z udostępnianiem (może używać + udostępnianie). Twórcy połączeń (mogą używać) i twórcy połączeń z udostępnianiem (możliwość używania i udostępniania) mają zastosowanie tylko w przypadku usług PowerApps i Flow.

Typ:	GatewayPrincipalRole
Dopuszczalne wartości:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Scope

Zakres zabezpieczeń do uruchomienia polecenia. Pozwoliłoby to określić, czy używasz tego polecenia w zakresie administratora dzierżawy/usługi lub administratora bramy

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

Dane wejściowe

None

Dane wyjściowe

System.Void

Udostępnij za pośrednictwem