Add-DataGatewayClusterUser

Referencia

Módulo:: DataGateway

Adición de permisos de usuario y asociados al clúster

Syntax

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

Description

Adición de permisos de usuario y asociados al clúster

Ejemplos

Ejemplo 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

En este ejemplo se agrega el usuario "testUpn@tenant.com" en el rol connectionCreatorWithReshare al clúster de puerta de enlace para los tipos de origen de datos sql.

Ejemplo 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

Ejemplo 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

En este ejemplo se agrega el usuario "adminTestUpn@tenant.com" en el rol de Administración al clúster de puerta de enlace para todos los tipos de origen de datos. Tenga en cuenta que AllowedDataSourceTypes debe ser null cuando el rol es administrador (lo que implica que se permiten todos los tipos de orígenes de datos). Este comando se ejecuta en la región sur de Brasil, por lo que el identificador de clúster de puerta de enlace proporcionado debe estar en esa región.

Ejemplo 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

En este ejemplo se agrega la entidad de servicio para el identificador de aplicación DC8F2C49-9087-4B27-966B-3DB5094C2E77 en el rol de Administración al clúster de puerta de enlace para todos los tipos de orígenes de datos. Más información Tenga en cuenta que AllowedDataSourceTypes debe ser null cuando el rol es administrador (lo que implica que se permiten todos los tipos de orígenes de datos). Este comando se ejecuta en la región sur de Brasil, por lo que el identificador de clúster de puerta de enlace proporcionado debe estar en esa región.

Parámetros

-AllowedDataSourceTypes

Tipos de origen de datos que se permiten para esta combinación de usuario o rol. Debe ser null si el rol es admin (lo que implica que se permiten todos los tipos de orígenes de datos). La lista del tipo de origen de datos puede cambiar en función de los orígenes de datos admitidos. Nota: Este parámetro solo se aplica a PowerApps y 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

Clúster de puerta de enlace al que se debe agregar el usuario

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

-PrincipalObjectId

Identificador de objeto de entidad de seguridad de Azure Active Directory (AAD) (es decir, identificador de usuario) para agregar al clúster de puerta de enlace

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

-RegionKey

Región de Azure asociada al clúster de puerta de enlace especificado. Si no se proporciona , -RegionKey se ejecutará el comando en la región predeterminada del inquilino. Para obtener la lista de parámetros de región disponibles, ejecute el Get-DataGatewayRegion comando .

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

-Role

Rol que se va a aplicar a este usuario en el clúster. Los usuarios se pueden agregar como administradores, creadores de conexiones (pueden usar) o creadores de conexiones con la funcionalidad sharing(Puede usar + Compartir). Los creadores de conexiones (pueden usar) y los creadores de conexiones con la funcionalidad sharing(Puede usar + Compartir) solo se aplican para PowerApps y Flow.

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

-Scope

Ámbito de seguridad para ejecutar el comando. Esto determinaría si está ejecutando este comando en el ámbito de un administrador de inquilinos o servicios o una puerta de enlace Administración

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

Entradas

None

Salidas

System.Void

Compartir a través de