Get-CMSoftwareUpdateCategory

Syntax

Get-CMSoftwareUpdateCategory
   [-Fast]
   [-Name <String>]
   [-TypeName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdateCategory
   [-Fast]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Get-CMSoftwareUpdateCategory
   [-Fast]
   -UniqueId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Objekt für eine Softwareupdateklassifizierung oder ein Produkt abzurufen. Metadaten für Softwareupdates werden während des Synchronisierungsprozesses in Configuration Manager basierend auf den Einstellungen abgerufen, die Sie in den Eigenschaften der Softwareupdatepunktkomponente angeben. Weitere Informationen finden Sie unter Konfigurieren von Klassifizierungen und zu synchronisierenden Produkten.

Um die Ergebnisse zu filtern, die dieses Cmdlet zurückgibt, verwenden Sie die Eigenschaften CategoryTypeName und IsSubscribed . Zu den Kategorietypen gehören UpdateClassification, Company, ProductFamily und Product. Wenn die IsSubscribed-Eigenschaftauf True festgelegt ist, wird die Website so konfiguriert, dass diese Kategorie synchronisiert wird.

Beispiele

Beispiel 1: Anzeigen abonnierter Klassifizierungen

In diesem Beispiel wird die Website nach allen Softwareupdateklassifizierungen abfragt, die synchronisiert werden.

Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName

Um diesen Befehl so zu ändern, dass die Liste der Klassifizierungen zurückgegeben wird, die die Website nicht synchronisiert, fügen Sie den Not-Operator (!) vor dem Verweis auf die IsSubscribed-Eigenschaft hinzu. Beispiel: !$_.IsSubscribed

Beispiel 2: Zählen von Kategorien nach Typ

In diesem Beispiel wird zählt, wie viele Kategorien die Website für jeden Typ aufweist. Anhand dieser Anzahl können Sie ermitteln, ob der Softwareupdatepunkt nicht mit der Upstreamquelle synchronisiert ist.

Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName

Count Name
----- ----
   13 UpdateClassification
    7 Company
   59 ProductFamily
  338 Product

Beispiel 3: Anzeigen von Produkten für die Office-Produktfamilie

In diesem Beispiel wird zuerst die Produktfamilienkategorie für Office abgerufen, und dann wird die Instanz-ID verwendet, um alle untergeordneten Kategorien abzurufen.

$officeFamily = Get-CMSoftwareUpdateCategory -Fast -TypeName "ProductFamily" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office" }

Get-CMSoftwareUpdateCategory -Fast | Where-Object ParentCategoryInstanceId -eq $officeFamily.CategoryInstanceID | Select-Object LocalizedCategoryInstanceName,CategoryTypeName

LocalizedCategoryInstanceName         CategoryTypeName
-----------------------------         ----------------
Dictionary Updates for Microsoft IMEs Product
New Dictionaries for Microsoft IMEs   Product
Office 2002/XP                        Product
Office 2003                           Product
Office 2007                           Product
Office 2010                           Product
Office 2013                           Product
Office 2016                           Product
Office 365 Client                     Product
Office 2019                           Product

Beispiel 4: Abrufen aller Softwareupdates in der Office 365-Clientkategorie

In diesem Beispiel wird zuerst die Produktkategorie für Den Office 365-Client und dann alle Softwareupdates in dieser Kategorie abgerufen.

$cat = Get-CMSoftwareUpdateCategory -Fast -TypeName "Product" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office 365 Client" }

Get-CMSoftwareUpdate -Fast -Category $cat | Select-Object ArticleID,LocalizedDisplayName,IsDeployed,IsSuperseded,NumTotal,NumMissing

Parameter

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-Id

-Name

-TypeName

-UniqueId

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_UpdateCategoryInstance WMI-Serverklasse.

Ähnliche Themen

• Get-CMSoftwareUpdate