Get-CMSoftwareUpdateCategory

Sintaxe

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

Utilize este cmdlet para obter um objeto para uma classificação ou produto de atualização de software. Os metadados de atualizações de software são obtidos durante o processo de sincronização no Configuration Manager com base nas definições que especificar nas propriedades do componente do ponto de atualização de software. Para obter mais informações, veja Configurar classificações e produtos para sincronizar.

Para filtrar os resultados devolvidos por este cmdlet, utilize as propriedades CategoryTypeName e IsSubscribed . Os tipos de categoria incluem UpdateClassification, Company, ProductFamily e Product. Quando a propriedade IsSubscribed é True, o site é configurado para sincronizar essa categoria.

Exemplos

Exemplo 1: Mostrar classificações subscritas

Este exemplo consulta o site relativamente a todas as classificações de atualizações de software que está a sincronizar.

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

Para alterar este comando para devolver a lista de classificações que o site não está a sincronizar, adicione o operador não (!) antes da referência à propriedade IsSubscribed . Por exemplo, !$_.IsSubscribed

Exemplo 2: Contar categorias por tipo

Este exemplo conta quantas categorias o site tem para cada tipo. Esta contagem pode ajudá-lo a determinar se o ponto de atualização de software está dessincronizado com a origem a montante.

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

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

Exemplo 3: Mostrar produtos para a família de produtos do Office

Este exemplo obtém primeiro a categoria da família de produtos para o Office e, em seguida, utiliza o ID de instância para obter todas as categorias subordinadas.

$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

Exemplo 4: Obter todas as atualizações de software na categoria cliente do Office 365

Este exemplo obtém primeiro a categoria de produto do Cliente do Office 365 e, em seguida, obtém todas as atualizações de software nessa 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

Parâmetros

-DisableWildcardHandling

-Fast

-ForceWildcardHandling

-Id

-Name

-TypeName

-UniqueId

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_UpdateCategoryInstance classe WMI de servidor.

Links Relacionados

• Get-CMSoftwareUpdate