Add-DataGatewayClusterUser

  • Referensi
Modul:
DataGateway

Menambahkan pengguna dan izin terkait ke kluster

Sintaks

Add-DataGatewayClusterUser
   [-Scope <PowerBIUserScope>]
   -GatewayClusterId <Guid>
   -PrincipalObjectId <Guid>
   [-AllowedDataSourceTypes <DatasourceType[]>]
   -Role <GatewayPrincipalRole>
   [-RegionKey <String>]
   [<CommonParameters>]

Deskripsi

Menambahkan pengguna dan izin terkait ke kluster

Contoh

Contoh 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

Contoh ini menambahkan pengguna "testUpn@tenant.com" dalam peran ConnectionCreatorWithReshare ke kluster gateway untuk jenis sumber data SQL.

Contoh 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

Contoh ini menambahkan pengguna "adminTestUpn@tenant.com" dalam peran Admin ke kluster gateway untuk semua jenis sumber data. Perhatikan, AllowedDataSourceTypes harus null ketika peran adalah admin (menyiratkan semua jenis sumber data diizinkan).

Contoh: 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

Contoh ini menambahkan pengguna "adminTestUpn@tenant.com" dalam peran Admin ke kluster gateway untuk semua jenis sumber data. Perhatikan, AllowedDataSourceTypes harus null ketika peran adalah admin (menyiratkan semua jenis sumber data diizinkan). Perintah ini dijalankan di wilayah Brasil selatan, sehingga ID kluster gateway yang disediakan harus berada di wilayah tersebut.

Contoh 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

Contoh ini menambahkan perwakilan layanan untuk id aplikasi DC8F2C49-9087-4B27-966B-3DB5094C2E77 dalam peran Admin ke kluster gateway untuk semua jenis sumber data. Untuk informasi selengkapnya, lihat Get-AzADServicePrincipal. Perhatikan bahwa AllowedDataSourceTypes harus null ketika peran adalah admin (menyiratkan semua jenis sumber data diizinkan). Perintah ini dijalankan di wilayah Brasil selatan, sehingga ID kluster gateway yang disediakan harus berada di wilayah tersebut.

Parameter

-AllowedDataSourceTypes

Jenis sumber data yang diizinkan untuk kombinasi pengguna/peran ini. Ini harus null jika perannya adalah admin (menyiratkan semua jenis sumber data diizinkan). Daftar jenis sumber data dapat berubah berdasarkan sumber data yang didukung. Catatan: Parameter ini hanya berlaku untuk PowerApps dan 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

Kluster gateway tempat pengguna harus ditambahkan

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

-PrincipalObjectId

ID objek utama Azure Active Directory (AAD) (yaitu ID pengguna) untuk ditambahkan ke kluster gateway

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

-RegionKey

Wilayah Azure yang terkait dengan kluster gateway yang ditentukan. Tidak menyediakan -RegionKey akan menjalankan perintah di wilayah default untuk penyewa Anda. Untuk mendapatkan daftar parameter wilayah yang tersedia, jalankan Get-DataGatewayRegion perintah

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

-Role

Peran untuk diterapkan pada pengguna ini pada kluster. Pengguna dapat ditambahkan sebagai admin, pembuat koneksi (Dapat Menggunakan) atau Pembuat Koneksi dengan kemampuan berbagi (Dapat menggunakan + Berbagi). Pembuat koneksi (Dapat Menggunakan) dan Pembuat Koneksi dengan kemampuan berbagi (Dapat menggunakan + Berbagi) hanya berlaku untuk PowerApps dan Alur.

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

-Scope

Cakupan Keamanan untuk menjalankan perintah. Ini akan menentukan apakah Anda menjalankan perintah ini dalam cakupan admin Penyewa/Layanan atau Gateway Admin

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

Input

None

Output

System.Void