Add-DataGatewayClusterUser
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