Get-CMSoftwareUpdateCategory

  • Referenz
Modul:
ConfigurationManager

Abrufen einer Softwareupdateklassifizierung oder eines Produkts.

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.

Hinweis

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

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 Office 365 Clientkategorie

In diesem Beispiel wird zuerst die Produktkategorie für 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

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

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

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true.

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

-ForceWildcardHandling

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

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

-Id

Geben Sie die ID der abzurufenden Kategorie an.

Type:String
Aliases:CategoryInstanceID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Geben Sie den Namen der abzurufenden Kategorie an.

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

-TypeName

Geben Sie den Typ der abzurufenden Kategorie an. Zu den allgemeinen Werten gehören die folgenden Typen:

  • UpdateClassification
  • Unternehmen
  • Produktfamilie
  • Produkt
Type:String
Aliases:CategoryTypeName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-UniqueId

Geben Sie die eindeutige ID für die abzurufende Kategorie an. Dieser Wert ist der Typname mit einer GUID für die Kategorie. Beispiel: UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

Type:String
Aliases:CategoryInstance_UniqueID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

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