Get-CMAdministrativeUser

获取管理用户。

语法

Get-CMAdministrativeUser
   [-Name <String>]
   [-RoleName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMAdministrativeUser
   -Id <String>
   [-RoleName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 在 Configuration Manager 中获取一个或多个管理用户。 管理用户具有一组已定义的权限,并且可能是一个或多个范围或角色的成员。 Configuration Manager 中的 管理用户 定义本地或域用户或组。 有关安全角色的详细信息,请参阅 Configuration Manager 中基于角色的管理基础知识

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门

示例

示例 1:获取所有管理用户

此命令获取所有管理用户。 它将输出显示为一个表,其中显示帐户名称 (LogonName) 、安全角色 (RoleNames) 、安全作用域 (CategoryNames) ,以及 集合 (CollectionNames) 。

Get-CMAdministrativeUser | Select-Object LogonName, RoleNames, CategoryNames, CollectionNames

示例 2:按名称获取管理用户

此命令获取名为 jqpublic 的管理用户。

Get-CMAdministrativeUser -Name "Contoso\jqpublic"

示例 3:获取具有特定范围的所有用户

此命令获取具有 默认 范围的所有管理用户,并显示帐户名称。

Get-CMAdministrativeUser | Where-Object { $_.CategoryNames -contains "Default" } | Select-Object LogonName

示例 4:获取具有特定角色的所有用户

此命令获取具有 完全管理员 角色的所有管理用户,并显示帐户名称。

Get-CMAdministrativeUser -RoleName "Full Administrator" | Select-Object LogonName

参数

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Id

指定要获取的管理用户的 ID。 此值为 AdminID 属性。 它是一个整数值,例如 16777234

类型:String
别名:AdminId
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

指定要获取的管理用户的名称。 例如, domain\usernamedomain\groupname

可以使用通配符:

  • *:多个字符
  • ?:单个字符
类型:String
别名:DisplayName, LogonName, UserName
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:True

-RoleName

指定安全角色名称数组。 此名称可以是内置角色或自定义角色。 若要查看内置安全角色的列表,请参阅 安全角色

类型:String[]
别名:RoleNames
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

IResultObject[]

IResultObject

备注

有关此返回对象及其属性的详细信息,请参阅 SMS_Admin服务器 WMI 类