Get-CMSoftwareUpdateCategory

Sintassi

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

Descrizione

Usare questo cmdlet per ottenere un oggetto per una classificazione o un prodotto di aggiornamento software. I metadati degli aggiornamenti software vengono recuperati durante il processo di sincronizzazione in Configuration Manager in base alle impostazioni specificate nelle proprietà del componente del punto di aggiornamento software. Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

Per filtrare i risultati restituiti da questo cmdlet, usare le proprietà CategoryTypeName e IsSubscribed . I tipi di categoria includono UpdateClassification, Company, ProductFamily e Product. Quando la proprietà IsSubscribed è Impostata su True, il sito è configurato per sincronizzare tale categoria.

Esempio

Esempio 1: Mostra classificazioni sottoscritte

In questo esempio viene eseguita una query sul sito per tutte le classificazioni degli aggiornamenti software sincronizzate.

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

Per modificare questo comando per restituire l'elenco di classificazioni che il sito non esegue la sincronizzazione, aggiungere l'operatore not (!) prima del riferimento alla proprietà IsSubscribed . Ad esempio, !$_.IsSubscribed

Esempio 2: Contare le categorie per tipo

In questo esempio viene conteggiato il numero di categorie del sito per ogni tipo. Questo conteggio consente di determinare se il punto di aggiornamento software non è sincronizzato con l'origine upstream.

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

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

Esempio 3: Visualizzare i prodotti per la famiglia di prodotti Office

Questo esempio ottiene prima la categoria della famiglia di prodotti per Office e quindi usa il relativo ID istanza per ottenere tutte le categorie figlio.

$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

Esempio 4: Ottenere tutti gli aggiornamenti software nella categoria Client di Office 365

In questo esempio viene prima ottenuta la categoria di prodotto per Office 365 Client e quindi vengono ottenuti tutti gli aggiornamenti software in tale categoria.

$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

Parametri

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-Id

-Name

-TypeName

-UniqueId

Input

None

Output

IResultObject[]

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_UpdateCategoryInstance classe WMI del server.

Collegamenti correlati

• Get-CMSoftwareUpdate