Get-DataGatewayCluster
获取当前用户的网关群集
语法
Default （默认值）
Get-DataGatewayCluster
[-Scope <PowerBIUserScope>]
[-RegionKey <String>]
[-GatewayClusterId <Guid>]
[<CommonParameters>]
说明
获取与指定群集 ID 匹配的网关群集，以及当前用户为其管理员的群集。 如果未指定群集 ID，将返回用户为其作为管理员的所有网关群集。
示例
示例 1
PS C:\> Get-DataGatewayCluster
获取当前用户为其管理员的所有网关群集。
示例 2
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77
获取指定网关群集 ID“DC8F2C49-5731-4B27-966B-3DB5094C2E77”的网关群集详细信息
示例 3
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty MemberGateways
获取与指定网关群集 ID“DC8F2C49-5731-4B27-966B-3DB5094C2E77”关联的每个成员网关的详细信息。
示例 4
PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty Permissions
获取有权管理或使用网关群集“DC8F2C49-5731-4B27-966B-3DB5094C2E77”的用户列表。
示例 5
PS C:\> Get-DataGatewayCluster -Scope Organization
获取组织中的所有网关群集。
注意：必须是 O365 租户管理员、Power Platform 管理员或 Power BI 管理员才能使用 -Scope Organization 选项。
示例 6
PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth
获取你是管理员的网关群集，并将其关联到巴西南部区域。
参数
-GatewayClusterId
网关群集唯一的 ID
参数属性
| 类型: | Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 集群, Id |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RegionKey
与网关关联的 Azure 区域。 如果未提供 -RegionKey，将使用租户的默认 Power BI 区域。
若要获取可用区域参数的列表，请运行 Get-DataGatewayRegion cmdlet
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Scope
用于运行命令的安全作用域。 这将确定是否在租户/服务管理员或网关管理员的范围内运行此命令
参数属性
| 类型: | PowerBIUserScope |
| 默认值: | Individual |
| 接受的值: | Individual, Organization |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。