Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Creates a configuration item.
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>]
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.
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 |
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 |
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 |
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 |
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 |
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
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 |
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).
The input type is the type of the objects that you can pipe to the cmdlet.
The output type is the type of the objects that the cmdlet emits.
This command creates a configuration item for mobile devices named MD_Config88.
PS C:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"