Get-DataGatewayCluster

获取当前用户的网关群集

语法

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
别名:Cluster, Id
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RegionKey

与网关关联的 Azure 区域。 如果未提供 -RegionKey,将使用租户的默认 Power BI 区域。 若要获取可用区域参数的列表,请运行 Get-DataGatewayRegion cmdlet

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Scope

用于运行命令的安全作用域。 这将确定是否在租户/服务管理员或网关管理员的范围内运行此命令

类型:PowerBIUserScope
接受的值:Individual, Organization
Position:Named
默认值:Individual
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.GatewayCluster