Get-CMSoftwareUpdateCategory

Syntaxe

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

Description

Utilisez cette applet de commande pour obtenir un objet pour une classification ou un produit de mise à jour logicielle. Les métadonnées des mises à jour logicielles sont récupérées pendant le processus de synchronisation dans Configuration Manager en fonction des paramètres que vous spécifiez dans les propriétés du composant du point de mise à jour logicielle. Pour plus d’informations, consultez Configurer des classifications et des produits à synchroniser.

Pour filtrer les résultats retournés par cette applet de commande, utilisez les propriétés CategoryTypeName et IsSubscribed . Les types de catégorie incluent UpdateClassification, Company, ProductFamily et Product. Lorsque la propriété IsSubscribed a la valeur True, le site est configuré pour synchroniser cette catégorie.

Exemples

Exemple 1 : Afficher les classifications abonnées

Cet exemple interroge le site pour toutes les classifications de mises à jour logicielles qu’il synchronise.

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

Pour modifier cette commande afin de renvoyer la liste des classifications que le site ne synchronise pas, ajoutez l’opérateur not (!) avant la référence à la propriété IsSubscribed . Par exemple, !$_.IsSubscribed

Exemple 2 : Compter les catégories par type

Cet exemple compte le nombre de catégories du site pour chaque type. Ce nombre peut vous aider à déterminer si le point de mise à jour logicielle n’est pas synchronisé avec la source en amont.

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

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

Exemple 3 : Afficher les produits pour la famille de produits Office

Cet exemple obtient d’abord la catégorie de famille de produits pour Office, puis utilise son ID d’instance pour obtenir toutes les catégories enfants.

$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

Exemple 4 : Obtenir toutes les mises à jour logicielles dans la catégorie Client Office 365

Cet exemple obtient d’abord la catégorie de produit pour le client Office 365, puis obtient toutes les mises à jour logicielles de cette catégorie.

$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

Paramètres

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-Id

-Name

-TypeName

-UniqueId

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_UpdateCategoryInstance classe WMI du serveur.

Liens associés

• Get-CMSoftwareUpdate