Get-CMAdministrativeUser

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 SP1 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. 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

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 (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: 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 character

This command gets administrative users who have a display name that starts 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"

New-CMAdministrativeUser

Remove-CMAdministrativeUser