Compartir a través de

Remove-DataGatewayClusterUser

  • Referencia
Módulo:
DataGateway

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

Sintaxis

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 de clúster de puerta de enlace proporcionado debe estar en esa región.

Parámetros

-GatewayClusterId

Clúster de puerta de enlace en el que se debe quitar el usuario

Tipo:Guid
Alias:Cluster, Id
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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

Tipo:Guid
Alias:User
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RegionKey

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 un administrador de puerta de enlace.

Tipo:PowerBIUserScope
Valores aceptados:Individual, Organization
Posición:Named
Valor predeterminado:Individual
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Void