Export (0) Print
Expand All
Expand Minimize

New-CMAdministrativeUser

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

New-CMAdministrativeUser

Creates an administrative user for Configuration Manager.

Syntax

Parameter Set: New
New-CMAdministrativeUser -Name <String> -RoleName <String[]> [-CollectionName <String[]> ] [-SecurityScopeName <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The New-CMAdministrativeUser cmdlet creates an administrative user for Microsoft System Center 2012 Configuration Manager. At the same time that you create the administrative user account, you can give the new administrative user access to collections of System Center 2012 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.

For more information about adding administrative users, see Configuring Security for Configuration Manager (http://go.microsoft.com/fwlink/?linkid=247674) on TechNet.

Parameters

-CollectionName<String[]>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

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


Aliases

LogonName

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

true

-RoleName<String[]>

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


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecurityScopeName<String[]>

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.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Creates an administrative user

This command adds the user named pattifuller on the NorthAmerica domain as an administrative user with the Application Author security role. The command adds this user to the resource collection named ClientAdminResources.


PS C:\> New-CMAdministrativeUser -Name "NorthAmerica\pattifuller" -CollectionName "ClientAdminResources" -RoleName "Application Author" 

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft