Partilhar via


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.

Get-CMSoftwareUpdateGroup

Save-CMSoftwareUpdate

Set-CMSoftwareUpdate

Sync-CMSoftwareUpdate

Get-CMSoftwareUpdateCategoria

Get-CMSoftwareUpdateGroup

Get-CMSoftwareUpdateContentInfo