DataGateway Module
PowerShell-Cmdlets zum Aktivieren der Gatewayinstallation, -konfiguration, -verwaltung der Sicherheit und anderer Gatewayfunktionen.
Hinweis
PowerShell für Power BI-Datenquellen unterstützt nur den Individual Wert.
Dieses Modul enthält Beispiele, die als Ausgangspunkt für typische Gatewayadministratorszenarien dienen sollen. Wir empfehlen Ihnen, die Skripte an einen anderen Speicherort zu kopieren und sie an Ihre Bedürfnisse anzupassen.
Einzelne Beispiele können mit dem folgenden PowerShell-Codemuster aufgerufen werden: &(Join-Path ((Get-Module -ListAvailable DataGateway).ModuleBase) Samples\<sample name>) <argument1> <argument2> ...
Das InstallAndAddDataGateway-Sample.ps1 Beispielskript automatisiert den Prozess der Installation eines Gateways, des Konfigurierens eines Gateways und des Hinzufügens eines zusätzlichen Benutzers als Gatewayadministrator (das Konto, das das Gateway erstellt hat, ist der Standardadministrator).
DataGateway-Befehle
| Cmdlet | Beschreibung |
|---|---|
| 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. |