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。