Remove-ManagementRole

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Remove-ManagementRole permet de supprimer les rôles de gestion personnalisés dont vous n’avez plus besoin.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Remove-ManagementRole -Identity <RoleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-Recurse <SwitchParameter>] [-UnScopedTopLevel <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple supprime le rôle unique ExampleRole1.

Remove-ManagementRole ExampleRole1

Cet exemple exécute la cmdlet Remove-ManagementRole avec le commutateur WhatIf. Le commutateur WhatIf autorise l’exécution de la commande comme si elle allait effectuer l’action que vous avez spécifiée, mais ne valide aucune modification. Au lieu de cela, il affiche les résultats qui auraient été obtenus, afin de vous assurer que les actions sont correctes.

Remove-ManagementRole ExampleRole2 -Recurse -WhatIf

Si les résultats sont conformes aux attentes, la commande suivante peut être utilisée pour supprimer le rôle parent ExampleRole2 et tous ses rôles enfants.

Remove-ManagementRole ExampleRole2 -Recurse

Cet exemple utilise la cmdlet Get-ManagementRole pour obtenir une liste des rôles qui contiennent la chaîne « Exemple » dans le nom de rôle, puis canalise la liste vers la cmdlet Remove-ManagementRole. La cmdlet Remove-ManagementRole, puisque le commutateur WhatIf est spécifié, affiche les rôles qui auraient été supprimés mais ne valide aucune modification. Si les résultats correspondent aux prévisions, la commande peut être exécutée à nouveau sans le commutateur WhatIf pour supprimer les rôles.

Get-ManagementRole *Example* | Remove-ManagementRole -WhatIf

Cet exemple supprime le rôle de gestion de niveau supérieur non délimité des scripts internes. Comme il s’agit d’un rôle de niveau supérieur non délimité, vous devez utiliser le commutateur UnScopedTopLevel.

Remove-ManagementRole "In-house scripts" -UnScopedTopLevel

Pour plus d’informations sur les rôles de gestion de niveau supérieur non délimités, voir Présentation des rôles de gestion.

Vous devez supprimer toutes les attributions de rôle de gestion d’un rôle avant de le supprimer. Si le rôle est le parent de rôles enfants, les rôles enfants doivent être supprimés avant de supprimer le rôle parent, ou vous devez utiliser le paramètre Recurse lorsque vous supprimez le rôle parent. Vous pouvez supprimer uniquement des rôles personnalisés. Les rôles intégrés, tels que le rôle Destinataires de message, ne peuvent pas être supprimés. Pour plus d’informations sur la suppression d’un rôle personnalisé, voir Supprimer un rôle.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir entrée «  Rôles de gestion  » dans la rubrique Autorisations pour la gestion des rôles.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.RoleIdParameter

Le paramètre Identity spécifie le rôle personnalisé à supprimer. Si le nom du rôle contient des espaces, mettez le nom entre guillemets (").

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Recurse

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Recurse supprime tous les rôles enfants du rôle spécifié avec le paramètre Identity, puis supprime le rôle spécifié.

CautionAttention :
Le paramètre Recurse supprime tous les rôles enfants du rôle spécifié. Nous vous recommandons d’utiliser d’abord la commande avec le commutateur WhatIf pour confirmer que l’action à entreprendre est correcte.

UnScopedTopLevel

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur UnScopedTopLevel spécifie que le rôle que vous tentez de supprimer est un rôle de niveau supérieur non délimité. Vous devez utiliser ce commutateur si vous souhaitez supprimer un rôle de niveau supérieur non délimité.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

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.

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.

 
Afficher: