New-CMAdministrativeUser

Creates an administrative user.

Syntax

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

Description

The New-CMAdministrativeUser cmdlet creates an administrative user for Microsoft System Center Configuration Manager. At the same time that you create the administrative user account, you can give the new administrative user access to collections of Configuration Manager resources. You can also define the types of access that the new administrative user has to each collection by assigning security roles to the user.

Examples

Example 1: Add an administrative user

PS C:\> New-CMAdministrativeUser -Name "Consoto\AdminUser1" -RoleName "Application Administrator","Software Update Manager" -SecurityScopeName "scope1","scope2" -CollectionName "userCollection1","deviceCollection1"

This command adds the user named AdminUser1 as an administrative user to the Application Administrator and Software Update Manager security roles. The command also adds admin1 to the security scopes named scope1 and scope 2, and to the collections userCollection1 and deviceCollection1.

Required Parameters

-Name

Specifies the name of the administrative user in the form <domain>\<user>.

Type:String
Aliases:LogonName
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RoleName

Specifies an array of names for the roles that you assign to an administrative user. Valid values are:- Application Administrator

  • Application Author
  • Application Deployment Manager
  • Asset Manager
  • Compliance Settings Manager
  • Discovery Operator
  • Endpoint Protection Manager
  • Full Administrator
  • Infrastructure Administrator
  • Operating System Deployment Manager
  • Operations Administrator
  • Read-only Analyst
  • Remote Tools Operator
  • Security Administrator
  • Software Update Manager
  • Custom-defined security roles
Type:String[]
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-CollectionName

Specifies an array of collection names. The cmdlet assigns the new administrative user to each of these collections.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SecurityScopeName

Specifies an array of names of security scopes. A security scope name can be "Default" or the name of a custom security scope. The cmdlet assigns the security scopes that you specify to the administrative user.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False