Remove-RoleGroupMember

Syntax

Remove-RoleGroupMember
      [-Identity] <RoleGroupIdParameter>
      -Member <SecurityPrincipalIdParameter>
      [-BypassSecurityGroupManagerCheck]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-WhatIf]
      [<CommonParameters>]

Description

Lorsque vous supprimez un membre d'un groupe de rôles, ce membre ne peut plus gérer les fonctionnalités fournies par le groupe de rôles si celui-ci est le seul moyen par lequel le membre a accès à ces fonctionnalités.

Si la propriété ManagedBy a été renseignée avec des gestionnaires de groupes de rôle, l'utilisateur supprimant un membre d'un groupe de rôles doit être un gestionnaire de groupes de rôles. Sinon, si l’utilisateur est membre du groupe de rôles de Gestion des organisations ou si le rôle de Gestion des rôles lui est directement ou indirectement attribué, le commutateur BypassSecurityGroupManagerCheck peut être utilisé pour remplacer la vérification de gestion des groupes de sécurité.

Si le groupe de rôles est un groupe de rôles lié, vous ne pouvez pas utiliser la cmdlet Remove-RoleGroupMember pour supprimer des membres du groupe de rôles. Au lieu de cela, vous devez supprimer des membres du groupe de sécurité universel étranger qui est lié au groupe de rôles lié. Pour rechercher le groupe de sécurité universel étranger lié à un groupe de rôles, utilisez la cmdlet Get-RoleGroup.

Pour plus d'informations sur les groupes de rôles, consultez la rubrique Présentation des groupes de rôles de gestion.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Remove-RoleGroupMember "Recipient Management" -Member David

Cet exemple supprime l'utilisateur David du groupe de rôles Gestion des destinataires.

Exemple 2

Get-User -Filter "Department -eq 'Sales' -and -RecipientType -eq 'UserMailbox'" | Get-Mailbox | Remove-RoleGroupMember "Sales and Marketing Group" -WhatIf

Cet exemple recherche toutes les boîtes aux lettres faisant partie du service Ventes et les supprime du groupe de rôles Groupe de ventes et de marketing. Étant donné que nous utilisons le commutateur WhatIf, les modifications ne sont pas écrites dans le groupe de rôles. Vous pouvez donc vérifier que les membres appropriés seront supprimés.

Après avoir vérifié que les membres appropriés seront supprimés du groupe de rôles, supprimez le commutateur WhatIf et réexécutez la commande.

Pour plus d’informations sur le pipelining et le paramètre WhatIf, voir les rubriques suivantes :

• À propos des pipelines
• Commutateurs WhatIf, Confirm et ValidateOnly

Exemple 3

Remove-RoleGroupMember "Training Administrators" -Member "Training Assistants" -BypassSecurityGroupManagerCheck

Cet exemple supprime le groupe de sécurité universel Assistants de formation du groupe de rôles Administrateurs de formation. L’utilisateur exécutant la commande n’ayant pas été ajoutée à la propriété ManagedBy du groupe de rôles, le commutateur BypassSecurityGroupManagerCheck doit être utilisé. Le rôle de Gestion des rôles est attribué à l’utilisateur, ce qui lui permet de contourner la vérification du gestionnaire de groupe de sécurité.

Paramètres

-BypassSecurityGroupManagerCheck

-Confirm

-DomainController

-Identity

-Member

-WhatIf

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.