Set-CMSecurityScope
配置安全范围。
语法
Set-CMSecurityScope
[-Description <String>]
-InputObject <IResultObject>
[-NewName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSecurityScope
[-Description <String>]
-Id <String>
[-NewName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSecurityScope
[-Description <String>]
-Name <String>
[-NewName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
使用此 cmdlet 更改安全范围的配置设置。 只能配置自定义范围。
有关安全范围的详细信息,请参阅 Configuration Manager 中基于角色的管理基础知识。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:重命名安全范围
第一个命令获取名为 Scope1 的安全作用域对象,并将其存储在 $Scope 变量中。
第二个命令将安全范围的名称更改为 “管理范围”。
$Scope = Get-CMSecurityScope -Name "Scope1"
Set-CMSecurityScope -InputObject $Scope -NewName "Admin scope"
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
为安全范围指定可选说明。
类型: | String |
别名: | CategoryDescription |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Id
指定要配置的安全范围的 ID。 此值为 CategoryID
属性。 由于此 cmdlet 仅适用于自定义范围,因此此值应始终以网站代码开头。 内置作用域的 (ID 以 SMS
.) 开头
类型: | String |
别名: | CategoryId |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-InputObject
指定要配置的安全作用域对象。 若要获取此对象,请使用 Get-CMSecurityScope cmdlet。
类型: | IResultObject |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Name
指定要配置的安全范围的名称。
类型: | String |
别名: | CategoryName |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-NewName
为安全范围指定新名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object