New-CMAutoDeploymentRuleDeployment

Référence

Module:: ConfigurationManager

Créez un déploiement pour une règle de déploiement automatique.

Syntaxe

New-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>]
   [-Name] <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-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>]

New-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>]
   [-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>]

New-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>]
   [-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 New-CMAutoDeploymentRuleDeployment crée un déploiement pour une règle de déploiement automatique (ADR).

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 un déploiement pour une règle de déploiement automatique par nom

Cette commande crée un déploiement pour la règle de déploiement automatique TestDepRule01 et la collection Tous les systèmes .

New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -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 $false

Exemple 2 : Créer un déploiement pour une règle de déploiement automatique par objet

Cette commande obtient l’objet de règle de déploiement automatique nommé TestDepRule02. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à New-CMAutoDeploymentRuleDeployment, ce qui crée un déploiement pour la règle de déploiement automatique TestDepRule02 et la collection All Systems .

Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -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 $false

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.

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.

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.

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, déployez 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 de la règle de déploiement automatique à laquelle ajouter ce déploiement.

Type:	Int32
Alias:	AutoDeploymentID
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 auquel ajouter ce déploiement. Pour obtenir un objet de règle de déploiement automatique, utilisez l’applet de commande Get-CMSoftwareUpdateAutoDeploymentRule .

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

-Name

Spécifie le nom de la règle de déploiement automatique à laquelle ajouter ce déploiement.

Type:	String
Alias:	AutoDeploymentName
Position:	0
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 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

-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.

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.

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). Si la valeur $Falseest définie sur , 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

Commentaires

Cette page a-t-elle été utile ?