Add-DataGatewayClusterUser
Přidání uživatele a přidružených oprávnění ke clusteru
Syntaxe
Default (Výchozí)
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živateletestUpn@tenant.comv 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živatele "adminTestUpn@tenant.com" v roli správce do clusteru brány pro všechny typy zdrojů dat.
Všimněte si, že AllowedDataSourceTypes musí mít hodnotu null, pokud je role správce (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živatele "adminTestUpn@tenant.com" v roli správce do clusteru brány pro všechny typy zdrojů dat.
Všimněte si, že AllowedDataSourceTypes musí mít hodnotu null, pokud je role správce (což znamená, že jsou povoleny všechny typy zdrojů dat).
Tento příkaz se spustí v oblasti Brazílie – jih, takže ZADANÉ ID clusteru brány by mělo být v této 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ávce do clusteru brány pro všechny typy zdrojů dat. Další informace najdete v tématu Get-AzADServicePrincipal. Mějte na paměti, že AllowedDataSourceTypes musí mít hodnotu null, pokud je role správce (což znamená, že jsou povoleny všechny typy zdrojů dat). Tento příkaz se spustí v oblasti Brazílie – jih, takže ZADANÉ ID clusteru brány by mělo být v této oblasti.
Parametry
-AllowedDataSourceTypes
Typy zdrojů dat, které jsou povoleny pro tuto kombinaci uživatele nebo role. Tato hodnota musí mít hodnotu null, pokud je role správce (což znamená, že jsou povolené všechny typy zdrojů dat). 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.
Vlastnosti parametru
| Typ: | DatasourceType[] |
| Default value: | None |
| Přípustné hodnoty: | 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 |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-GatewayClusterId
Cluster brány, do kterého se má uživatel přidat
Vlastnosti parametru
| Typ: | Guid |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | klastr, identifikační číslo |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PrincipalObjectId
ID instančního objektu Azure Active Directory (AAD) (tj. ID uživatele) pro přidání do clusteru brány
Vlastnosti parametru
| Typ: | Guid |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Uživatel |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RegionKey
Oblast Azure přidružená k zadanému clusteru brány. Nezadávejte -RegionKey spustí příkaz ve výchozí oblasti vašeho tenanta.
Pokud chcete získat seznam dostupných parametrů oblasti, spusťte příkaz Get-DataGatewayRegion.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Role
Role, která se má použít pro tohoto uživatele v clusteru Uživatele je možné přidávat jako správce, tvůrce připojení (můžou používat) nebo Tvůrce 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ůže používat + Sdílet) platí jenom pro PowerApps a Flow.
Vlastnosti parametru
| Typ: | GatewayPrincipalRole |
| Default value: | None |
| Přípustné hodnoty: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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 správce brány.
Vlastnosti parametru
| Typ: | PowerBIUserScope |
| Default value: | Individual |
| Přípustné hodnoty: | Individual, Organization |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.