Add-DataGatewayClusterUser
Adicionar ao utilizador e às permissões associadas ao cluster
Syntax
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Description
Adicionar ao utilizador e às permissões associadas ao cluster
Exemplos
Exemplo 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
Este exemplo adiciona o utilizador "testUpn@tenant.com" no papel de ConnectionCreatorWithReshare ao cluster gateway para tipos de fontes de dados SQL.
Exemplo 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
Este exemplo adiciona o utilizador "adminTestUpn@tenant.com" no papel de Administração ao cluster gateway para todos os tipos de fontes de dados.
Note que AllowedDataSourceTypes
deve ser nulo quando a função é administrada (o que implica que todos os tipos de fontes de dados são permitidos).
Exemplo 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
Este exemplo adiciona o utilizador "adminTestUpn@tenant.com" no papel de Administração ao cluster gateway para todos os tipos de fontes de dados.
Note que AllowedDataSourceTypes
deve ser nulo quando a função é administrada (o que implica que todos os tipos de fontes de dados são permitidos).
Este comando é gerido na região sul do Brasil, pelo que o iD do aglomerado de gateways fornecido deve ser naquela região.
Exemplo 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
Este exemplo adiciona o principal de serviço para aplicação id DC8F2C49-9087-4B27-966B-3DB5094C2E77 no papel de Administração ao cluster gateway para todos os tipos de fontes de dados. Para mais informações, consulte o Get-AzADServicePrincipal. Note que o AllowedDataSourceTypes
deve ser nulo quando a função é administrada (implicando todos os tipos de fontes de dados são permitidos). Este comando é gerido na região sul do Brasil, pelo que o iD do aglomerado de gateways fornecido deve ser naquela região.
Parâmetros
-AllowedDataSourceTypes
Tipos de fontes de dados que são permitidos para esta combinação utilizador/fun. Isto deve ser nulo se o papel for administrador (implicando que todos os tipos de fontes de dados são permitidos). A lista de tipos de origem de dados pode ser alterada com base em fontes de dados suportadas. Nota: Este parâmetro aplica-se apenas para PowerApps e 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
Aglomerado de gateway ao qual o utilizador deve ser adicionado
Type: | Guid |
Aliases: | Cluster, Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrincipalObjectId
ID do objeto principal do Azure Ative (AAD) para adicionar ao cluster gateway
Type: | Guid |
Aliases: | User |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegionKey
A região de Azure associada ao aglomerado de gateways especificado. Não fornecendo um -RegionKey
testamento executar o comando na região padrão para o seu inquilino.
Para obter a lista de parâmetros da região disponível executar o Get-DataGatewayRegion
comando
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Role
Função a aplicar a este utilizador no cluster. Os utilizadores podem ser adicionados como administradores, criadores de ligação (Pode Usar) ou Criadores de Conexão com capacidade de partilha (Pode usar + Partilhar). Os criadores de ligação (Can Use) e Connection Creators com a capacidade de partilha (Pode usar + Partilhar) aplicam-se apenas para PowerApps e Flow.
Type: | GatewayPrincipalRole |
Accepted values: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Espaço de segurança para executar o comando. Isto determinaria se você está executando este comando no âmbito de um administrador de inquilino/serviço ou um gateway Administração
Type: | PowerBIUserScope |
Accepted values: | Individual, Organization |
Position: | Named |
Default value: | Individual |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
System.Void