Add-DataGatewayClusterUser
Přidání uživatele a přidružených oprávnění ke clusteru
Syntax
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Description
Přidání uživatele a přidružených oprávnění ke clusteru
Příklady
Příklad 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
Tento příklad přidá uživatele "testUpn@tenant.com" v roli ConnectionCreatorWithReshare do clusteru brány pro typy zdrojů dat SQL.
Příklad 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
Tento příklad přidá uživateleadminTestUpn@tenant.com v roli Správa do clusteru brány pro všechny typy zdrojů dat.
Poznámka: Hodnota AllowedDataSourceTypes
musí být null, pokud je role správcem (což znamená, že jsou povoleny všechny typy zdrojů dat).
Příklad 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
Tento příklad přidá uživateleadminTestUpn@tenant.com v roli Správa do clusteru brány pro všechny typy zdrojů dat.
Poznámka: Hodnota AllowedDataSourceTypes
musí být null, pokud je role správcem (což znamená, že jsou povoleny všechny typy zdrojů dat).
Tento příkaz se spustí v oblasti Brazílie – jih, takže ID clusteru brány by mělo být v dané oblasti.
Příklad 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
Tento příklad přidá instanční objekt pro ID aplikace DC8F2C49-9087-4B27-966B-3DB5094C2E77 v roli Správa do clusteru brány pro všechny typy zdrojů dat. Další informace najdete v tématu Get-AzADServicePrincipal. Všimněte si, že AllowedDataSourceTypes
pokud je role správcem, musí mít hodnotu null (což znamená, že jsou povoleny všechny typy zdrojů dat). Tento příkaz se spustí v oblasti Brazílie – jih, takže ID clusteru brány by mělo být v dané oblasti.
Parametry
-AllowedDataSourceTypes
Typy zdrojů dat, které jsou povolené pro tuto kombinaci uživatele nebo role. Pokud je tato role správcem (což znamená, že jsou povolené všechny typy zdrojů dat), musí mít hodnotu null. Seznam typů zdrojů dat se může změnit na základě podporovaných zdrojů dat. Poznámka: Tento parametr platí jenom pro PowerApps a Flow.
Type: | DatasourceType[] |
Accepted values: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewayClusterId
Cluster brány, do kterého se má uživatel přidat
Type: | Guid |
Aliases: | Cluster, Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrincipalObjectId
ID instančního objektu Azure Active Directory (AAD) (tj. ID uživatele) pro přidání do clusteru brány
Type: | Guid |
Aliases: | User |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegionKey
Oblast Azure přidružená k zadanému clusteru brány Nezadávejte -RegionKey
příkaz ve výchozí oblasti vašeho tenanta.
Pokud chcete získat seznam dostupných parametrů oblasti, spusťte Get-DataGatewayRegion
příkaz.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Role
Role, která se má použít pro tohoto uživatele v clusteru Uživatelé můžou být přidáni jako správci, tvůrci připojení (můžou používat) nebo tvůrci připojení se sdílením (může používat + sdílet). Tvůrci připojení (můžou používat) a tvůrci připojení se sdílením (Můžou používat + Sdílet) platí jenom pro PowerApps a Flow.
Type: | GatewayPrincipalRole |
Accepted values: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Obor zabezpečení pro spuštění příkazu. Tím zjistíte, jestli tento příkaz spouštíte v oboru správce tenanta nebo služby nebo brány Správa
Type: | PowerBIUserScope |
Accepted values: | Individual, Organization |
Position: | Named |
Default value: | Individual |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
None
Výstupy
System.Void