.png)
New-CMConfigurationItem
Updated: March 1, 2013
Applies To: System Center 2012 Configuration Manager SP1
New-CMConfigurationItem
Syntax
Parameter Set: New New-CMConfigurationItem -CreationType <CICreationType> -Name <String> [-Category <String[]> ] [-Description <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>] Parameter Set: NewChild New-CMConfigurationItem -Name <String> -ParentConfigurationItem <IResultObject> [-Category <String[]> ] [-Description <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The New-CMConfigurationItem cmdlet creates a configuration item in Microsoft System Center 2012 Configuration Manager. Create configuration items in CM 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 2012 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.
Parameters
-Category<String[]>
Specifies an array of localized names of the categories to which the configuration item belongs.
Aliases | LocalizedCategoryInstanceNames |
Required? | false |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-CreationType<CICreationType>
Specifies the type of configuration item. Valid values are:
-- MacOS
-- MobileDevice
-- None
-- WindowsApplication
-- WindowsOS
Aliases | none |
Required? | true |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-Description<String>
Specifies a description for a configuration item.
Aliases | LocalizedDescription |
Required? | false |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-Name<String>
Specifies a name for the configuration item.
Aliases | LocalizedDisplayName |
Required? | true |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-ParentConfigurationItem<IResultObject>
Specifies a parent CMConfigurationItem object. To obtain a CMConfigurationItem object, use the Get-CMConfigurationItem cmdlet.
Aliases | none |
Required? | true |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-Confirm
Prompts you for confirmation before executing the command.
Required? | false |
Position? | named |
Default Value | false |
Accept Pipeline Input? | false |
Accept Wildcard Characters? | false |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Required? | false |
Position? | named |
Default Value | false |
Accept Pipeline Input? | false |
Accept Wildcard Characters? | false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1:
PS C:\>
