Add-DataGatewayClusterUser
Menambahkan izin pengguna dan terkait ke kluster
Sintaks
Default (Default)
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Deskripsi
Menambahkan izin pengguna dan 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.
Properti parameter
| Jenis: | DatasourceType[] |
| Nilai default: | None |
| Nilai yang diterima: | 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 |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-GatewayClusterId
Kluster gateway tempat pengguna harus ditambahkan
Properti parameter
| Jenis: | Guid |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Kelompok, Nomor Identitas |
Set parameter
(All)
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-PrincipalObjectId
ID objek utama Azure Active Directory (AAD) (yaitu ID pengguna) untuk ditambahkan ke kluster gateway
Properti parameter
| Jenis: | Guid |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Pengguna |
Set parameter
(All)
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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 perintah Get-DataGatewayRegion
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Role
Peran untuk diterapkan ke 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.
Properti parameter
| Jenis: | GatewayPrincipalRole |
| Nilai default: | None |
| Nilai yang diterima: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Scope
Cakupan Keamanan untuk menjalankan perintah. Ini akan menentukan apakah Anda menjalankan perintah ini dalam cakupan admin Penyewa/Layanan atau Admin Gateway
Properti parameter
| Jenis: | PowerBIUserScope |
| Nilai default: | Individual |
| Nilai yang diterima: | Individual, Organization |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.