Add-DataGatewayClusterUser
Kümeye kullanıcı ve ilişkili izinler ekleme
Sözdizimi
Default EnterprisePublishing
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Description
Kümeye kullanıcı ve ilişkili izinler ekleme
Örnekler
Örnek 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
Bu örnek, "testUpn@tenant.com" kullanıcısını ConnectionCreatorWithReshare rolüne SQL veri kaynağı türleri için ağ geçidi kümesine ekler.
Örnek 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
Bu örnek, yönetici rolüne "adminTestUpn@tenant.com" kullanıcısını tüm veri kaynağı türleri için ağ geçidi kümesine ekler.
Rol yönetici olduğunda (tüm veri kaynağı türlerine izin verilir) AllowedDataSourceTypes null olmalıdır.
Örnek 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
Bu örnek, yönetici rolüne "adminTestUpn@tenant.com" kullanıcısını tüm veri kaynağı türleri için ağ geçidi kümesine ekler.
Rol yönetici olduğunda (tüm veri kaynağı türlerine izin verilir) AllowedDataSourceTypes null olmalıdır.
Bu komut Brezilya güney bölgesinde çalıştırıldığından, sağlanan ağ geçidi küme kimliği bu bölgede olmalıdır.
Örnek 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
Bu örnek, yönetici rolündeki uygulama kimliği DC8F2C49-9087-4B27-966B-3DB5094C2E77 için hizmet sorumlusunu tüm veri kaynağı türleri için ağ geçidi kümesine ekler. Daha fazla bilgi için bkz. Get-AzADServicePrincipalAllowedDataSourceTypes null olması gerektiğini unutmayın (tüm veri kaynağı türlerine izin verilir). Bu komut Brezilya güney bölgesinde çalıştırıldığından, sağlanan ağ geçidi küme kimliği bu bölgede olmalıdır.
Parametreler
-AllowedDataSourceTypes
Bu kullanıcı/rol bileşimi için izin verilen veri kaynağı türleri. Rol yöneticiyse (tüm veri kaynağı türlerine izin verilir) bu null olmalıdır. Veri kaynağı türü listesi desteklenen veri kaynaklarına göre değişebilir. Not: Bu parametre yalnızca PowerApps ve Flow için geçerlidir.
Parametre özellikleri
| Tür: | DatasourceType[] |
| Default value: | None |
| Kabul edilen değerler: | 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 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-GatewayClusterId
Kullanıcının eklenmesi gereken ağ geçidi kümesi
Parametre özellikleri
| Tür: | Guid |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Küme, Kimlik |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PrincipalObjectId
Ağ geçidi kümesine eklenecek Azure Active Directory (AAD) asıl nesne kimliği (kullanıcı kimliği)
Parametre özellikleri
| Tür: | Guid |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Kullanıcı |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-RegionKey
Belirtilen ağ geçidi kümesiyle ilişkili Azure bölgesi.
-RegionKey sağlanmıyorsa, komutu kiracınız için varsayılan bölgede çalıştırır.
Kullanılabilir bölge parametrelerinin listesini almak için Get-DataGatewayRegion komutunu çalıştırın
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Role
Kümedeki bu kullanıcıya uygulanacak rol. Kullanıcılar yönetici, bağlantı oluşturucu (Kullanabilir) veya Paylaşım özelliği olan Bağlantı Oluşturucular (+ Paylaş) özelliğiyle eklenebilir. Bağlantı oluşturucuları (Kullanabilir) ve Paylaşımlı Bağlantı Oluşturucuları (+ Paylaşabilirsiniz) özelliği yalnızca PowerApps ve Flow için geçerlidir.
Parametre özellikleri
| Tür: | GatewayPrincipalRole |
| Default value: | None |
| Kabul edilen değerler: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Scope
Komutu çalıştırmak için Güvenlik Kapsamı. Bu, bu komutu Kiracı/Hizmet yöneticisi veya Ağ Geçidi Yöneticisi kapsamında çalıştırılıp çalıştırmayacağını belirler
Parametre özellikleri
| Tür: | PowerBIUserScope |
| Default value: | Individual |
| Kabul edilen değerler: | Individual, Organization |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.