Get-CMSoftwareUpdate
SYNOPSIS
Obtenha uma atualização de software.
SYNTAX
SearchByName (Padrão)
Get-CMSoftwareUpdate [-ArticleId <String>] [-BulletinId <String>] [-Category <IResultObject[]>]
[-CategoryName <String[]>] [-DatePostedMax <DateTime>] [-DatePostedMin <DateTime>]
[-DateRevisedMax <DateTime>] [-DateRevisedMin <DateTime>] [-EulaExist <Boolean>] [-Fast] [-IncludeUpgrade]
[-IsContentProvisioned <Boolean>] [-IsDeployed <Boolean>] [-IsExpired <Boolean>] [-IsLatest <Boolean>]
[-IsOfflineServiceable <Boolean>] [-IsSuperseded <Boolean>] [-IsUserDefined <Boolean>] [-Name <String>]
[-OnlyExpired] [-Severity <CustomSeverityType>] [-Vendor <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
SearchById
Get-CMSoftwareUpdate [-Fast] -Id <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroup
Get-CMSoftwareUpdate [-Fast] -UpdateGroup <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroupIdMandatory
Get-CMSoftwareUpdate [-Fast] -UpdateGroupId <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByUpdateGroupNameMandatory
Get-CMSoftwareUpdate [-Fast] -UpdateGroupName <String[]> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
Utilize este cmdlet para obter uma ou mais atualizações de software.
Para obter mais informações, consulte a documentação de gestão da atualização de Software nos docs principais.
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: Receba atualizações de software descarregadas
Este comando recebe todas as atualizações de software que o site descarregou.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Exemplo 2: Obtenha atualizações de software por grupo de atualização
Este comando obtém primeiro o objeto do grupo de atualização de software chamado TestSUgroup10. Em seguida, utiliza o operador do gasoduto para passar o objeto para Get-CMSoftwareUpdate. O resultado é a lista de todas as atualizações de software para o grupo de atualização de software.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate
PARAMETERS
-Artigos
Especifique o ID do artigo de uma atualização de software. Por exemplo, 4571687.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-BoletimId
Especifique o ID do Boletim de uma atualização de software. Por exemplo, MS18-952.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Categoria
Especifique a categoria de uma atualização de software. Para obter um objeto de categoria, utilize o cmdlet Get-CMSoftwareUpdateCategory.
Type: IResultObject[]
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Categoria Nome
Especifique um conjunto de nomes de categorias para atualizações de software.
Type: String[]
Parameter Sets: SearchByName
Aliases: CategoryNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DataPostedMax
Especifique a data mais recente de que uma atualização de software foi lançada.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DataPostedMin
Especifique a data mais cedo em que foi lançada uma atualização de software.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DataRevisedMax
Especifique a data mais recente de que uma atualização de software foi revista.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DataRevisedMin
Especifique a data mais cedo de que uma atualização de software foi revista.
Type: DateTime
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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
-EulaExist
Desave este parâmetro $true para filtrar os resultados de todas as atualizações que tenham um contrato de licença.
Type: Boolean
Parameter Sets: SearchByName
Aliases: EulaExists
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
Especifica o ID de uma atualização de software. Este valor é o CI_ID, por 143404 exemplo.
Type: Int32
Parameter Sets: SearchById
Aliases: CIId, CI_ID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncluirUprado
Adicione este parâmetro para incluir atualizações de software na categoria de upgrade.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases: IncludeUpgrades
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsContentProvisioned
Desfihe este parâmetro $true para filtrar os resultados de todas as atualizações para as quais o site descarregou conteúdo.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsDeployed
Desloque este parâmetro $true para filtrar os resultados de todas as atualizações que forem implementadas.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsExpired
Desave este parâmetro $true para filtrar os resultados de todas as atualizações que estão caducadas.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsLatest
Desave este parâmetro $true para filtrar os resultados para a versão mais recente da atualização do software.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsOfflineServiceable
Desave este parâmetro $true para filtrar os resultados de todas as atualizações que sejam desativáveis. Pode utilizar a ferramenta da linha de comando DISM para injetar estas atualizações numa imagem de SO.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- Supersed
Deslove este parâmetro $true para filtrar os resultados de todas as atualizações que são substituídos.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IsUserDefined
Desave este parâmetro $true para filtrar os resultados de todas as atualizações definidas pelo utilizador.
Type: Boolean
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifique o nome de uma atualização de software. Este parâmetro compara-se com o atributo do nome de exibição localizado.
Pode utilizar caracteres wildcard:
*: Vários caracteres?: Personagem única
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-OnlyExpired
Adicione este parâmetro apenas para procurar atualizações de software expiradas.
Type: SwitchParameter
Parameter Sets: SearchByName
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Severidade
Especifique a gravidade da atualização do software.
Type: CustomSeverityType
Parameter Sets: SearchByName
Aliases:
Accepted values: None, Low, Moderate, Important, Critical
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroup
Especifique o objeto do grupo de atualização de software. Para obter este objeto, utilize o cmdlet Get-CMSoftwareUpdateGroup.
Type: IResultObject
Parameter Sets: SearchByUpdateGroup
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-UpdateGroupId
Especifique uma série de IDs de grupos de atualização de software. Este valor é o ID CI_ID ou Config Item do grupo de atualização de software. Por exemplo, 107078.
Type: String[]
Parameter Sets: SearchByUpdateGroupIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateGroupName
Especifique uma série de nomes de grupos de atualização de software.
Type: String[]
Parameter Sets: SearchByUpdateGroupNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fornecedor
Aplica-se à versão 2010 e mais tarde. Especifique o nome do fornecedor de atualização de software. O fornecedor para a maioria das atualizações de software é "Microsoft" . Se configurar atualizações de software de terceiros, utilize este valor para filtrar outros fornecedores de atualização.
Type: String
Parameter Sets: SearchByName
Aliases:
Required: False
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
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_SoftwareUpdate
IResultObject#SMS_SoftwareUpdate
NOTAS
Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_SoftwareUpdate classe WMI do servidor.