Get-CMSecurityRolePermission

获取指定安全角色的权限。

语法

Get-CMSecurityRolePermission
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRolePermission
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityRolePermission
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

说明

使用此 cmdlet 获取指定安全角色的权限。 有关安全角色和权限的详细信息,请参阅 Configuration Manager 中基于角色的管理基础知识

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

注意

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

示例

示例 1:获取特定角色的权限

此示例首先获取变量$role中内置安全角色应用程序作者的对象。 然后,它将该对象传递给 Get-CMSecurityRolePermission cmdlet,并将权限列表保存在 $rolePermission 变量中。

$roleName = "Application author"
$role = Get-CMSecurityRole -Name $roleName
$rolePermission = $role | Get-CMSecurityRolePermission

示例 2:查看特定角色的类

此示例与上一个示例类似,但对结果进行不同的筛选和排序。 它仅显示角色有权访问的类名称,并按字母顺序对列表进行排序。

$rolePermission | Select-Object ObjectTypeDisplayName | Sort-Object -Property ObjectTypeDisplayName

参数

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

指定安全角色的 ID 以获取其权限。 此值是 RoleID 属性,例如 SMS000AROS 部署管理器 角色。

若要查看站点的所有角色和 ID,请使用以下命令:

Get-CMSecurityRole |Select-Object RoleID、RoleName

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

-InputObject

指定安全角色对象以获取其权限。 若要获取此对象,请使用 Get-CMSecurityRole cmdlet。

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

-Name

指定安全角色的名称以获取其权限。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

IResultObject

备注

返回对象是 RoleOperation 类,其中包括 类的 SMS_ARoleOperation 实例。 有关详细信息,请参阅 SMS_ARoleOperation服务器 WMI 类