Edit

Get-CMCategory

  • Reference
Module:
ConfigurationManager

Gets configuration categories in Configuration Manager.

Syntax

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

Description

The Get-CMCategory cmdlet gets configuration categories 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.

Examples

Example 1: Get configuration categories by using a name

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

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

Parameters

-CategoryType

Specifies a category type. Valid values are:

  • BaselineCategories
  • DriverCategories
  • AppCategories
  • GlobalCondition
  • CatalogCategories
Type:CategoryType
Accepted values:UserCategories, BaselineCategories, DriverCategories, AppCategories, GlobalCondition, CatalogCategories
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-Id

Specifies an array of IDs of configuration categories.

Type:String[]
Aliases:CategoryInstanceUniqueid, CategoryId
Position:Named
Default value:None
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Inputs

None

Outputs

IResultObject[]

IResultObject