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 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 (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
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"