New-CMApplicationDeployment
Créer un déploiement d’application.
Syntaxe
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-CMApplicationDeployment crée un déploiement d’application. Pour plus d’informations, consultez Déployer des applications avec Configuration Manager.
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 : Installer une application
Cette commande crée un déploiement pour Visual Studio 2019 sur la station de travail des développeurs du regroupement. Il installe l’application et est obligatoire. La date et l’échéance disponibles sont toutes les deux identiques dans le passé. Par conséquent, dès que le client reçoit cette stratégie, il installe l’application.
New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose RequiredParamè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 |
-ApprovalRequired
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 |
-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 cette 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 cette 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écifiez un commentaire facultatif pour ce 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: | 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 |
| Alias: | SupersedenceDeadlineDateTime |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeployAction
Spécifiez l’action de déploiement pour installer ou désinstaller l’application. Si des déploiements concurrents ciblent le même appareil, l’action Installer est prioritaire.
| Type: | DeployActionType |
| Valeurs acceptées: | Install, Uninstall |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DeployPurpose
Spécifiez l’objectif du déploiement :
Available: l’utilisateur voit l’application dans le Centre logiciel. Ils peuvent l’installer à la demande.Required: le client installe automatiquement l’application selon la planification que vous définissez. Si l’application n’est pas masquée, un utilisateur peut suivre son état de déploiement. Ils peuvent également utiliser le Centre logiciel pour installer l’application avant l’échéance.
| Type: | DeployPurposeType |
| Valeurs acceptées: | Available, Required |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisableContentDependencyDetection
Ajoutez ce paramètre pour ne pas distribuer automatiquement le contenu pour les applications dépendantes.
| Type: | SwitchParameter |
| Alias: | DisableDetectAssociatedContentDependencies |
| 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 |
-DistributeCollectionName
Le site distribue le contenu aux points de distribution associés à ce nom de collection.
| 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 |
-DistributeContent
Ajoutez ce paramètre si vous devez d’abord distribuer le contenu de l’application.
| 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 |
-DistributionPointGroupName
Pour distribuer le contenu de l’application, spécifiez le nom d’un groupe de points de distribution.
| 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 |
-DistributionPointName
Pour distribuer le contenu de l’application, spécifiez le nom d’un point de distribution.
| 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 |
-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 |
-GenerateScomAlertOnFailure
Indique s’il faut créer une alerte Operations Manager si un client ne parvient pas à installer l’application.
| Type: | Boolean |
| Alias: | RaiseMomAlertsOnFailure |
| 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écifiez l’ID de l’application à déployer.
| Type: | Int32 |
| Alias: | CIId, CI_ID, ApplicationId |
| 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écifiez un objet d’application à déployer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMApplication .
| Type: | IResultObject |
| Alias: | Application |
| 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écifiez le nom de l’application à déployer.
| Type: | String |
| Alias: | LocalizedDisplayName, ApplicationName |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| 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 |
-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 |
-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 |
-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 |
-Simulation
Ajoutez ce paramètre pour créer une simulation de déploiement. Pour plus d’informations, consultez Simuler des déploiements d’applications avec Configuration Manager.
| 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 |
-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 |
-UpdateSupersedence
Pour un déploiement disponible, utilisez ce paramètre pour spécifier l’échéance d’installation pour mettre à niveau les utilisateurs ou les appareils sur utilisant l’application remplacée. Utilisez DeadlineDateTime pour spécifier une heure spécifique, sinon elle est le plus tôt possible après AvailableDateTime.
| 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 |
-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: | 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
System.Object