Add-DataGatewayClusterUser
Aggiungere l'utente e le autorizzazioni associate al cluster
Sintassi
Default (impostazione predefinita).
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Descrizione
Aggiungere l'utente e le autorizzazioni associate al cluster
Esempio
Esempio 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
In questo esempio viene aggiunto l'utente "testUpn@tenant.com" nel ruolo di ConnectionCreatorWithReshare al cluster gateway per i tipi di origine dati SQL.
Esempio 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
In questo esempio viene aggiunto l'utente "adminTestUpn@tenant.com" nel ruolo di amministratore al cluster di gateway per tutti i tipi di origine dati.
Si noti che deve AllowedDataSourceTypes essere null quando il ruolo è admin (il che implica che tutti i tipi di origine dati sono consentiti).
Esempio 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
In questo esempio viene aggiunto l'utente "adminTestUpn@tenant.com" nel ruolo di amministratore al cluster di gateway per tutti i tipi di origine dati.
Si noti che deve AllowedDataSourceTypes essere null quando il ruolo è admin (il che implica che tutti i tipi di origine dati sono consentiti).
Questo comando viene eseguito nell'area Brasile meridionale, quindi l'ID del cluster gateway fornito deve trovarsi in tale area.
Esempio 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
In questo esempio viene aggiunta l'entità servizio per l'ID applicazione DC8F2C49-9087-4B27-966B-3DB5094C2E77 nel ruolo di amministratore al cluster gateway per tutti i tipi di origine dati. Per altre informazioni, vedere Get-AzADServicePrincipal. Si noti che deve AllowedDataSourceTypes essere null quando il ruolo è admin (il che implica che tutti i tipi di origine dati sono consentiti). Questo comando viene eseguito nell'area Brasile meridionale, quindi l'ID del cluster gateway fornito deve trovarsi in tale area.
Parametri
-AllowedDataSourceTypes
Tipi di origine dati consentiti per questa combinazione utente/ruolo. Deve essere null se il ruolo è admin (il che implica che tutti i tipi di origine dati sono consentiti). L'elenco dei tipi di origine dati può cambiare in base alle origini dati supportate. Nota: questo parametro si applica solo a PowerApps e Flow.
Proprietà dei parametri
| Tipo: | DatasourceType[] |
| Valore predefinito: | None |
| Valori accettati: | 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 |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-GatewayClusterId
Cluster di gateway a cui aggiungere l'utente
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Gruppo, id |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PrincipalObjectId
ID oggetto principale di Azure Active Directory (AAD) (ad esempio, ID utente) da aggiungere al cluster del gateway
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Utente |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RegionKey
L'area di Azure associata al cluster di gateway specificato. Se non si specifica un -RegionKey comando verrà eseguito nell'area predefinita per il tenant.
Per ottenere l'elenco dei parametri della regione disponibili, eseguire il Get-DataGatewayRegion comando
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Role
Ruolo da applicare all'utente nel cluster. Gli utenti possono essere aggiunti come amministratori, creatori di connessioni (può utilizzare) o creatori di connessioni con funzionalità di condivisione (può utilizzare + Condividi). I creatori di connessioni (possono essere utilizzati) e i creatori di connessioni con funzionalità di condivisione (possono utilizzare + Condividi) si applicano solo a PowerApps e Flow.
Proprietà dei parametri
| Tipo: | GatewayPrincipalRole |
| Valore predefinito: | None |
| Valori accettati: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Scope
Ambito di sicurezza per eseguire il comando. Ciò determina se si sta eseguendo questo comando nell'ambito di un amministratore tenant/servizio o di un amministratore gateway
Proprietà dei parametri
| Tipo: | PowerBIUserScope |
| Valore predefinito: | Individual |
| Valori accettati: | Individual, Organization |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.