description | external help file | Module Name | ms.date | schema | title |
---|---|---|---|---|---|
Creates a configuration category in Configuration Manager. |
AdminUI.PS.dll-Help.xml |
ConfigurationManager |
05/05/2019 |
2.0.0 |
New-CMCategory |
Creates a configuration category in Configuration Manager.
New-CMCategory -CategoryType <CategoryType> -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
The New-CMCategory cmdlet creates a configuration category in Configuration Manager. Configuration categories offer an optional method of sorting and filtering configuration baselines and configuration items in Configuration Manager and Configuration Manager reports.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
PS XYZ:\> New-CMCategory -CategoryType "DriverCategories" -Name "NewLaptopDriverSet"
This command creates a new category in DriverCategories named NewLaptopDriverSet.
Specifies a category type. Valid values are:
- BaselineCategories
- DriverCategories
- AppCategories
- GlobalCondition
- CatalogCategories
Type: CategoryType
Parameter Sets: (All)
Aliases:
Accepted values: AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies a name for the configuration category.
Type: String
Parameter Sets: (All)
Aliases: LocalizedCategoryInstanceName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
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 doesn't run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.