Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

Get-CMAdministrativeUser

Updated: February 7, 2014

Applies To: System Center 2012 R2 Configuration Manager

Get-CMAdministrativeUser

Gets Configuration Manager administrative users.

Syntax

Parameter Set: SearchByName
Get-CMAdministrativeUser [-Name <String[]> ] [-RoleName <String[]> ] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Get-CMAdministrativeUser -Id <String[]> [-RoleName <String[]> ] [ <CommonParameters>]




Detailed Description

The Get-CMAdministrativeUser cmdlet gets one or more administrative users in Microsoft System Center 2012 Configuration Manager. An administrative user has a defined set of permissions and may be a member of one or more scopes or roles.

Parameters

-Id<String[]>

Specifies an array of IDs for administrative users.


Aliases

AdminId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of administrative user names in the form of <domain>\<user>.


Aliases

DisplayName

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

true

-RoleName<String[]>

Specifies an array of names of security roles. 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

RoleNames

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

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: Get an administrative user by using an ID

This command gets the administrative user who has the ID 16777217 and who is assigned to the Application Author security role.


PS C:\> Get-CMAdministrativeUser -Id "16777217" -RoleNames "Application Author"

Example 2: Get an administrative user by using a wildcard

This command gets administrative users who have a display name that begins with the letter D.


PS C:\> Get-CMAdministrativeUser -Name D*

Example 3: Get an administrative user by using a security role assignment

This command gets administrative users who are assigned to the Application Administrator security role.


PS C:\> Get-CMAdministrativeUser -RoleNames "Application Administrator"

Related topics

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.