Get-CMCategory

Ruft Konfigurationskategorien in Configuration Manager ab.

Syntax

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

Beschreibung

Das Cmdlet Get-CMCategory ruft Konfigurationskategorien in Configuration Manager ab. Konfigurationskategorien bieten eine optionale Methode zum Sortieren und Filtern von Konfigurationsbaselines und Konfigurationselementen in Configuration Manager- und Configuration Manager-Berichten.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen von Konfigurationskategorien mithilfe eines Namens

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

Dieser Befehl ruft Konfigurationstreiberkategorien in Configuration Manager ab, die den Namen NewLaptopDriverSet haben.

Parameter

-CategoryType

Gibt einen Kategorietyp an. Gültige Werte sind:

  • BaselineCategories
  • DriverCategories
  • App-Kategorien
  • GlobalCondition
  • CatalogCategories
Typ:CategoryType
Zulässige Werte:UserCategories, BaselineCategories, DriverCategories, AppCategories, GlobalCondition, CatalogCategories
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt ein Array von IDs von Konfigurationskategorien an.

Typ:String[]
Aliase:CategoryInstanceUniqueid, CategoryId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt ein Array von Namen von Konfigurationskategorien an.

Typ:String
Aliase:LocalizedCategoryInstanceName, CategoryName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

None

Ausgaben

IResultObject[]

IResultObject