Add-DataGatewayClusterUser

  • Başvuru
Modül:
DataGateway

Kümeye kullanıcı ve ilişkili izinler ekleme

Syntax

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, CONNECTIONCreatorWithReshare rolündeki "testUpn@tenant.com" kullanıcısını 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, tüm veri kaynağı türleri için ağ geçidi kümesine Yönetici rolündeki "adminTestUpn@tenant.com" kullanıcısını ekler. AllowedDataSourceTypes Rol yönetici olduğunda null olması gerektiğini unutmayın (tüm veri kaynağı türlerine izin verilir).

Ö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, tüm veri kaynağı türleri için ağ geçidi kümesine Yönetici rolündeki "adminTestUpn@tenant.com" kullanıcısını ekler. AllowedDataSourceTypes Rol yönetici olduğunda null olması gerektiğini unutmayın (tüm veri kaynağı türlerine izin verilir). Bu komut Brezilya'nın 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, tüm veri kaynağı türleri için ağ geçidi kümesine Yönetici rolünde DC8F2C49-9087-4B27-966B-3DB5094C2E77 uygulama kimliğinin hizmet sorumlusunu ekler. Daha fazla bilgi için bkz. Get-AzADServicePrincipal. AllowedDataSourceTypes Rol yönetici olduğunda null olması gerektiğini unutmayın (tüm veri kaynağı türlerine izin verilir). Bu komut Brezilya'nın 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 veriliyorsa) 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.

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

Kullanıcının eklenmesi gereken ağ geçidi kümesi

Type:Guid
Aliases:Cluster, Id
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrincipalObjectId

Ağ geçidi kümesine eklenecek Azure Active Directory (AAD) asıl nesne kimliği (kullanıcı kimliği)

Type:Guid
Aliases:User
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RegionKey

Belirtilen ağ geçidi kümesiyle ilişkili Azure bölgesi. sağlanmaması -RegionKey , komutunu kiracınız için varsayılan bölgede çalıştırır. Kullanılabilir bölge parametrelerinin listesini almak için komutunu çalıştırın Get-DataGatewayRegion

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Role

Kümedeki bu kullanıcıya uygulanacak rol. Kullanıcılar yönetici, bağlantı oluşturucu (Kullanabilir) veya Paylaşım özelliğine sahip Bağlantı Oluşturucular (+ Paylaş) özelliğiyle eklenebilir. Paylaşım özelliğine sahip bağlantı oluşturucuları (Kullanabilir) ve Bağlantı Oluşturucuları (+ Paylaşabilir) özelliği yalnızca PowerApps ve Flow için geçerlidir.

Type:GatewayPrincipalRole
Accepted values:Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Komutu çalıştırmak için güvenlik kapsamı. Bu, bu komutu Kiracı/Hizmet yöneticisi veya Ağ Geçidi Yönetici kapsamında çalıştırılıp çalıştırmayacağını belirler

Type:PowerBIUserScope
Accepted values:Individual, Organization
Position:Named
Default value:Individual
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Çıkışlar

System.Void