Share via

Get-CMSoftwareUpdateCategory

  • Referência
Módulo:
ConfigurationManager

Obtenha uma classificação ou produto de atualização de software.

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

Description

Use 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 recuperados durante o processo de sincronização em Configuration Manager com base nas configurações especificadas nas propriedades do componente do ponto de atualização de software. Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

Para filtrar os resultados que esse cmdlet retorna, use 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.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Mostrar classificações inscritas

Este exemplo consulta o site para todas as classificações de atualização de software que ele está sincronizando.

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

Para alterar esse comando para retornar a lista de classificações que o site não está sincronizando, adicione o não operador (!) 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. Essa contagem pode ajudá-lo a determinar se o ponto de atualização de software está fora de sincronização com a fonte upstream.

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 primeiro obtém a categoria família de produtos do Office e, em seguida, usa sua ID de instância para obter todas as categorias filho.

$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 Office 365

Este exemplo primeiro obtém a categoria de produto para Office 365 Cliente 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

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Fast

Adicione esse parâmetro para não atualizar automaticamente propriedades preguiçosas. Propriedades preguiçosas contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifique a ID da categoria a ser obtida.

Type:String
Aliases:CategoryInstanceID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifique o nome da categoria a ser obtida.

Type:String
Aliases:LocalizedCategoryInstanceName, CategoryName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-TypeName

Especifique o tipo de categoria a ser obtida. Os valores comuns incluem os seguintes tipos:

  • UpdateClassification
  • Empresa
  • ProductFamily
  • Produto
Type:String
Aliases:CategoryTypeName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-UniqueId

Especifique a ID exclusiva para a categoria a ser obtida. Esse valor é o nome do tipo com um GUID para a categoria. Por exemplo, UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

Type:String
Aliases:CategoryInstance_UniqueID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_UpdateCategoryInstance classe WMI do servidor.