Lire en anglais

Partager via

Set-CMSoftwareUpdate

  • Référence
Module:
ConfigurationManager

Définit une mise à jour logicielle.

Syntaxe

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

Description

L’applet de commande Set-CMSoftwareUpdate modifie les paramètres de configuration d’une mise à jour logicielle. Vous pouvez utiliser cette applet de commande pour définir la gravité et la durée d’exécution maximale d’une mise à jour. Une mise à jour logicielle est une mise à jour de Windows ou d’autres logiciels que Configuration Manager applique à un ensemble d’ordinateurs.

Notes

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir une mise à jour logicielle et modifier ses paramètres

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

Cette commande obtient l’objet de mise à jour logicielle nommé Update pour Windows 10 (KB3106932) et utilise l’opérateur de pipeline pour passer l’objet à Set-CMSoftwareUpdate, qui définit la gravité de la mise à jour sur Critique et la durée d’installation maximale sur 10 minutes.

Exemple 2 : Modifier les paramètres de mise à jour logicielle

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

Cette commande obtient la mise à jour logicielle avec l’ID de 16777979 et définit la gravité de la mise à jour sur Critique et la durée d’installation maximale sur 10 minutes.

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CustomSeverity

Spécifie la gravité de la mise à jour logicielle. Les valeurs valides sont les suivantes :

  • Critique
  • Importante
  • Faible
  • Modéré
  • Aucune
Type:CustomSeverityType
Valeurs acceptées:None, Low, Moderate, Important, Critical
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie l’ID des mises à jour logicielles.

Type:String
Alias:CIId, CI_ID
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un objet de mise à jour logicielle. Pour obtenir un objet de mise à jour logicielle, utilisez l’applet de commande Get-CMSoftwareUpdate .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-MaximumExecutionMins

Spécifie, en minutes, la durée maximale nécessaire à l’installation d’une mise à jour logicielle sur les ordinateurs clients.

Type:Int32
Alias:MaximumExecutionMinutes
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’une mise à jour logicielle.

Type:String
Alias:LocalizedDisplayName
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object