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 :
- Lorsque vous utilisez l’applet de commande Remove-CMDeploymentTypeInstallBehavior pour supprimer tous les fichiers exécutables
- Vous ne souhaitez pas que le déploiement vérifie les exécutables en cours d’exécution.
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 $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 |
-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.