New-CMConfigurationItem
New-CMConfigurationItem
Creates a configuration item.
Syntax
Parameter Set: New
New-CMConfigurationItem -CreationType <CICreationType> {MacOS | MobileDevice | None | WindowsApplication | WindowsOS} -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 SP1 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 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. The acceptable values for this parameter 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 running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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: Create a configuration item
This command creates a configuration item for mobile devices named MD_Config88.
PS C:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"