Partager via

Remove-CMSecurityRole

  • Référence
Module:
ConfigurationManager

Supprimez un rôle de sécurité personnalisé.

Syntaxe

Remove-CMSecurityRole
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSecurityRole
      [-Force]
      -Id <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSecurityRole
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour supprimer un rôle de sécurité personnalisé de Configuration Manager. Spécifiez le nom ou l’ID d’un rôle de sécurité que vous souhaitez supprimer ou utilisez l’applet de commande Get-CMSecurityRole pour en obtenir un.

Vous pouvez utiliser l’applet de commande Remove-CMSecurityRole pour supprimer les anciens rôles de sécurité personnalisés inutiles. Vous ne pouvez pas supprimer les rôles de sécurité intégrés. Chaque utilisateur administratif doit avoir au moins un rôle de sécurité. Avant de supprimer un rôle de sécurité, assurez-vous que chaque utilisateur dispose d’un rôle en plus de celui que vous supprimez.

Pour plus d’informations sur les rôles de sécurité et les autorisations, consultez Principes de base de l’administration basée sur les rôles dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Supprimer un rôle de sécurité à l’aide d’un nom

Cette commande supprime un rôle de sécurité nommé MainSecurityRole. La commande utilise le paramètre Force , donc elle ne vous invite pas à confirmer.

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

Exemple 2 : Supprimer un rôle de sécurité à l’aide d’une variable

La première commande utilise l’applet de commande Get-CMSecurityRole pour obtenir tous les rôles de sécurité qui commencent par Customet les stocke dans la variable $role .

La deuxième commande supprime le premier rôle de sécurité stocké dans le tableau. Étant donné qu’elle ne spécifie pas le paramètre Force , cette commande invite à confirmer.

$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-Id

Spécifiez l’ID du rôle de sécurité à supprimer. Cette valeur est la RoleID propriété . Étant donné que cette applet de commande fonctionne uniquement avec les rôles personnalisés, cette valeur doit toujours commencer par le code de site. (Les ID des rôles intégrés commencent par SMS.)

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

-InputObject

Spécifiez un objet de rôle de sécurité à supprimer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSecurityRole .

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

-Name

Spécifiez le nom du rôle de sécurité à supprimer.

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object