Partager via

Get-CMSecurityRole

  • Référence
Module:
ConfigurationManager

Obtenir des rôles de sécurité.

Syntaxe

Get-CMSecurityRole
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRole
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir un ou plusieurs rôles de sécurité à partir du site Configuration Manager. 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.

Si votre compte ne dispose pas des autorisations nécessaires pour afficher les rôles de sécurité dans le site, cette applet de commande ne retourne aucun résultat.

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 : Obtenir tous les rôles de sécurité

Cet exemple répertorie tous les rôles et ID du site.

Get-CMSecurityRole | Select-Object RoleID, RoleName

Exemple 2 : Obtenir un rôle de sécurité à l’aide d’un caractère générique

Cette commande obtient tous les rôles de sécurité dont le nom commence par Application.

Get-CMSecurityRole -Name "App*"

Exemple 3 : Répertorier tous les rôles de sécurité personnalisés

Cette commande retourne tous les rôles de sécurité qui ne sont pas intégrés.

Get-CMSecurityRole | Where-Object { $_.IsBuiltIn -eq $false }

Paramètres

-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

-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é à obtenir. Cette valeur est la RoleID propriété, par exemple SMS000AR pour le rôle Gestionnaire de déploiement du système d’exploitation .

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

-Name

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

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

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_Role classe WMI du serveur.