Get-CMObjectSecurityScope

获取对象的安全作用域。

语法

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

说明

使用此 cmdlet 获取与 Configuration Manager 对象关联的安全作用域。

有关安全范围的详细信息,请参阅 Configuration Manager 中基于角色的管理基础知识

注意

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

示例

示例 1:获取应用程序的安全范围

此命令首先获取名为 Central app 的应用程序对象。 然后,它使用管道运算符将对象传递到 Get-CMObjectSecurityScope,后者获取与应用程序对象关联的所有安全作用域。

Get-CMApplication -Name "Central app" | Get-CMObjectSecurityScope

示例 2:获取包的安全范围

此命令获取名为 Scope1 的安全作用域,该作用域与 ID 为 XYZ00001 的包相关联。

$pkg = Get-CMPackage -Id "XYZ00001"
Get-CMObjectSecurityScope -InputObject $pkg -Name "Scope1"

参数

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

指定与 Configuration Manager 对象关联的安全作用域的 ID。 此值是 CategoryID 属性,例如SMS00UNA默认范围。

Type:String
Aliases:CategoryId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

指定与安全范围关联的Configuration Manager对象。 若要获取此对象,请使用 对象类型的 Get cmdlet。 例如,应用对象的 Get-CMApplication

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定与 Configuration Manager 对象关联的安全作用域的名称。

Type:String
Aliases:CategoryName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject[]

IResultObject

备注

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