Share via


Get-DataGatewayAvailableUpdates

Get latest 6 available gateway versions, or the supported versions for specified gateways to update to

Syntax

Default (Default)

Get-DataGatewayAvailableUpdates

    [<CommonParameters>]

GatewayCluster

Get-DataGatewayAvailableUpdates
    -GatewayClusterId <Guid>
    [-Scope <PowerBIUserScope>]
    [-RegionKey <String>]
    [-MemberGatewayId <Guid>]
    [<CommonParameters>]

Description

Get latest 6 available gateway versions, or the supported versions for specified gateways to update to.

Examples

Example 1

PS C:\> Get-DataGatewayAvailableUpdates

Get latest 6 available gateway versions

Example 2

PS C:\> Get-DataGatewayAvailableUpdates -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77

Get the supported versions for the gateways in the cluster ID DC8F2C49-5731-4B27-966B-3DB5094C2E77 to update to

Example 3

PS C:\> Get-DataGatewayAvailableUpdates -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -MemberGatewayId 64C574B7-86C6-4560-B710-40AC18990804

Get the supported versions for the gateway ID 64C574B7-86C6-4560-B710-40AC18990804 to update to

Parameters

-GatewayClusterId

The ID of the gateway cluster to check available update. It has to be an existing gateway cluster on the same tenant.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False
Aliases:Cluster, Id

Parameter sets

GatewayCluster
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MemberGatewayId

This is the Id of the gateway to check available update. It has to be an existing gateway in the cluster.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

GatewayCluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RegionKey

The region to which the specified gateway belongs to. Not providing a -RegionKey will run the command in the default region for your tenant. To get the list of available region parameters run the Get-DataGatewayRegion command

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

GatewayCluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Scope

Security Scope to run the command. This would determine if you are running this command in the scope of a Tenant/Service admin or a Gateway Admin.

Parameter properties

Type:PowerBIUserScope
Default value:Individual
Accepted values:Individual, Organization
Supports wildcards:False
DontShow:False

Parameter sets

GatewayCluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Microsoft.PowerBI.DataMovement.ExternalContracts.API.GatewayInstallerVersionResponse