Partager via


Set-CMApplicationDeployment

Configurer un déploiement d’application

Syntaxe

Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   -InputObject <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationId <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   -ApplicationName <String>
   [-AutoCloseExecutable <Boolean>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-CreateAlertBaseOnPercentFailure <Boolean>]
   [-CreateAlertBaseOnPercentSuccess <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-OverrideServiceWindow <Boolean>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RaiseMomAlertsOnFailure <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-RequireApproval <Boolean>]
   [-SendWakeUpPacket <Boolean>]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UseMeteredNetwork <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-CMApplicationDeployment modifie les propriétés d’un déploiement d’application dans Configuration Manager. Pour plus d’informations, consultez Déployer des applications avec Configuration Manager.

Pour spécifier un déploiement d’application à modifier, spécifiez le nom de la collection et l’application. Vous pouvez spécifier une application par nom ou ID. Vous pouvez également utiliser l’applet de commande Get-CMApplication pour obtenir une application à modifier.

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 : Modifier la disponibilité et l’échéance d’un déploiement d’application

Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)

Cette commande modifie un déploiement d’application pour une application nommée Track System 2011 pour une collection nommée Tous les utilisateurs. La commande spécifie la date actuelle de disponibilité de l’application. Il configure également l’échéance de déploiement pour 30 jours à l’avenir.

Paramètres

-AllowRepairApp

Utilisez ce paramètre pour configurer l’option réparer l’application lors de la création d’un déploiement pour une application.

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

-ApplicationId

Spécifie l’ID d’une application.

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

-ApplicationName

Spécifie le nom d’une application.

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

-AutoCloseExecutable

À compter de la version 2107, définissez ce paramètre sur $true pour activer le paramètre de déploiement d’application pour les comportements d’installation. Utilisez ensuite l’applet de commande Add-CMDeploymentTypeInstallBehavior pour ajouter un fichier exécutable afin de vérifier que l’installation n’est pas en cours d’exécution.

Définissez ce paramètre sur $false pour désactiver cette option dans les situations suivantes :

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

-AvailableDateTime

Spécifiez un objet DateTime pour le moment où ce déploiement est disponible. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

Utilisez DeadlineDateTime pour spécifier l’affectation ou l’échéance du déploiement.

Type:DateTime
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 sur lequel l’application est déployée. Pour obtenir cet objet, 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écifiez l’ID de la collection sur laquelle l’application est déployée. Par exemple : "SMS00004".

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écifiez le nom de la collection sur laquelle l’application est déployée.

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:True

-Comment

Spécifie un commentaire facultatif pour le déploiement.

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

-CreateAlertBaseOnPercentFailure

Indique s’il faut créer une alerte pour un pourcentage des applications qui ne parviennent pas à être déployées. Pour spécifier la valeur du pourcentage, utilisez le paramètre FailParameterValue .

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

-CreateAlertBaseOnPercentSuccess

Indique s’il faut créer une alerte pour un pourcentage des applications qui se déploient correctement. Pour spécifier la valeur du pourcentage, utilisez le paramètre SuccessParameterValue .

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

-DeadlineDateTime

Spécifiez un objet DateTime pour le moment où ce déploiement est attribué, également appelé échéance. Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

Utilisez -AvailableDateTime pour spécifier quand le déploiement est disponible.

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

-EnableMomAlert

Définissez ce paramètre sur $true pour activer le mode de maintenance de System Center Operations Manager pour ce déploiement.

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

-EnableSoftDeadline

Définissez ce paramètre sur $true pour activer l’application différée.

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

-FailParameterValue

Spécifie le pourcentage d’échec de l’installation de l’application qui provoque une alerte. Spécifiez un entier compris entre 1 et 100. Pour activer cette alerte, définissez le paramètre CreatAlertBaseOnPercentFailure sur $True.

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

-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

Spécifiez un objet de déploiement d’application à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMApplicationDeployment .

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

-OverrideServiceWindow

Indique si le déploiement 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 l’application même si l’heure planifiée est en dehors de la fenêtre de maintenance. Si cette valeur est $False, Configuration Manager ne déploie pas l’application en dehors de la fenêtre. Il attend qu’il puisse être déployé dans une fenêtre 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

-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

-PersistOnWriteFilterDevice

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 $Falseenregistre 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

-PostponeDateTime

Lorsque vous définissez CreateAlertBaseOnPercentSuccess sur $true, utilisez ce paramètre pour spécifier un objet DateTime . Configuration Manager crée une alerte de déploiement lorsque le seuil est inférieur à SuccessParameterValue après cette date.

Pour obtenir cet objet, utilisez l’applet de commande intégrée Get-Date .

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

-PreDeploy

Indique s’il faut prédéployer l’application sur l’appareil principal de l’utilisateur.

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

-RaiseMomAlertsOnFailure

Indique s’il faut créer une alerte Operations Manager si un client ne parvient pas à installer l’application.

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

-RebootOutsideServiceWindow

Indique si un ordinateur redémarre 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, tout redémarrage requis a lieu sans tenir compte des fenêtres de maintenance. Si cette valeur est $False, l’ordinateur ne redémarre pas en dehors d’une fenêtre de maintenance.

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

-ReplaceToastNotificationWithDialog

Lorsque le logiciel requis est disponible sur le client, définissez ce paramètre $true sur pour remplacer les notifications toast par défaut par une fenêtre de dialogue. Elle est false par défaut. Pour plus d’informations, consultez Remplacer les notifications toast par la fenêtre de dialogue.

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

-RequireApproval

Si vous définissez ce paramètre sur $true, un administrateur doit approuver une demande pour cette application sur l’appareil.

Type:Boolean
Alias:AppRequiresApproval
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 tente de sortir un ordinateur de 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

-SuccessParameterValue

Spécifie le pourcentage d’installation réussie de l’application qui provoque une alerte. Spécifiez un entier compris entre 0 et 99. Pour activer cette alerte, définissez le paramètre CreateAlertBaseOnPercentSuccess sur $True.

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

-TimeBaseOn

Spécifie le fuseau horaire à utiliser :

  • LocalTime: utilisez l’heure locale.
  • UTC: utilisez le temps universel coordonné (UTC).
Type:TimeType
Valeurs acceptées:LocalTime, Utc
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseMeteredNetwork

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

-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

-WhatIf

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

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_ApplicationAssignment classe WMI du serveur.