Set-CMConfigurationItem

Changes settings for a Configuration Manager configuration item.

Syntax

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

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
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
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
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[]
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
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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Digest
Type:ConfigurationItem
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DigestPath
Type:String
Aliases:DesiredConfigurationDigestPath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DigestXml
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

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

Specifies a new name for a configuration item.

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

Returns the current working object. By default, this cmdlet does not generate any output.

Type:SwitchParameter
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[]
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False