Partager via


Remove-DataGatewayClusterUser

Supprime les utilisateurs (y compris les administrateurs) d’un cluster de passerelle

Syntaxe

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

Description

Supprime les utilisateurs (y compris les administrateurs) d’un cluster de passerelle

Exemples

Exemple 1

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

Supprime l’utilisateur «testUpn@tenant.com» du cluster de passerelle.

Exemple 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

Supprime l’utilisateur «testUpn@tenant.com» du cluster de passerelle. Cette commande est exécutée dans la région sud du Brésil, de sorte que l’ID de cluster de passerelle fourni doit se trouver dans cette région.

Paramètres

-GatewayClusterId

Cluster de passerelle où l’utilisateur doit être supprimé

Type:Guid
Alias:Cluster, Id
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrincipalObjectId

ID d’objet principal Azure Active Directory (AAD) (par exemple, ID utilisateur) de l’utilisateur à supprimer

Type:Guid
Alias:User
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RegionKey

Région dans laquelle cette commande doit s’exécuter. Vous ne fournissez pas de -RegionKey exécutera la commande dans la région par défaut de votre locataire. Pour obtenir la liste des paramètres de région disponibles, exécutez la commande Get-DataGatewayRegion

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Scope

Étendue de sécurité pour exécuter la commande. Cela détermine si vous exécutez cette commande dans l’étendue d’un administrateur client/service ou d’un administrateur de passerelle

Type:PowerBIUserScope
Valeurs acceptées:Individual, Organization
Position:Named
Valeur par défaut:Individual
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Void