Share via


Remove-DataGatewayClusterUser

Quita usuarios (incluidos los administradores) de un clúster de puerta de enlace.

Syntax

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

Description

Quita usuarios (incluidos los administradores) de un clúster de puerta de enlace.

Ejemplos

Ejemplo 1

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

Quita el usuario "testUpn@tenant.com" del clúster de puerta de enlace.

Ejemplo 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

Quita el usuario "testUpn@tenant.com" del clúster de puerta de enlace. Este comando se ejecuta en la región sur de Brasil, por lo que el identificador del clúster de puerta de enlace proporcionado debe estar en esa región.

Parámetros

-GatewayClusterId

Clúster de puerta de enlace donde se debe quitar el usuario

Type:Guid
Aliases:Cluster, Id
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrincipalObjectId

Identificador de objeto de entidad de seguridad de Azure Active Directory (AAD) (es decir, identificador de usuario) del usuario que se va a quitar

Type:Guid
Aliases:User
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RegionKey

Región en la que se debe ejecutar este comando. Si no se proporciona , -RegionKey se ejecutará el comando en la región predeterminada del inquilino. Para obtener la lista de parámetros de región disponibles, ejecute el Get-DataGatewayRegion comando .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Ámbito de seguridad para ejecutar el comando. Esto determinaría si ejecuta este comando en el ámbito de un administrador de inquilinos o servicios o una puerta de enlace Administración

Type:PowerBIUserScope
Accepted values:Individual, Organization
Position:Named
Default value:Individual
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

System.Void