New-CMConfigurationItem

Creates a configuration item.

Syntax

New-CMConfigurationItem
   [-Category <String[]>]
   [-Confirm]
   -CreationType <CICreationType>
   [-Description <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -Name <String>
   [-WhatIf]
   [<CommonParameters>]
New-CMConfigurationItem [-Category ] [-Confirm] [-Description ] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -Name  -ParentConfigurationItem  [-WhatIf]
 []

Description

The New-CMConfigurationItem cmdlet creates a configuration item in Microsoft System Center Configuration Manager. Create configuration items to define configurations that you want to manage and assess for compliance on devices.

You can specify the ParentConfigurationItem parameter to create a child configuration item. Child configuration items in System Center Configuration Manager are copies of configuration items that retain a relationship to the original configuration item; therefore, they inherit the original configuration from the parent configuration item. You cannot create child configuration items for mobile devices.

Examples

Example 1: Create a configuration item

PS C:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"

This command creates a configuration item for mobile devices named MD_Config88.

Required Parameters

-CreationType

Specifies the type of configuration item. The acceptable values for this parameter are:- MacOS

  • MobileDevice
  • None
  • WindowsApplication
  • WindowsOS
Type:CICreationType
Parameter Sets:None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies a name for the configuration item.

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

Specifies a parent CMConfigurationItem object. To obtain a CMConfigurationItem object, use the Get-CMConfigurationItem cmdlet.

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

Optional Parameters

-Category

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

Type:String[]
Aliases:LocalizedCategoryInstanceNames
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
-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
-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