Set-CMSoftwareUpdate

  • Referência
Módulo:
ConfigurationManager

Define uma atualização de software.

Sintaxe

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 definições de configuração de uma atualização de software. Pode utilizar este 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 o Configuration Manager aplica a uma coleção de computadores.

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: Obter uma atualização de software e alterar as respetivas definições

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

Este comando obtém o objeto de atualização de software com o nome Update para o Windows 10 (KB3106932) e utiliza o operador de pipeline para transmitir 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 as definições de atualização de software

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

Este comando obtém a atualização de software com o 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.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomSeverity

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

  • Crítica
  • Importante
  • Baixo
  • Moderado
  • Nenhum
Tipo:CustomSeverityType
Valores aceitos:None, Low, Moderate, Important, Critical
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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

-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

Especifica o ID das atualizações de software.

Tipo:String
Aliases:CIId, CI_ID
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-MaximumExecutionMins

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

Tipo:Int32
Aliases:MaximumExecutionMinutes
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:LocalizedDisplayName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object