Share via

Set-CMSoftwareUpdate

  • Referência
Módulo:
ConfigurationManager

Define uma atualização de software.

Syntax

Set-CMSoftwareUpdate
   [-CustomSeverity <CustomSeverityType>]
   -Id <String>
   [-MaximumExecutionMins <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdate
   [-CustomSeverity <CustomSeverityType>]
   [-MaximumExecutionMins <Int32>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdate
   [-CustomSeverity <CustomSeverityType>]
   -InputObject <IResultObject>
   [-MaximumExecutionMins <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMSoftwareUpdate altera as configurações de configuração para uma atualização de software. Você pode usar esse cmdlet para definir a gravidade e o tempo máximo de execução de uma atualização. Uma atualização de software é uma atualização para o Windows ou outro software que Configuration Manager se aplica a uma coleção de computadores.

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: obter uma atualização de software e alterar suas configurações

PS XYZ:\> Get-CMSoftwareUpdate -Name "Update for Windows 10 (KB3106932)" | Set-CMSoftwareUpdate -MaximumExecutionMins 10 -CustomSeverity Critical

Esse comando obtém o objeto de atualização de software chamado Update for Windows 10 (KB3106932) e usa o operador de pipeline para passar o objeto para Set-CMSoftwareUpdate, que define a gravidade da atualização como Crítica e o tempo máximo de instalação para 10 minutos.

Exemplo 2: modificar configurações de atualização de software

PS XYZ:\> Set-CMSoftwareUpdate -Id 16777979 -MaximumExecutionMins 10 -CustomSeverity Critical

Esse comando obtém a atualização de software com a ID de 16777979 e define a gravidade da atualização como Crítica e o tempo máximo de instalação para 10 minutos.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-CustomSeverity

Especifica a gravidade da atualização de software. Os valores válidos são:

  • Crítica
  • Importante
  • Baixo
  • Moderado
  • Nenhum
Type:CustomSeverityType
Accepted values:None, Low, Moderate, Important, Critical
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-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

Especifica a ID das atualizações de software.

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

-InputObject

Especifica um objeto de atualização de software. Para obter um objeto de atualização de software, use o cmdlet Get-CMSoftwareUpdate .

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

-MaximumExecutionMins

Especifica, em minutos, o tempo máximo que uma atualização de software precisa para concluir a instalação em computadores cliente.

Type:Int32
Aliases:MaximumExecutionMinutes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de uma atualização de software.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object