Add-DataGatewayClusterUser

الوحدة النمطية:

DataGateway

إضافة المستخدم والأذونات المقترنة إلى نظام المجموعة

بناء الجملة

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

الوصف

إضافة المستخدم والأذونات المقترنة إلى نظام المجموعة

أمثلة

مثال 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

يضيف هذا المثال المستخدم "testUpn@tenant.com" في دور ConnectionCreatorWithReshare إلى مجموعة البوابة أنواع مصدر بيانات SQL.

مثال 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

يضيف هذا المثال المستخدم "adminTestUpn@tenant.com" في دور مسؤول إلى مجموعة البوابة لكافة أنواع مصادر البيانات. ملاحظة، AllowedDataSourceTypes يجب أن يكون فارغا عندما يكون الدور مسؤولا (يعني السماح بجميع أنواع مصادر البيانات).

مثال 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

يضيف هذا المثال المستخدم "adminTestUpn@tenant.com" في دور مسؤول إلى مجموعة البوابة لكافة أنواع مصادر البيانات. ملاحظة، AllowedDataSourceTypes يجب أن يكون فارغا عندما يكون الدور مسؤولا (يعني السماح بجميع أنواع مصادر البيانات). يتم تشغيل هذا الأمر في منطقة جنوب البرازيل، لذلك يجب أن يكون معرف مجموعة البوابة المقدم في تلك المنطقة.

مثال 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

يضيف هذا المثال كيان الخدمة لمعرف التطبيق DC8F2C49-9087-4B27-966B-3DB5094C2E77 في دور مسؤول إلى مجموعة البوابة لجميع أنواع مصادر البيانات. مزيد من المعلومات ملاحظة، AllowedDataSourceTypes يجب أن يكون فارغا عندما يكون الدور مسؤولا (يعني السماح بجميع أنواع مصادر البيانات). يتم تشغيل هذا الأمر في منطقة جنوب البرازيل، لذلك يجب أن يكون معرف مجموعة البوابة المقدم في تلك المنطقة.

المعلمات

-AllowedDataSourceTypes

أنواع مصادر البيانات المسموح بها لتركيبة المستخدم/الدور هذه. يجب أن يكون هذا فارغا إذا كان الدور مسؤولا (يعني السماح بجميع أنواع مصادر البيانات). قد تتغير قائمة نوع مصدر البيانات استنادا إلى مصادر البيانات المدعومة. ملاحظة: تنطبق هذه المعلمة فقط على PowerApps و 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

مجموعة البوابة التي يجب إضافة المستخدم إليها

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

-PrincipalObjectId

معرف الكائن الأساسي ل Azure Active Directory (AAD) (أي معرف المستخدم) لإضافته إلى مجموعة البوابة

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

-RegionKey

منطقة Azure المقترنة بمجموعة البوابة المحددة. سيؤدي عدم توفير الأمر -RegionKey إلى تشغيل الأمر في المنطقة الافتراضية للمستأجر الخاص بك. للحصول على قائمة معلمات المنطقة المتوفرة، قم بتشغيل Get-DataGatewayRegion الأمر

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

-Role

الدور الذي يجب تطبيقه على هذا المستخدم على نظام المجموعة. يمكن إضافة المستخدمين كمسؤولين أو منشئي اتصال (يمكن استخدام) أو منشئي الاتصال مع إمكانية المشاركة (يمكن استخدام + مشاركة). ينطبق منشئو الاتصال (يمكن استخدام) و"منشئو الاتصال" مع إمكانية المشاركة (يمكن استخدام + مشاركة) فقط على PowerApps و Flow.

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

-Scope

نطاق الأمان لتشغيل الأمر. قد يحدد هذا ما إذا كنت تقوم بتشغيل هذا الأمر في نطاق مسؤول المستأجر/الخدمة أو بوابة مسؤول

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

الإدخالات

None

المخرجات

System.Void