Condividi tramite

Get-CMSoftwareUpdateCategory

  • Riferimento
Modulo:
ConfigurationManager

Ottenere una classificazione o un prodotto di aggiornamento software.

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.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

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

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Fast

Aggiungere questo parametro per non aggiornare automaticamente le proprietà lazy. Le proprietà lazy contengono valori relativamente inefficienti da recuperare. Il recupero di queste proprietà può causare traffico di rete aggiuntivo e ridurre le prestazioni dei cmdlet.

Se non si usa questo parametro, il cmdlet visualizza un avviso. Per disabilitare questo avviso, impostare $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID della categoria da ottenere.

Tipo:String
Alias:CategoryInstanceID
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome della categoria da ottenere.

Tipo:String
Alias:LocalizedCategoryInstanceName, CategoryName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-TypeName

Specificare il tipo di categoria da ottenere. I valori comuni includono i tipi seguenti:

  • UpdateClassification
  • Company
  • ProductFamily
  • Prodotto
Tipo:String
Alias:CategoryTypeName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-UniqueId

Specificare l'ID univoco per la categoria da ottenere. Questo valore è il nome del tipo con un GUID per la categoria. Ad esempio, UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

Tipo:String
Alias:CategoryInstance_UniqueID
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject[]

IResultObject

Note

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