Partager via

New-CMAdministrativeUser

  • Référence
Module:
ConfigurationManager

Créer un utilisateur administratif.

Syntaxe

New-CMAdministrativeUser
   [-CollectionName <String[]>]
   -Name <String>
   -RoleName <String[]>
   [-SecurityScopeName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMAdministrativeUser
   -Name <String>
   -Permission <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un utilisateur administratif pour Configuration Manager. Un utilisateur administratif dans Configuration Manager définit un utilisateur ou un groupe local ou de domaine. Lorsque vous créez l’utilisateur administratif dans Configuration Manager, vous pouvez lui accorder l’accès aux rôles de sécurité, aux étendues de sécurité et aux regroupements. 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 : Ajouter un utilisateur administratif

Cette commande ajoute l’utilisateur de domaine Contoso nommé AdminUser1 en tant qu’utilisateur administratif. Il ajoute cet utilisateur aux rôles de sécurité intégrés Administrateur d’application et Gestionnaire de mises à jour logicielles. La commande ajoute également l’utilisateur aux étendues de sécurité scope1 et scope2 , ainsi qu’aux collections userCollection1 et deviceCollection1 .

$name = "Contoso\AdminUser1"
$roles = "Application Administrator","Software Update Manager"
$scopes = "scope1","scope2"
$colls = "userCollection1","deviceCollection1"

New-CMAdministrativeUser -Name $name -RoleName $roles -SecurityScopeName $scopes -CollectionName $colls

Exemple 2 : Ajouter un groupe de domaines

Cet exemple ajoute le groupe de domaines Contoso Analystes de sécurité au rôle de sécurité Analyste en lecture seule intégré.

New-CMAdministrativeUser -Name "Contoso\Security Analysts" -RoleName "Read-only Analyst"

Paramètres

-CollectionName

Spécifiez un tableau de noms de collection. L’applet de commande affecte le nouvel utilisateur administratif à chacune de ces collections.

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

-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

-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

-Name

Spécifiez le nom de l’utilisateur administratif à ajouter. Utilisez le format domain\name, où name est l’utilisateur ou le groupe.

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

-Permission

Spécifiez un tableau d’objets d’autorisations à attribuer à ce nouvel utilisateur. Pour obtenir ces objets, utilisez l’applet de commande New-CMAdministrativeUserPermission .

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

-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[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SecurityScopeName

Spécifiez un tableau de noms d’étendue de sécurité. Un nom d’étendue de sécurité peut être « Par défaut » ou le nom d’une étendue de sécurité personnalisée. L’applet de commande affecte les étendues de sécurité que vous spécifiez à l’utilisateur administratif.

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

-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

None

Sorties

IResultObject

Notes

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