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"