Bagikan melalui

Add-DataGatewayClusterUser

  • Referensi
Modul:
DataGateway

Menambahkan izin pengguna dan terkait ke kluster

Sintaks

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.

Jenis:DatasourceType[]
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
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-GatewayClusterId

Kluster gateway tempat pengguna harus ditambahkan

Jenis:Guid
Alias:Cluster, Id
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-PrincipalObjectId

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

Jenis:Guid
Alias:User
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard: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

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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.

Jenis:GatewayPrincipalRole
Nilai yang diterima:Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Scope

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

Jenis:PowerBIUserScope
Nilai yang diterima:Individual, Organization
Position:Named
Nilai default:Individual
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

None

Output

System.Void