Get-CMSoftwareUpdateCategory
Obtenha uma classificação ou produto de atualização de software.
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.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, veja Introdução.
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
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Fast
Adicione este parâmetro para não atualizar automaticamente as propriedades em diferido. As propriedades em diferido contêm valores relativamente ineficientes a obter. Obter estas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.
Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, defina $CMPSSuppressFastNotUsedCheck = $true
.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Id
Especifique o ID da categoria a obter.
Tipo: | String |
Aliases: | CategoryInstanceID |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifique o nome da categoria a obter.
Tipo: | String |
Aliases: | LocalizedCategoryInstanceName, CategoryName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-TypeName
Especifique o tipo de categoria a obter. Os valores comuns incluem os seguintes tipos:
- UpdateClassification
- Empresa
- ProductFamily
- Produto
Tipo: | String |
Aliases: | CategoryTypeName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | True |
-UniqueId
Especifique o ID exclusivo da categoria a obter. Este valor é o nome do tipo com um GUID para a categoria. Por exemplo, UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1
Tipo: | String |
Aliases: | CategoryInstance_UniqueID |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
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.