Set-CMConfigurationItem

参考

模块:: ConfigurationManager

更改 Configuration Manager 配置项目的设置。

语法

Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Id] <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-Name] <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMConfigurationItem
   [-AddCategory <String[]>]
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveCategory <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMConfigurationItem cmdlet 更改 Configuration Manager 配置项目的设置。

配置项目包含一个或多个设置以及符合性规则。项通常定义要监视的配置单元。有关配置项目的详细信息，请参阅 Configuration Manager 中的符合性设置简介。

注意

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

示例

示例 1：更改配置项目的名称

PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"

此命令将名为 CITest 的配置项目的名称更改为 CITest01。

示例 2：设置项设置

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"

此命令将安全范围操作设置为 AddMembership，并将名为 CITest01 的项的安全作用域名称设置为 DefaultScope。

示例 3：更改项设置

PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"

此命令将安全作用域操作设置为 RemoveMembership，并将名为 CITest01 的项的安全作用域名称设置为 DefaultScope。

参数

-AddCategory

指定配置项目所属类别的本地化名称数组。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-Description

指定配置项的说明。

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

-Digest

指定包含配置项目的摘要。

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

-DigestPath

指定摘要的路径。

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

-DigestXml

指定 XML 定义。

类型:	String
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

指定一个或多个配置项目的标识符数组。可以使用逗号分隔列表。

类型:	Int32
别名:	CIId, CI_ID
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

指定配置项目对象。若要获取配置项目对象，可以使用 Get-CMConfigurationItem cmdlet。

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

-Name

指定配置项的名称数组。

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

-NewName

指定配置项目的新名称。

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

-PassThru

返回当前工作对象。默认情况下，此 cmdlet 不生成任何输出。

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

-RemoveCategory

指定要从中删除配置项的类别的本地化名称数组。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。此 cmdlet 未运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

反馈

此页面是否有帮助？