Remove-DataGatewayClusterUser

从网关群集中删除用户(包括管理员)

语法

Default (默认值)

Remove-DataGatewayClusterUser
    [-Scope <PowerBIUserScope>]
    [-RegionKey <String>]
    -GatewayClusterId <Guid>
    -PrincipalObjectId <Guid>
    [<CommonParameters>]

说明

从网关群集中删除用户(包括管理员)

示例

示例 1

PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove

从网关群集中删除用户“testUpn@tenant.com”。

示例 2

PS C:\> $userToRemove = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Remove-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToRemove -RegionKey brazilsouth

从网关群集中删除用户“testUpn@tenant.com”。 此命令在巴西南部区域运行,因此提供的网关群集 ID 应位于该区域。

参数

-GatewayClusterId

需要删除用户的网关群集

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False
别名:集群, Id

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PrincipalObjectId

要删除的用户的 Azure Active Directory (AAD) 主体对象 ID(即用户 ID)

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False
别名:用户

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RegionKey

此命令必须在其中运行的区域。 不提供 -RegionKey 将在租户的默认区域中运行命令。 若要获取可用区域参数的列表,请运行 Get-DataGatewayRegion 命令

参数属性

类型: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

输入

None

输出

System.Void