Set-CMAutoDeploymentRuleDeployment
Définit un déploiement pour une règle de déploiement automatique.
Syntaxe
Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Set-CMAutoDeploymentRuleDeployment met à jour un déploiement pour une règle de déploiement automatique.
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 : Définir un déploiement par ID
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $FalseCette commande met à jour les paramètres du déploiement de la règle de déploiement avec l’ID d’action 348 et le regroupement nommé Tous les systèmes.
Exemple 2 : Définir un déploiement à l’aide d’une variable
PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $FalseLa première commande obtient l’objet de règle de déploiement automatique nommé TestADR01 et stocke l’objet dans la variable $ReferenceADR.
La deuxième commande obtient les déploiements associés à l’objet de règle de déploiement automatique stocké dans $ReferenceADR et stocke les déploiements dans la variable $Deployment.
La dernière commande met à jour les paramètres du premier déploiement stocké dans $Deployment.
Paramètres
-AlertTime
Spécifie le nombre d’unités de temps pour le décalage par rapport à l’échéance.
| 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 le type d’unité de temps pour le décalage par rapport à l’échéance. Les valeurs valides sont les suivantes :
- Heures
- Jours
- Semaines
- Mois
| 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 |
-AllowDownloadFromMicrosoftUpdate
Utilisez ce paramètre pour définir l’option suivante dans la page Télécharger les paramètres des paramètres de déploiement ADR : Si les mises à jour logicielles ne sont pas disponibles sur le point de distribution dans les groupes de limites actuels, voisins ou de site, téléchargez le contenu à partir de Microsoft Updates.
| 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 |
-AllowRestart
Indique si un redémarrage du système est autorisé à être effectué en dehors des fenêtres de maintenance définies lorsque l’échéance d’installation est atteinte.
| 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 l’installation du logiciel est autorisée en dehors des fenêtres de maintenance définies lorsque l’échéance d’installation est atteinte.
| 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
Utilisez ce paramètre pour définir l’option suivante dans la page Paramètres de téléchargement des paramètres de déploiement ADR : Autoriser les clients sur une connexion Internet limitée à télécharger du contenu après l’échéance de l’installation, ce qui peut entraîner des coûts 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 |
-AvailableImmediately
Indique si les mises à jour logicielles peuvent être installées dès que possible après l’exécution de la règle.
| 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 le nombre d’unités de temps pour le temps disponible du logiciel.
| 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 le type d’unité de temps pour l’heure disponible du logiciel. Les valeurs valides sont les suivantes :
- Heures
- Jours
- Semaines
- Mois
| 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 |
-Collection
Spécifie un objet de collection cible pour le déploiement des mises à jour logicielles. Pour obtenir un objet de collection, utilisez l’applet de commande Get-CMCollection .
| 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 |
-CollectionId
Spécifie l’ID du regroupement cible pour le déploiement des 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 |
-CollectionName
Spécifie le nom du regroupement cible pour le déploiement des 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 |
-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 |
-DeadlineImmediately
Indique si les mises à jour logicielles requises sont installées dès que possible lorsque l’échéance est atteinte.
| 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 le nombre d’unités de temps pour l’échéance.
| 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 le type d’unité de temps pour l’échéance. Les valeurs valides sont les suivantes :
- Heures
- Jours
- Semaines
- Mois
| 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 |
-DisableOperationsManager
Indique si les alertes Operations Manager sont désactivées pendant l’exécution des mises à jour logicielles.
| Type: | Boolean |
| Alias: | DisableOperationManager |
| 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 |
-EnableDeployment
Indique s’il faut activer le déploiement après l’exécution de cette règle pour le groupe de logiciels associé. Si la valeur est $False, vous devez déployer manuellement le groupe de mises à jour logicielles.
| Type: | Boolean |
| Alias: | Enable, EnabledAfterCreate, 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 |
-GenerateOperationsManagerAlert
Indique si des alertes Operations Manager sont générées en cas d’échec de l’installation d’une mise à jour logicielle.
| Type: | Boolean |
| Alias: | GenerateOperationManagerAlert |
| 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 si une alerte est générée lorsque cette règle s’exécute correctement.
| 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 |
-Id
Spécifie l’ID d’action du déploiement de la règle de déploiement automatique.
| Type: | Int32 |
| Alias: | ActionID |
| Position: | 0 |
| 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 règle de déploiement automatique. Pour obtenir un objet de règle de déploiement automatique, utilisez l’applet de commande Get-CMSoftwareUpdateAutoDeploymentRule .
| Type: | IResultObject |
| Alias: | AutoDeploymentRuleDeployment |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-NoInstallOnRemote
Indique s’il faut installer des mises à jour logicielles lorsque les mises à jour ne sont pas disponibles sur les points de distribution distants.
| 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 installer des mises à jour logicielles lorsque les mises à jour ne sont pas disponibles sur les points de distribution non protégés.
| 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
Ajoutez ce paramètre pour renvoyer un objet qui représente 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 |
-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 |
-SendWakeupPacket
Indique s’il faut utiliser Wake-on-LAN pour réveiller les clients pour les déploiements requis.
| Type: | Boolean |
| Alias: | EnableWakeOnLan |
| 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 le pourcentage, sous forme d’entier, de conformité du client. Lorsque la conformité du client est inférieure à ce pourcentage, une alerte est générée.
| 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 |
-SuppressRestartServer
Indique si un redémarrage du système est supprimé sur les serveurs lorsqu’une mise à jour logicielle nécessite 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 si un redémarrage du système est supprimé sur les stations de travail lorsqu’une mise à jour logicielle nécessite 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 |
-UseBranchCache
Indique si les clients sont autorisés à partager du contenu avec d’autres clients 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 comportement de notification de l’expérience visuelle utilisateur. Les valeurs valides sont les suivantes :
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
| Type: | UserNotificationOption |
| 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 si la planification de ce déploiement est évaluée en fonction du temps universel coordonné (UTC).
| 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 |
-VerboseLevel
Spécifie la quantité de détails d’état que les clients rapportent pour les déploiements créés par cette règle. Les valeurs valides sont les suivantes :
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
- AllMessages
| 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 si les modifications sont validées à l’échéance ou pendant une fenêtre de maintenance (nécessite des redémarrages). S’il est défini sur $False, le contenu est appliqué sur la superposition et validée 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