New-CMAdministrativeUser

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 SP1 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 how to add administrative users, see Configuring Security for Configuration Manager (https://go.microsoft.com/fwlink/?linkid=247674) in the TechNet library.

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. The acceptable values for this parameter 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 running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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 who has 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" 

Get-CMAdministrativeUser

Remove-CMAdministrativeUser