DataGateway Module
Cmdlets do PowerShell para habilitar a instalação, configuração, gerenciamento de segurança e outros recursos de gateway do gateway.
Observação
O PowerShell para fontes de dados do Power BI oferece suporte apenas ao Individual valor.
Este módulo inclui exemplos que se destinam a ser um ponto de partida para cenários típicos de administrador de gateway. Recomendamos que você copie os scripts para outro local e modifique-os para atender às suas necessidades.
Exemplos individuais podem ser invocados com o seguinte padrão de código do PowerShell: &(Join-Path ((Get-Module -ListAvailable DataGateway).ModuleBase) Samples\<sample name>) <argument1> <argument2> ...
O InstallAndAddDataGateway-Sample.ps1 script de exemplo automatiza o processo de instalação de um gateway, configuração de um gateway e adição de um usuário adicional como administrador de gateway (a conta que criou o gateway é o administrador padrão).
Comandos DataGateway
| Cmdlet | Description |
|---|---|
| Add-DataGatewayCluster |
Creates a new data gateway cluster once the gateway has been installed on a machine |
| Add-DataGatewayClusterDatasourceUser |
Grants a user permission to use the specified Power BI datasource. |
| Add-DataGatewayClusterMember |
Creates a new data gateway cluster member in an existing cluster once the gateway has been installed on a machine To use this cmdlet, your gateway version must be 3000.162.9 (Feb 2023) or higher. These cmdlets require Powershell 7 or higher. For more information, see the online documentation for installation guidelines. |
| Add-DataGatewayClusterUser |
Add user and associated permissions to cluster |
| Get-DataGatewayCluster |
Get gateway clusters for the current user |
| Get-DataGatewayClusterDatasource |
Gets Power BI data sources for gateway clusters the user is an admin of. |
| Get-DataGatewayClusterDatasourceStatus |
Checks the connectivity status of the specified Power BI datasource from the specified gateway cluster |
| Get-DataGatewayClusterDatasourceUser |
Gets a list of users who have access to the specified Power BI datasource on the specified gateway cluster |
| Get-DataGatewayClusterStatus |
Gets gateway cluster status |
| Get-DataGatewayDatasource |
Gets the list of datasources that the user has access to |
| Get-DataGatewayInstaller |
Get list of users who are authorized to install and register gateways in the organization. This command would be available only for Tenant/Service admin or a Gateway Admin. |
| Get-DataGatewayRegion |
Gets all gateway Azure regions |
| Get-DataGatewayTenantPolicy |
Gets the gateway installation and registration policy for the tenant. |
| Install-DataGateway |
Downloads and installs the gateway on a machine |
| Remove-DataGatewayCluster |
Removes a gateway cluster. This does not uninstall the gateway from the gateway member machine(s). |
| Remove-DataGatewayClusterDatasource |
Removes the specified Power BI datasource from the specified cluster |
| Remove-DataGatewayClusterDatasourceUser |
Removes the specified user from the specified Power BI datasource of the specified gateway cluster |
| Remove-DataGatewayClusterMember |
Remove gateway from gateway cluster. This does not uninstall the gateway from the machine. |
| Remove-DataGatewayClusterUser |
Removes users (including admins) from a gateway cluster |
| Set-DataGatewayCluster |
Set attributes of an existing gateway cluster |
| Set-DataGatewayClusterDatasource |
Set the properties of the specified Power BI datasource from the specified cluster |
| Set-DataGatewayInstaller |
Modify list of users who can install and register new gateways in your organization You need to login as a Tenant Admin to run this command. |
| Set-DataGatewayTenantPolicy |
Set the gateway installation and registration policy for the tenant. You need to login as a Tenant Admin to run this command. |