New-CMApplicationDeployment
Créez un déploiement d’application.
Syntax
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’cmdlet New-CMApplicationDeployment crée un déploiement d’application. Pour plus d’informations, voir Déployer des applications avec Configuration Manager.
Notes
Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\>
exemple. Pour plus d’informations, voir la mise en place.
Exemples
Exemple 1 : Installer une application
Cette commande crée un déploiement pour Visual Studio 2019 à la station de travail Développeurs. Il installe l’application et est obligatoire. La date et l’échéance disponibles étant identiques dans le passé, 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 Required
Paramètres
- Confirmer
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
- WhatIf
Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRepairApp
Utilisez ce paramètre pour configurer l’option de réparation de l’application lors de la création d’un déploiement pour une application.
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApprovalRequired
Si vous définissez ce paramètre sur , un administrateur $true
doit approuver une demande pour cette application sur l’appareil.
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCloseExecutable
À partir de la version 2107, définissez ce paramètre pour activer le paramètre de déploiement $true
d’application pour les comportements d’installation. Utilisez ensuite la cmdlet Add-CMDeploymentTypeInstallBehavior pour ajouter un fichier exécutable pour vérifier que l’installation ne fonctionne pas.
Définissez ce paramètre $false
pour désactiver cette option dans les situations suivantes :
- Lorsque vous utilisez la cmdlet Remove-CMDeploymentTypeInstallBehavior pour supprimer tous les fichiers exécutables
- Vous ne souhaitez pas que le déploiement vérifie l’exécution des exécutables.
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableDateTime
Spécifiez un objet DateTime pour le moment où ce déploiement est disponible. Pour obtenir cet objet, utilisez la cmdlet intégrée Get-Date.
Utilisez DeadlineDateTime pour spécifier l’affectation de déploiement ou l’échéance. __
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Spécifiez un objet de collection sur lequel l’application est déployée. Pour obtenir cet objet, utilisez la cmdlet Get-CMCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Spécifiez l’ID de la collection sur laquelle cette application est déployée. Par exemple, "SMS00004"
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Spécifiez le nom de la collection dans laquelle cette application est déployée.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
Spécifiez un commentaire facultatif pour ce déploiement.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineDateTime
Spécifiez un objet DateTime pour le moment où ce déploiement est affecté, également appelé échéance. Pour obtenir cet objet, utilisez la cmdlet intégrée Get-Date.
Utilisez -AvailableDateTime pour spécifier quand le déploiement est disponible.
Type: | DateTime |
Aliases: | SupersedenceDeadlineDateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployAction
Spécifiez l’action de déploiement, soit pour installer ou désinstaller l’application. Si des déploiements concurrents ciblent le même appareil, l’action Installer est prioritaire.
Type: | DeployActionType |
Accepted values: | Install, Uninstall |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
Spécifiez l’objectif du déploiement :
Available
: l’utilisateur voit l’application dans le Centre de logiciels. Ils peuvent l’installer à la demande.Required
: le client installe automatiquement l’application en fonction de la planification que vous avez définie. Si l’application n’est pas masquée, un utilisateur peut suivre son état de déploiement. Ils peuvent également utiliser le Centre de logiciels pour installer l’application avant l’échéance.
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableContentDependencyDetection
Ajoutez ce paramètre pour ne pas distribuer automatiquement le contenu des applications dépendantes.
Type: | SwitchParameter |
Aliases: | DisableDetectAssociatedContentDependencies |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeCollectionName
Le site distribue le contenu aux points de distribution associés à ce nom de collection.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeContent
Ajoutez ce paramètre si vous devez d’abord distribuer le contenu de l’application.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
Pour distribuer le contenu de l’application, spécifiez le nom d’un groupe de points de distribution.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
Pour distribuer le contenu de l’application, spécifiez le nom d’un point de distribution.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
Définissez ce paramètre $true
pour activer le mode System Center maintenance Operations Manager pour ce déploiement.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
Définissez ce paramètre pour $true
activer l’application différée.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailParameterValue
Spécifie le pourcentage d’échec de l’installation de l’application à l’origine d’une alerte.
Spécifiez un nombre integer de 1 à 100.
Pour activer cette alerte, définissez le paramètre CreatAlertBaseOnPercentFailure sur $True
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateScomAlertOnFailure
Indique s’il faut créer une alerte Operations Manager si un client ne parvient pas à installer l’application.
Type: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Spécifiez l’ID de l’application à déployer.
Type: | Int32 |
Aliases: | CIId, CI_ID, ApplicationId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Spécifiez un objet d’application à déployer. Pour obtenir cet objet, utilisez l’cmdlet Get-CMApplication.
Type: | IResultObject |
Aliases: | Application |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Spécifiez le nom de l’application à déployer.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OverrideServiceWindow
Indique si le déploiement a lieu même s’il est programmé en dehors d’une fenêtre de maintenance.
Une fenêtre de maintenance est une période spécifiée utilisée pour la maintenance et les mises à jour de l’ordinateur.
Si cette valeur est , Configuration Manager déploie l’application même si l’heure prévue se situe en $True
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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indique s’il faut activer les filtres d’écriture pour les appareils incorporés.
Pour une valeur de $True
, l’appareil validera les modifications au cours d’une fenêtre de maintenance. Cette action nécessite un redémarrage.
Pour une valeur de $False
, l’appareil enregistre les modifications dans une superposition et les validera ultérieurement.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostponeDateTime
Lorsque vous définissez CreateAlertBaseOnPercentSuccess sur , utilisez ce paramètre pour spécifier $true
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 la cmdlet intégrée Get-Date.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDeploy
Indique s’il faut pré-déployer l’application sur l’appareil principal de l’utilisateur.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 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 prendre en compte les fenêtres de maintenance.
Si cette valeur $False
est, l’ordinateur ne redémarre pas en dehors d’une fenêtre de maintenance.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplaceToastNotificationWithDialog
Lorsque le logiciel requis est disponible sur le client, définissez ce paramètre pour remplacer les notifications toast par défaut $true
par une fenêtre de dialogue. Elle est false par défaut. Pour plus d’informations, voir Remplacer les notifications toast par une fenêtre de dialogue.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indique s’il faut envoyer un paquet de veille aux ordinateurs avant le début du déploiement.
Si cette valeur est , Configuration Manager tente de mettre un ordinateur en $True
veille.
Si cette valeur est , elle n’est pas une veille $False
pour les ordinateurs.
Pour que les ordinateurs s’ernt, vous devez d’abord configurer Wake On LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Simulation
Ajoutez ce paramètre pour créer une simulation de déploiement. Pour plus d’informations, voir Simuler des déploiements d’applications avec Configuration Manager.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessParameterValue
Spécifie le pourcentage d’installation réussie de l’application qui provoque une alerte.
Spécifiez un nombre integer entre 0 et 99.
Pour activer cette alerte, définissez le paramètre CreateAlertBaseOnPercentSuccess comme $True
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
Spécifie le fuseau horaire à utiliser :
LocalTime
: utilisez l’heure locale.UTC
: utiliser le temps universel coordonné (UTC).
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateSupersedence
Pour un déploiement disponible, utilisez ce paramètre pour spécifier la date d’échéance d’installation pour mettre à niveau les utilisateurs ou les appareils sur qui l’application en question est installée. Utilisez DeadlineDateTime pour spécifier une heure spécifique, sinon elle se produit dès que possible après AvailableDateTime.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indique s’il faut autoriser les clients à télécharger du contenu sur une connexion Internet avec limites après l’échéance, ce qui peut être une dépense supplémentaire.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Spécifie le type de notification de l’utilisateur.
DisplayAll
: affichez dans le Centre logiciel et affichez toutes les notifications.DisplaySoftwareCenterOnly
: affichez dans le Centre logiciel et affichez uniquement les notifications de redémarrage de l’ordinateur.HideAll
: Masquer dans le Centre de logiciels et toutes les notifications.
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Sorties
System.Object