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 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 the article Configuring Security for Configuration Manager on Microsoft 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 for the security scopes to which you assign an 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 sarahjones 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\sarahjones" -CollectionName "ClientAdminResources" -RoleName "Application Author"