Get-CMSoftwareUpdateCategory
SYNOPSIS
Obtenha uma classificação ou produto de atualização de software.
SYNTAX
ByName (Padrão)
Get-CMSoftwareUpdateCategory [-Fast] [-Name <String>] [-TypeName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
ById
Get-CMSoftwareUpdateCategory [-Fast] -Id <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
ByUniqueId
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 recuperados durante o processo de sincronização no Gestor de Configuração com base nas definições que especifica nas propriedades do componente do ponto de atualização de software. Para obter mais informações, consulte classificações e produtos configure para sincronizar.
Para filtrar os resultados que este cmdlet devolve, utilize as propriedades CategoriaTypeName e IsSubsced. Os tipos de categorias incluem UpdateClassification, Company, ProductFamily e Product. Quando a propriedade IsSubscrita é Verdadeira, o site está configurado para sincronizar essa categoria.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Mostrar classificações subscritas
Este exemplo consulta o site para todas as classificações de atualização 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 não operador ( ! ) antes da referência à propriedade IsSubscrita. 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 do software está dessincronizado com a fonte a montante.
Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName
Count Name
----- ----
13 UpdateClassification
7 Company
59 ProductFamily
338 Product
Exemplo 3: Mostrar produtos para Office família de produtos
Este exemplo obtém primeiro a categoria de família de produtos para Office, e depois usa o seu ID de exemplo para obter todas as categorias de crianças.
$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: Obtenha todas as atualizações de software na categoria Office 365 Cliente
Este exemplo obtém primeiro a categoria de produto para Office 365 Cliente, e depois recebe 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
PARAMETERS
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- Rápido
Adicione este parâmetro para não atualizar automaticamente as propriedades preguiçosas. As propriedades preguiçosas contêm valores que são relativamente ineficientes de recuperação. Obter estas propriedades pode causar tráfego adicional de rede e diminuir o desempenho do cmdlet.
Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, desative $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifique o ID da categoria para obter.
Type: String
Parameter Sets: ById
Aliases: CategoryInstanceID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifique o nome da categoria para obter.
Type: String
Parameter Sets: ByName
Aliases: LocalizedCategoryInstanceName, CategoryName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Tipo Nome
Especifique o tipo de categoria a obter. Os valores comuns incluem os seguintes tipos:
- ActualizaçãoClassificação
- Empresa
- ProdutoAmily
- Produto
Type: String
Parameter Sets: ByName
Aliases: CategoryTypeName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-UniqueId
Especifique o ID único para a categoria obter. Este valor é o nome do tipo com um GUID para a categoria. Por exemplo, UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1
Type: String
Parameter Sets: ByUniqueId
Aliases: CategoryInstance_UniqueID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Nenhuma
OUTPUTS
IResultObject[]#SMS_UpdateCategoryInstance
IResultObject#SMS_UpdateCategoryInstance
NOTAS
Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_UpdateCategoryInstance classe WMI do servidor.