Partager via

Get-CMAdministrativeUser

  • Référence
Module:
ConfigurationManager

Obtenir un utilisateur administratif.

Syntaxe

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

Description

Utilisez cette applet de commande pour obtenir un ou plusieurs utilisateurs administratifs dans Configuration Manager. Un utilisateur administratif dispose d’un ensemble défini d’autorisations et peut être membre d’une ou de plusieurs étendues ou rôles. Un utilisateur administratif dans Configuration Manager définit un utilisateur ou un groupe local ou de domaine. Pour plus d’informations sur les rôles de sécurité, 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 : Obtenir tous les utilisateurs administratifs

Cette commande obtient tous les utilisateurs administratifs. Il affiche la sortie sous la forme d’un tableau montrant le nom du compte (LogonName), les rôles de sécurité (RoleNames), les étendues de sécurité (CategoryNames) et les collections (CollectionNames).

Get-CMAdministrativeUser | Select-Object LogonName, RoleNames, CategoryNames, CollectionNames

Exemple 2 : Obtenir un utilisateur administratif par nom

Cette commande obtient l’utilisateur administratif nommé jqpublic.

Get-CMAdministrativeUser -Name "Contoso\jqpublic"

Exemple 3 : Obtenir tous les utilisateurs avec une étendue spécifique

Cette commande obtient tous les utilisateurs administratifs avec l’étendue Par défaut et affiche les noms de compte.

Get-CMAdministrativeUser | Where-Object { $_.CategoryNames -contains "Default" } | Select-Object LogonName

Exemple 4 : Obtenir tous les utilisateurs avec un rôle spécifique

Cette commande obtient tous les utilisateurs administratifs disposant du rôle Administrateur complet et affiche les noms de compte.

Get-CMAdministrativeUser -RoleName "Full Administrator" | Select-Object LogonName

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 de l’utilisateur administratif à obtenir. Cette valeur est la AdminID propriété . Il s’agit d’une valeur entière, par exemple 16777234.

Type:String
Alias:AdminId
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 de l’utilisateur administratif à obtenir. Par exemple, domain\username ou domain\groupname

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
Type:String
Alias:DisplayName, LogonName, UserName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-RoleName

Spécifiez un tableau de noms de rôles de sécurité. Ce nom peut être pour un rôle intégré ou personnalisé. Pour afficher la liste des rôles de sécurité intégrés, consultez Rôles de sécurité.

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

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

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