Get-CMCategory

Gets configuration categories in Configuration Manager.

Syntax

Get-CMCategory
   [-Name <String>]
   [-CategoryType <CategoryType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCategory
   -Id <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMCategory cmdlet gets configuration categories in Microsoft System Center Configuration Manager. Configuration categories offer an optional method of sorting and filtering configuration baselines and configuration items in System Center Configuration Manager and Configuration Manager reports.

Examples

Example 1: Get configuration categories by using a name

PS C:\> Get-CMCategory -CategoryType "DriverCategories" -Name "NewLaptopDriverSet"

This command gets configuration driver categories in Configuration Manager that have the name NewLaptopDriverSet.

Required Parameters

-Id

Specifies an array of IDs of configuration categories.

Type:String[]
Aliases:CategoryInstanceUniqueid, CategoryId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-CategoryType

Specifies a category type. Valid values are:

  • BaselineCategories
  • DriverCategories
  • AppCategories
  • GlobalCondition
  • CatalogCategories
Type:CategoryType
Parameter Sets:UserCategories, BaselineCategories, DriverCategories, AppCategories, GlobalCondition, CatalogCategories
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies an array of names of configuration categories.

Type:String
Aliases:LocalizedCategoryInstanceName, CategoryName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False