New-CMSoftwareUpdateAutoDeploymentRule
Créez une règle de déploiement automatique (ADR) pour les mises à jour logicielles.
Syntaxe
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-Collection <IResultObject>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionId <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionName <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande New-CMSoftwareUpdateAutoDeploymentRule crée une règle de déploiement automatique (ADR) pour les mises à jour logicielles. Lorsqu’une règle s’exécute, Configuration Manager ajoute des mises à jour éligibles pour la règle à un groupe de mises à jour logicielles. Le serveur Configuration Manager télécharge les fichiers de contenu et les copie sur les points de distribution, puis met à jour les ordinateurs clients. Pour plus d’informations, consultez Déployer automatiquement des 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 : Créer une adr de base
Cette commande crée une règle de déploiement nommée DeploymentRule07 pour le regroupement nommé Desktops et le package de déploiement nommé Updates123. La règle déploie des mises à jour qui ont un ID d’article qui contient 117.
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"
Exemple 2 : Créer un adr qui utilise une planification et d’autres propriétés
Cet exemple crée une règle de déploiement automatique qui utilise une planification définie. Le déploiement se produit selon la planification.
La première commande crée une planification pour mercredi et stocke l’objet schedule dans la variable $Schedule . Pour plus d’informations, consultez New-CMSchedule.
La deuxième commande crée une règle de déploiement automatique pour les mises à jour qui utilise l’objet de planification stocké dans la variable. Cette commande spécifie des valeurs pour de nombreux paramètres.
$Schedule = New-CMSchedule -DayOfWeek Wednesday
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $True
Exemple 3 : Créer une adr pour plusieurs langues
Cet exemple crée un ADR qui ajoute les critères de langue pour trois langues : anglais, hongrois et chinois (simplifié, RPC). Il ajoute également ces langues pour les fichiers binaires de mise à jour Windows et Office 365 à télécharger. Cet exemple de règle est désactivé par défaut.
New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"
Paramètres
-AddToExistingSoftwareUpdateGroup
Indique si la règle ajoute à un groupe de mises à jour logicielles existant.
- Si cette valeur est
$True
, chaque fois que la règle s’exécute et trouve de nouvelles mises à jour, elle les ajoute à un groupe de mises à jour existant. - Si cette valeur est
$False
, elle crée un groupe de mises à jour.
Spécifiez le groupe de mises à jour existant ou attribuez un nom au nouveau groupe de mises à jour à l’aide du paramètre -DeploymentPackageName .
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 |
-AlertTime
Spécifie un décalage entier par rapport à l’échéance d’un déploiement de mise à jour. La règle utilise cette valeur pour spécifier quand la règle génère des alertes. Spécifiez une unité de temps à l’aide du paramètre -AlertTimeUnit .
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 |
-AlertTimeUnit
Spécifie une unité de temps pour le paramètre -AlertTime .
Type: | TimeUnitType |
Valeurs acceptées: | Hours, Days, Weeks, Months |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-AllowRestart
Indique s’il faut autoriser un ordinateur à redémarrer si le déploiement de la mise à jour a lieu en dehors d’une fenêtre de maintenance. Une fenêtre de maintenance est une période de temps spécifiée utilisée pour la maintenance et les mises à jour de l’ordinateur.
- Si cette valeur est
$True
, Configuration Manager redémarre l’ordinateur, si nécessaire, pour terminer la mise à jour. - Si cette valeur est
$False
, Configuration Manager ne redémarre pas l’ordinateur.
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 |
-AllowSoftwareInstallationOutsideMaintenanceWindow
Indique si le déploiement de la mise à jour a lieu même s’il est planifié en dehors d’une fenêtre de maintenance. Une fenêtre de maintenance est une période de temps spécifiée utilisée pour la maintenance et les mises à jour de l’ordinateur.
- Si cette valeur est
$True
, Configuration Manager déploie la mise à jour même si l’heure planifiée est en dehors de la fenêtre de service. - Si cette valeur est
$False
, Configuration Manager ne déploie pas la mise à jour en dehors de la fenêtre de service. Il attend qu’il puisse être déployé dans une fenêtre de service.
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 |
-AllowUseMeteredNetwork
Indique s’il faut autoriser les clients à télécharger du contenu via une connexion Internet limitée après l’échéance, ce qui peut entraîner des frais supplémentaires.
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 |
-Architecture
Utilisez ce paramètre pour définir le filtre de propriété Architecture dans la page Mises à jour logicielles des propriétés ADR.
Type: | ArchitectureType[] |
Alias: | Architectures |
Valeurs acceptées: | Arm64, Itanium, X64, X86 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ArticleId
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles dont les ID d’article répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-AvailableImmediately
Indique si cette règle déploie des mises à jour dès que les mises à jour deviennent disponibles. Si vous sélectionnez une valeur de , utilisez les paramètres -AvailableTime et -AvailableTimeUnit pour spécifier la durée après l’exécution de $False
la règle pour déployer 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 |
-AvailableTime
Spécifie une période sous forme d’entier. Configuration Manager déploie les mises à jour aussi longtemps après l’exécution de la règle. Spécifiez une unité de temps à l’aide du paramètre -AvailableTimeUnit .
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 |
-AvailableTimeUnit
Spécifie une unité de temps pour le paramètre -AvailableTime .
Type: | TimeUnitType |
Valeurs acceptées: | Hours, Days, Weeks, Months |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-BulletinId
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute les mises à jour logicielles qui ont des ID de bulletin qui répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CMTag
Cette propriété est réservée pour une utilisation ultérieure.
Type: | CMTagTypes[] |
Valeurs acceptées: | None, UUP |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Collection
Spécifiez un objet de collection comme cible pour la règle de déploiement automatique.
Type: | IResultObject |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CollectionId
Spécifiez un ID de regroupement comme cible pour la règle de déploiement automatique.
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 |
-CollectionName
Spécifiez un nom de collection comme cible pour la règle de déploiement automatique.
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 |
-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 |
-ContentSize
Utilisez ce paramètre pour définir le filtre de propriété Taille du contenu (Ko) dans la page Mises à jour logicielles des propriétés ADR.
Type: | String[] |
Alias: | ContentSizes |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-CustomSeverity
Spécifie un tableau de types de gravité personnalisés pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles qui ont des niveaux de gravité personnalisés qui répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | SeverityType[] |
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 |
-DateReleasedOrRevised
Spécifie une date de publication ou de révision pour les mises à jour logicielles. La règle ajoute au groupe de mises à jour logicielles les mises à jour logicielles dont la date répond aux critères spécifiés.
Type: | DateReleasedOrRevisedType |
Valeurs acceptées: | Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DeadlineImmediately
Indique s’il faut imposer l’échéance dès l’exécution de la règle. Si vous spécifiez la valeur , utilisez les paramètres -DeadlineTime et -DeadlineTimeUnit pour spécifier la durée après l’exécution de $False
la règle pour définir l’échéance. Après l’échéance, Configuration Manager installe les mises à jour requises.
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 |
-DeadlineTime
Spécifie une période sous forme d’entier. L’échéance des mises à jour est longue après l’exécution de la règle. Spécifiez une unité de temps à l’aide du paramètre -DeadlineTimeUnit .
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 |
-DeadlineTimeUnit
Spécifie une unité de temps pour le paramètre -DeadlineTime .
Type: | TimeUnitType |
Valeurs acceptées: | Hours, Days, Weeks, Months |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DeploymentPackage
Utilisez ce paramètre pour spécifier un objet que le package de déploiement doit utiliser avec cette règle de déploiement automatique. Pour ne pas exiger de package, définissez la valeur sur $null
.
Type: | IResultObject |
Alias: | InputObject |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DeploymentPackageName
Spécifiez le nom du package de déploiement à utiliser avec cette règle de déploiement automatique. Pour ne pas exiger de package, définissez la valeur sur $null
.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DeploymentRing
Type: | DeploymentRing |
Valeurs acceptées: | CB, Release, BusinessMainstream, Cbb, Ltsb |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DeployWithoutLicense
Indique si la règle déploie des mises à jour sans licences.
- Si vous spécifiez la valeur
$True
, Configuration Manager déploie toutes les mises à jour pour cette règle et approuve tous les contrats de licence. - Si cette valeur est
$False
, Configuration Manager déploie uniquement les mises à jour qui n’incluent pas de licence ou pour lesquelles le contrat de licence a été approuvé.
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 |
-Description
Spécifie une description de la règle de déploiement automatique pour les mises à jour logicielles.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-DisableOperationManager
Indique s’il faut désactiver les alertes System Center Operations Manager pendant les mises à jour logicielles.
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 |
-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 |
-DownloadFromInternet
Indique si les ordinateurs téléchargent des mises à jour logicielles à partir d’Internet. Si vous spécifiez la valeur $False
, spécifiez un autre emplacement où les ordinateurs peuvent télécharger les mises à jour à l’aide du paramètre -Location .
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 |
-DownloadFromMicrosoftUpdate
Indique si les ordinateurs téléchargent du contenu à partir de Microsoft Update si ce contenu n’est pas disponible sur un point de distribution préféré du point de distribution distant.
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 |
-Enable
Spécifiez si la règle de déploiement automatique est activée après sa création.
Type: | Boolean |
Alias: | Enabled, EnableDeployment |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-EnabledAfterCreate
Indique s’il faut activer le déploiement de logiciels pour le groupe de mises à jour logicielles associé après l’exécution de cette règle. Si cette valeur est $False
, déployez le groupe de mises à jour logicielles manuellement.
Type: | Boolean |
Alias: | EnableAfterCreate |
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 |
-GenerateFailureAlert
Si la règle échoue, créez une alerte Configuration Manager.
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 |
-GenerateOperationManagerAlert
Indique s’il faut générer des alertes Operations Manager pendant une mise à jour logicielle.
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 |
-GenerateSuccessAlert
Indique s’il faut générer une alerte pour un déploiement réussi.
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 |
-IsServicingPlan
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 |
-Language
Spécifiez un tableau de chaînes de critères de langage pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles dont les langues répondent aux critères spécifiés au groupe de mises à jour logicielles.
Utilisez le format de la langue tel qu’affiché dans la console. Par exemple :
English
Hungarian
Chinese (Simplified, PRC)
Le format du tableau de chaînes est le suivant : "English","Hungarian","Chinese (Simplified, PRC)"
Conseil
Si vous exécutez cette applet de commande sur un ordinateur sur lequel Windows dispose d’une interface utilisateur localisée, les noms de langue peuvent être différents. Par exemple, la version anglaise de Windows utilise « Danois », alors que la version danoise de Windows utilise « Dansk ».
Type: | String[] |
Alias: | Languages, UpdateLocales, UpdateLocale |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-LanguageSelection
Spécifiez un tableau de chaînes de langues. Les clients téléchargent les mises à jour logicielles disponibles dans les langues spécifiées et les mises à jour indépendantes de la langue.
Utilisez le format de la langue tel qu’affiché dans la console. Par exemple :
English
Hungarian
Chinese (Simplified, PRC)
Le format du tableau de chaînes est le suivant : "English","Hungarian","Chinese (Simplified, PRC)"
Conseil
Si vous exécutez cette applet de commande sur un ordinateur sur lequel Windows dispose d’une interface utilisateur localisée, les noms de langue peuvent être différents. Par exemple, la version anglaise de Windows utilise « Danois », alors que la version danoise de Windows utilise « Dansk ».
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Location
Spécifie un emplacement dans votre réseau où les ordinateurs peuvent télécharger les mises à jour logicielles. Pour utiliser cet emplacement, spécifiez la valeur pour $False
le paramètre -DownloadFromInternet .
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-MicrosoftAsVendor
Indique si la règle inclut uniquement les mises à jour dont Microsoft est le fournisseur.
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 |
-Name
Spécifie un nom pour la règle de déploiement automatique pour les mises à jour logicielles.
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 |
-NoInstallOnRemote
Indique s’il faut interdire l’installation des mises à jour sur les systèmes distants.
- Si vous spécifiez la valeur
$True
, si le client se trouve dans une limite réseau lente ou non fiable, ou lorsque le client utilise un emplacement source de secours pour le contenu, Configuration Manager n’installe pas les mises à jour logicielles. - Si vous spécifiez la valeur , l’installation
$False
se poursuit.
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 |
-NoInstallOnUnprotected
Indique s’il faut interdire l’installation des mises à jour sur des systèmes non protégés.
- Si vous spécifiez la valeur , si les
$True
mises à jour logicielles ne sont pas disponibles sur les points de distribution préférés, Configuration Manager ne télécharge pas et n’installe pas les mises à jour logicielles. - Si vous spécifiez la valeur , l’installation
$False
se poursuit.
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 |
-O365LanguageSelection
Utilisez ce paramètre pour définir la sélection de la langue de mise à jour du client Office 365 . Spécifiez un tableau de chaînes de langues. Les clients téléchargent les mises à jour logicielles disponibles dans les langues spécifiées et les mises à jour indépendantes de la langue.
Utilisez le format de la langue tel qu’affiché dans la console pour la sélection de la langue Windows Update . Ce format est identique à avec le paramètre LanguageSelection . Par exemple :
English
Hungarian
Chinese (Simplified, PRC)
Le format du tableau de chaînes est le suivant : "English","Hungarian","Chinese (Simplified, PRC)"
Conseil
Si vous exécutez cette applet de commande sur un ordinateur sur lequel Windows dispose d’une interface utilisateur localisée, les noms de langue peuvent être différents. Par exemple, la version anglaise de Windows utilise « Danois », alors que la version danoise de Windows utilise « Dansk ».
Actuellement, vous ne pouvez pas spécifier avec ce paramètre toutes les langues disponibles dans la console Configuration Manager. Par exemple, vous ne pouvez pas spécifier « Irlandais (Irlande) » ou « Maltais (Malte) ».
À compter de la version 2103, vous devez spécifier une langue avec un nom de pays/région. Cette modification aligne ce paramètre avec les options de la console Configuration Manager. Par exemple, -O365LanguageSelection "English (United States)"
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Product
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles pour les produits qui répondent aux critères spécifiés au groupe de mises à jour logicielles.
À compter de la version 2107, lorsqu’il existe plusieurs produits portant le même nom, il les sélectionne tous.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Required
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles identifiées par obligatoires qui répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-RequirePostRebootFullScan
Utilisez ce paramètre pour définir l’option suivante dans la page Expérience utilisateur des paramètres de déploiement ADR : si une mise à jour de ce déploiement nécessite un redémarrage du système, exécutez le cycle d’évaluation du déploiement des mises à jour après le redémarrage.
Type: | Boolean |
Alias: | RunEvaluationAfterRestart |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-RunType
Spécifiez la planification périodique pour le moment où le site évalue l’ADR.
Si vous spécifiez RunTheRuleOnSchedule
, spécifiez une planification à l’aide du paramètre -Schedule .
Type: | RunType |
Valeurs acceptées: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Schedule
Spécifie un objet de planification pour le déploiement. Pour obtenir un objet de planification, utilisez l’applet de commande New-CMSchedule . Spécifiez une planification pour ce paramètre si vous spécifiez une valeur de RunTheRuleOnSchedule
pour le paramètre -RunType .
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 |
-SendWakeupPacket
Indique s’il faut envoyer un paquet de mise en éveil aux ordinateurs avant le début du déploiement.
- Si cette valeur est
$True
, Configuration Manager met un ordinateur en veille. - Si cette valeur est
$False
, elle ne met pas les ordinateurs en veille.
Pour que les ordinateurs sortent, vous devez d’abord configurer Wake On LAN.
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 |
-Severity
Spécifie un tableau de niveaux de gravité pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles pour les types de gravité spécifiés au groupe de mises à jour logicielles.
Type: | SeverityType[] |
Alias: | Severities |
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 |
-SoftDeadlineEnabled
Utilisez ce paramètre pour définir l’option suivante dans la page Planification du déploiement des paramètres de déploiement ADR : Retarder l’application de ce déploiement en fonction des préférences de l’utilisateur, jusqu’à la période de grâce définie dans les paramètres du client.
Type: | Boolean |
Alias: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SuccessPercentage
Spécifie un pourcentage pour la conformité du client sous la forme d’un entier compris entre 0 et 99. Si la conformité est inférieure à ce pourcentage, Configuration Manager génère des alertes facultatives.
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 |
-Superseded
Indique si la règle ajoute des mises à jour remplacées par d’autres 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 |
-SuppressRestartServer
Indique s’il faut supprimer une mise à jour requise pour un serveur. Certaines mises à jour logicielles nécessitent un redémarrage du système pour terminer le processus 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 |
-SuppressRestartWorkstation
Indique s’il faut supprimer une mise à jour requise pour une station de travail. Certaines mises à jour logicielles nécessitent un redémarrage du système pour terminer le processus 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 |
-Title
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute les mises à jour logicielles dont les titres répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | String[] |
Alias: | Titles |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UpdateClassification
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute les mises à jour logicielles qui ont des classifications de mises à jour qui répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | String[] |
Alias: | UpdateClassifications |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UpdateDeploymentWaitDay
Type: | Int32 |
Alias: | UpdateDeploymentWaitDays |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UpdateDescription
Spécifie un tableau de critères, sous forme de chaînes, pour les mises à jour logicielles. La règle ajoute des mises à jour logicielles dont les descriptions des mises à jour répondent aux critères spécifiés au groupe de mises à jour logicielles.
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UseBranchCache
Indique s’il faut utiliser Windows BranchCache pour ce déploiement de mise à jour. Si vous spécifiez la valeur , les clients partagent du $True
contenu sur le même sous-réseau.
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 |
-UserNotification
Spécifie le type de notification utilisateur.
-
DisplayAll
: afficher dans le Centre logiciel et afficher toutes les notifications. -
DisplaySoftwareCenterOnly
: afficher dans le Centre logiciel et afficher uniquement les notifications de redémarrage de l’ordinateur. -
HideAll
: Masquer dans le Centre logiciel et toutes les notifications.
Type: | UserNotificationType |
Valeurs acceptées: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-UseUtc
Indique s’il faut utiliser le temps universel coordonné (UTC).
- Si cette valeur est
$True
, Configuration Manager utilise l’utc pour ce déploiement. - Si cette valeur est
$False
, Configuration Manager utilise l’heure locale.
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 |
-Vendor
Type: | String[] |
Alias: | Vendors |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-VerboseLevel
Spécifie le niveau de détail que vous souhaitez que les clients signalent pour les déploiements créés par cette règle.
Type: | VerboseLevelType |
Valeurs acceptées: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
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 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 |
-WriteFilterHandling
Indique s’il faut activer les filtres d’écriture pour les appareils incorporés.
- Pour une valeur de
$True
, l’appareil valide les modifications pendant une fenêtre de maintenance. Cette action nécessite un redémarrage. - Pour une valeur de , l’appareil
$False
enregistre les modifications dans une superposition et les valide ultérieurement.
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 |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_AutoDeployment classe WMI du serveur.