Add-DataGatewayClusterUser
Felhasználó és társított engedélyek hozzáadása a fürthöz
Szintaxis
Default (Alapértelmezett)
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Leírás
Felhasználó és társított engedélyek hozzáadása a fürthöz
Példák
1. példa
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
Ez a példa hozzáadja az "testUpn@tenant.com" felhasználót a ConnectionCreatorWithReshare szerepkörhöz az SQL-adatforrástípusok átjárófürtjében.
2. példa
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
Ez a példa az "adminTestUpn@tenant.com" felhasználót adja hozzá az átjárófürthöz rendszergazdai szerepkörben az összes adatforrástípus esetében.
Vegye figyelembe, hogy a AllowedDataSourceTypes null értékűnek kell lennie, ha a szerepkör rendszergazda (ami azt jelenti, hogy minden adatforrástípus engedélyezve van).
3. példa
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
Ez a példa az "adminTestUpn@tenant.com" felhasználót adja hozzá az átjárófürthöz rendszergazdai szerepkörben az összes adatforrástípus esetében.
Vegye figyelembe, hogy a AllowedDataSourceTypes null értékűnek kell lennie, ha a szerepkör rendszergazda (ami azt jelenti, hogy minden adatforrástípus engedélyezve van).
Ez a parancs a brazíliai déli régióban fut, ezért a megadott átjárófürt-azonosítónak ebben a régióban kell lennie.
4. példa
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
Ez a példa hozzáadja a szolgáltatásnevet az DC8F2C49-9087-4B27-966B-3DB5094C2E77 alkalmazásazonosítóhoz a rendszergazda szerepkörben az átjárófürthöz minden adatforrástípus esetében. További információ: Get-AzADServicePrincipal. Vegye figyelembe, hogy a AllowedDataSourceTypes null értékűnek kell lennie, ha a szerepkör rendszergazda (ami azt jelenti, hogy az összes adatforrástípus engedélyezett). Ez a parancs a brazíliai déli régióban fut, ezért a megadott átjárófürt-azonosítónak ebben a régióban kell lennie.
Paraméterek
-AllowedDataSourceTypes
A felhasználó/szerepkör kombinációhoz engedélyezett adatforrástípusok. Ennek null értékűnek kell lennie, ha a szerepkör rendszergazda (ami azt jelenti, hogy az összes adatforrástípus engedélyezve van). Az adatforrástípus listája a támogatott adatforrások alapján változhat. Megjegyzés: Ez a paraméter csak a PowerAppsre és a Flow-ra vonatkozik.
Paramétertulajdonságok
| Típus: | DatasourceType[] |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | 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 |
| Támogató vadkártyák: | False |
| Don't Show: | False |
Paraméterhalmazok
(All)
| Pozíció: | Named |
| Kötelező: | False |
| Érték a csővezetékből: | False |
| Érték a csővezetékből az ingatlan név szerint: | False |
| Érték a maradék argumentumokból: | False |
-GatewayClusterId
Átjárófürt, amelyhez hozzá kell adni a felhasználót
Paramétertulajdonságok
| Típus: | Guid |
| Alapértelmezett érték: | None |
| Támogató vadkártyák: | False |
| Don't Show: | False |
| Aliasok: | Klászter, Id |
Paraméterhalmazok
(All)
| Pozíció: | Named |
| Kötelező: | True |
| Érték a csővezetékből: | False |
| Érték a csővezetékből az ingatlan név szerint: | False |
| Érték a maradék argumentumokból: | False |
-PrincipalObjectId
Az Azure Active Directory (AAD) egyszerű objektumazonosítója (azaz felhasználói azonosítója) az átjárófürthöz való hozzáadáshoz
Paramétertulajdonságok
| Típus: | Guid |
| Alapértelmezett érték: | None |
| Támogató vadkártyák: | False |
| Don't Show: | False |
| Aliasok: | Felhasználó |
Paraméterhalmazok
(All)
| Pozíció: | Named |
| Kötelező: | True |
| Érték a csővezetékből: | False |
| Érték a csővezetékből az ingatlan név szerint: | False |
| Érték a maradék argumentumokból: | False |
-RegionKey
A megadott átjárófürthöz társított Azure-régió. Ha nem ad meg -RegionKey, akkor a parancs a bérlő alapértelmezett régiójában fut.
Az elérhető régióparaméterek listájának lekéréséhez futtassa a Get-DataGatewayRegion parancsot
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogató vadkártyák: | False |
| Don't Show: | False |
Paraméterhalmazok
(All)
| Pozíció: | Named |
| Kötelező: | False |
| Érték a csővezetékből: | False |
| Érték a csővezetékből az ingatlan név szerint: | False |
| Érték a maradék argumentumokból: | False |
-Role
A felhasználóra a fürtön alkalmazandó szerepkör. A felhasználók rendszergazdaként, kapcsolatkészítőként (használhatják) vagy kapcsolatkészítőként is felvehetők megosztási (használhatják és megosztható) képességekkel. A kapcsolatkészítők (használhatják) és a megosztási (használhatják és megosztható) képességekkel rendelkező kapcsolatkészítők csak a PowerAppsre és a Flow-ra vonatkoznak.
Paramétertulajdonságok
| Típus: | GatewayPrincipalRole |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Támogató vadkártyák: | False |
| Don't Show: | False |
Paraméterhalmazok
(All)
| Pozíció: | Named |
| Kötelező: | True |
| Érték a csővezetékből: | False |
| Érték a csővezetékből az ingatlan név szerint: | False |
| Érték a maradék argumentumokból: | False |
-Scope
Biztonsági hatókör a parancs futtatásához. Ez azt határozza meg, hogy a parancsot bérlői/szolgáltatás-rendszergazdai vagy átjáró-rendszergazdai hatókörben futtatja-e.
Paramétertulajdonságok
| Típus: | PowerBIUserScope |
| Alapértelmezett érték: | Individual |
| Elfogadott értékek: | Individual, Organization |
| Támogató vadkártyák: | False |
| Don't Show: | False |
Paraméterhalmazok
(All)
| Pozíció: | Named |
| Kötelező: | False |
| Érték a csővezetékből: | False |
| Érték a csővezetékből az ingatlan név szerint: | False |
| Érték a maradék argumentumokból: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.