Partager via


Get-CMCategory

Obtient les catégories de configuration dans Configuration Manager.

Syntaxe

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

Description

L’applet de commande Get-CMCategory obtient les catégories de configuration dans Configuration Manager. Les catégories de configuration offrent une méthode facultative de tri et de filtrage des bases de référence de configuration et des éléments de configuration dans les rapports Configuration Manager et Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir des catégories de configuration à l’aide d’un nom

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

Cette commande obtient les catégories de pilotes de configuration dans Configuration Manager qui portent le nom NewLaptopDriverSet.

Paramètres

-CategoryType

Spécifie un type de catégorie. Les valeurs valides sont les suivantes :

  • BaselineCategories
  • DriverCategories
  • AppCategories
  • GlobalCondition
  • CatalogCategories
Type:CategoryType
Valeurs acceptées:UserCategories, BaselineCategories, DriverCategories, AppCategories, GlobalCondition, CatalogCategories
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie un tableau d’ID de catégories de configuration.

Type:String[]
Alias:CategoryInstanceUniqueid, CategoryId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un tableau de noms de catégories de configuration.

Type:String
Alias:LocalizedCategoryInstanceName, CategoryName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

None

Sorties

IResultObject[]

IResultObject