Partager via

Set-CMClientSettingSoftwareUpdate

  • Référence
Module:
ConfigurationManager

Configurez les paramètres du client pour les mises à jour logicielles.

Syntaxe

Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   [-DefaultSetting]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour configurer les paramètres dans le groupe Mises à jour logicielles des paramètres client. Pour plus d’informations, consultez À propos des paramètres client : Mises à jour logicielles.

Remarque

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 : Activer les mises à jour tierces dans les paramètres client par défaut

Set-CMClientSettingSoftwareUpdate -DefaultSetting -Enable $true -EnableThirdPartyUpdates $true

Exemple 2 : Activer les mises à jour tierces dans un paramètre d’appareil personnalisé

$clientDeviceSettingName = "Dev device settings"
Set-CMClientSettingSoftwareUpdate -Name $clientDeviceSettingName -Enable $true -EnableThirdPartyUpdates $true

Exemple 3 : Configurer plusieurs paramètres

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Paramètres

-BatchingTimeout

Spécifiez la période pendant laquelle tous les déploiements en attente avec une échéance dans ce délai seront également installés. Utilisez ce paramètre avec le paramètre EnforceMandatory . Vous pouvez entrer une valeur comprise entre 1 et 23 heures et entre 1 et 365 jours. Par défaut, ce paramètre est configuré pendant sept jours. Utilisez le paramètre TimeUnit pour spécifier des heures ou des jours.

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

-Confirm

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

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

-DefaultSetting

Ajoutez ce paramètre pour configurer les paramètres de mise à jour logicielle dans les paramètres client par défaut.

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

-DeltaDownloadPort

Utilisez ce paramètre pour configurer le port réseau que les clients utilisent pour recevoir des demandes de contenu delta. Utilisez le paramètre EnableDeltaDownload pour activer le comportement. La valeur par défaut est 8005.

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

-DeploymentEvaluationSchedule

Spécifiez la fréquence à laquelle l’agent client des mises à jour logicielles réévalue les mises à jour logicielles pour l’état d’installation sur les ordinateurs clients Configuration Manager. Pour créer un jeton de planification, utilisez l’applet de commande New-CMSchedule .

Type:IResultObject
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

-Enable

Définissez ce paramètre sur $true pour activer les mises à jour logicielles sur les clients.

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

-EnableDeltaDownload

Définissez ce paramètre sur $true pour permettre aux clients de télécharger le contenu delta lorsqu’il est disponible. Pour configurer le port réseau, utilisez le paramètre DeltaDownloadPort .

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

-EnableDynamicUpdate

S’applique à la version 2010 et ultérieure. Définissez ce paramètre sur $true pour activer la mise à jour dynamique pour les mises à jour des fonctionnalités Windows 10. La mise à jour dynamique installe les modules linguistiques, les fonctionnalités à la demande, les pilotes et les mises à jour cumulatives pendant l’installation de Windows. Il indique au client de télécharger ces mises à jour à partir d’Internet.

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

-EnableInstallation

S’applique à la version 2010 et ultérieure. Définissez ce paramètre sur $true pour activer l’installation des mises à jour logicielles dans la fenêtre de maintenance « Tous les déploiements » lorsque la fenêtre de maintenance « Mise à jour logicielle » est disponible.

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

-EnableThirdPartyUpdates

Définissez ce paramètre sur $true pour activer les mises à jour logicielles tierces.

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

-EnableWsusCertPinning

S’applique à la version 2107 et aux versions ultérieures. Définissez ce paramètre sur $true pour appliquer l’épinglage de certificat TLS pour le client Windows Update afin de détecter les mises à jour.

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

-EnforceMandatory

Lorsque l’échéance de déploiement des mises à jour logicielles est atteinte, installez tous les autres déploiements de mises à jour logicielles dont l’échéance arrive dans une période spécifiée. Utilisez le paramètre BatchingTimeout pour spécifier la période.

Type:Boolean
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

-InputObject

Cette applet de commande ajoute les paramètres de mise à jour logicielle à l’objet de paramètres client que vous spécifiez avec ce paramètre. Pour obtenir cet objet, utilisez l’applet de commande Get-CMClientSetting .

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

-Name

Cette applet de commande ajoute les paramètres de mise à jour logicielle à l’objet de paramètres client que ce paramètre nomme.

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

-Office365ManagementType

Définissez ce paramètre sur $true pour activer la gestion de l’agent client Microsoft 365 Apps et des paramètres d’installation.

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

-PassThru

Renvoie un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-ScanSchedule

Spécifiez la fréquence à laquelle l’agent client des mises à jour logicielles démarre une analyse d’évaluation de la conformité. Cette analyse détermine l’état des mises à jour logicielles sur le client. Pour créer un jeton de planification, utilisez l’applet de commande New-CMSchedule .

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

-ThreadPriority

S’applique à la version 2010 et ultérieure. Spécifiez une priorité de thread pour les mises à jour des fonctionnalités Windows 10.

  • Normal: le programme d’installation de Windows utilise plus de ressources système et de mises à jour plus rapidement. Il utilise plus de temps processeur, donc le temps d’installation total est plus court, mais la panne de l’utilisateur est plus longue. Cette valeur est la valeur par défaut.

  • Low: vous pouvez continuer à travailler sur l’appareil pendant qu’il télécharge et met à jour en arrière-plan. Le temps d’installation total est plus long, mais la panne de l’utilisateur est plus courte. Vous devrez peut-être augmenter le temps d’exécution maximal de la mise à jour pour éviter un délai d’attente lorsque vous utilisez cette option.

Type:ThreadPriorityType
Valeurs acceptées:Normal, Low
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeUnit

Utilisez avec le paramètre BatchingTimeout pour spécifier la période pendant laquelle tous les déploiements en attente avec une échéance dans ce délai seront également installés.

Type:BatchingTimeoutType
Valeurs acceptées:Days, Hours
Position:Named
Valeur par défaut:None
Obligatoire:False
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 n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
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