Freigeben über

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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 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

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

-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.

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

Geben Sie die ID der abzurufenden Kategorie an.

Typ:String
Aliase:CategoryInstanceID
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der abzurufenden Kategorie an.

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

-TypeName

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

  • UpdateClassification
  • Unternehmen
  • Produktfamilie
  • Produkt
Typ:String
Aliase:CategoryTypeName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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

Typ:String
Aliase:CategoryInstance_UniqueID
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

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