A PowerShell script module is included in the installation of the On-premises data gateway to support the management of gateway clusters. Once the module is imported to a session of PowerShell in which the user has administrator privileges, a login command (Login-OnPremisesDataGateway) must be be executed to enable other gateway management commands.
By default, the PowerShell module file (.psm1) can be imported from the following path:
Unlike the Manage gateways portal in the Power BI service, the PowerShell commands provide access to the specific gateway instances configured for each cluster. For example, properties of a specific gateway within an instance can be modified or a gateway instance can be removed from a cluster altogether.
In the following example from PowerShell, the gateway admin account ([email protected]) has been used for the Login-OnPremisesDataGateway command:
Once authenticated as Anna Sanders, the Get-OnPremisesDataGatewayClusters command has been used to retrieve the list of gateway clusters in which Anna is an administrator. The list of available gateway cluster PowerShell commands and their parameters can be found here: http://bit.ly/2BfXL2e.