通过

Get-CMSecurityRole

  • 参考
模块:
ConfigurationManager

获取安全角色。

语法

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

说明

使用此 cmdlet 可从 Configuration Manager 站点获取一个或多个安全角色。 有关安全角色和权限的详细信息，请参阅 Configuration Manager 中基于角色的管理基础知识。

如果你的帐户没有权限查看站点中的安全角色，则此 cmdlet 不会返回任何结果。

注意

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

示例

示例 1：获取所有安全角色

此示例列出站点的所有角色和 ID。

Get-CMSecurityRole | Select-Object RoleID, RoleName

示例 2：使用通配符获取安全角色

此命令获取名称以 App 开头的所有安全角色。

Get-CMSecurityRole -Name "App*"

示例 3：列出所有自定义安全角色

此命令返回所有非内置安全角色。

Get-CMSecurityRole | Where-Object { $_.IsBuiltIn -eq $false }

参数

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

指定要获取的安全角色的 ID。 此值是 RoleID 属性，例如 SMS000AROS 部署管理器 角色。

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

-Name

指定要获取的安全角色的名称。

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

输入

None

输出

IResultObject[]

IResultObject

备注

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