Set-CMConfigurationItem

Changes settings for a Configuration Manager configuration item.

Syntax

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

Description

The Set-CMConfigurationItem cmdlet changes settings for a Microsoft System Center Configuration Manager configuration item.

Configuration items contain one or more settings, along with compliance rules. Items usually define a unit of configuration you want to monitor. For more information about configuration items, see Introduction to Compliance Settings in Configuration Manager on TechNet.

Examples

Example 1: Change the name of a configuration item

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

This command changes the name of the configuration item named CITest to CITest01.

Example 2: Set item settings

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

This command sets the security scope action to AddMembership and the security scope name to DefaultScope for the item named CITest01.

Example 3: Change item settings

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

This command sets the security scope action to RemoveMembership and the security scope name to DefaultScope for the item named CITest01.

Required Parameters

-Id

Specifies an array of identifiers for one or more configuration items. You can use a comma separated list.

Type:Int32
Aliases:CIId, CI_ID
Required:True
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Specifies a configuration item object. To obtain a configuration item object, you can use the Get-CMConfigurationItem cmdlet.

Type:IResultObject
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Name

Specifies an array of names for configuration items.

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

Optional Parameters

-AddCategory

Specifies an array of localized names of the categories to which the configuration item belongs.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Description

Specifies a description for a configuration item.

Type:String
Aliases:LocalizedDescription
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Digest
Type:ConfigurationItem
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DigestPath
Type:String
Aliases:DesiredConfigurationDigestPath
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DigestXml
Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

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

Indicates that wildcard handling is enabled.

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

Specifies a new name for a configuration item.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

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

Specifies an array of localized names of the categories from which to remove the configuration item.

Type:String[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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