Share via

Get-CMSecurityRole

  • Référence
Module:
ConfigurationManager

Obtenir des rôles de sécurité.

Syntax

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 Configuration Manager applets de commande à 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:RoleId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Aliases:RoleName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.