Add-DataGatewayClusterUser
Adicionar permissões de usuário e associadas ao cluster
Sintaxe
Default (Padrão)
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Description
Adicionar permissões de usuário e 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 usuário "testUpn@tenant.com" na função connectionCreatorWithReshare ao cluster de gateway para tipos de fonte 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 usuário "adminTestUpn@tenant.com" na função de Administrador ao cluster de gateway para todos os tipos de fonte de dados.
Observe que o AllowedDataSourceTypes deve ser nulo quando a função é administrador (implicando que todos os tipos de fonte 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 usuário "adminTestUpn@tenant.com" na função de Administrador ao cluster de gateway para todos os tipos de fonte de dados.
Observe que o AllowedDataSourceTypes deve ser nulo quando a função é administrador (implicando que todos os tipos de fonte de dados são permitidos).
Esse comando é executado na região sul do Brasil, portanto, a ID do cluster de gateway fornecida deve estar nessa 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 a entidade de serviço para a ID do aplicativo DC8F2C49-9087-4B27-966B-3DB5094C2E77 na função de Administrador para o cluster de gateway para todos os tipos de fonte de dados. Para obter mais informações, consulte Get-AzADServicePrincipal. Observe que o AllowedDataSourceTypes deve ser nulo quando a função é administrador (implicando que todos os tipos de fonte de dados são permitidos). Esse comando é executado na região sul do Brasil, portanto, a ID do cluster de gateway fornecida deve estar nessa região.
Parâmetros
-AllowedDataSourceTypes
Tipos de fonte de dados permitidos para essa combinação de usuário/função. Isso deve ser nulo se a função for admin (implicando que todos os tipos de fonte de dados são permitidos). A lista de tipos de fonte de dados pode ser alterada com base em fontes de dados com suporte. Observação: esse parâmetro se aplica somente ao PowerApps e ao Flow.
Propriedades do parâmetro
| Tipo: | DatasourceType[] |
| Valor padrão: | None |
| Valores aceitos: | 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 |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GatewayClusterId
Cluster de gateway ao qual o usuário deve ser adicionado
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Clúster, ID |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PrincipalObjectId
ID do objeto principal do Azure Active Directory (AAD) (ou seja, ID de usuário) para adicionar ao cluster de gateway
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Utilizador |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RegionKey
A região do Azure associada ao cluster de gateway especificado. Não fornecer um -RegionKey executará o comando na região padrão do locatário.
Para obter a lista de parâmetros de região disponíveis, execute o comando Get-DataGatewayRegion
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Role
Função a ser aplicada a esse usuário no cluster. Os usuários podem ser adicionados como administradores, criadores de conexão (podem usar) ou criadores de conexão com a funcionalidade de compartilhamento(Pode usar + Compartilhar). Os criadores de conexão(podem usar) e os criadores de conexão com a funcionalidade de compartilhamento (pode usar + Compartilhar) aplicam-se somente ao PowerApps e ao Flow.
Propriedades do parâmetro
| Tipo: | GatewayPrincipalRole |
| Valor padrão: | None |
| Valores aceitos: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Scope
Escopo de Segurança para executar o comando. Isso determinaria se você está executando esse comando no escopo de um administrador de Locatário/Serviço ou de um Administrador de Gateway
Propriedades do parâmetro
| Tipo: | PowerBIUserScope |
| Valor padrão: | Individual |
| Valores aceitos: | Individual, Organization |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.