Partager via

Start-CMApplicationDeployment

  • Référence
Module:
ConfigurationManager

(Déconseillé) Démarre un déploiement d’application dans Configuration Manager.

Syntaxe

Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-InputObject] <IResultObject>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Id] <Int32>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMApplicationDeployment
     [-ApprovalRequired <Boolean>]
     [-AvailableDate <DateTime>]
     [-AvailableDateTime <DateTime>]
     [-AvailableTime <DateTime>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeadlineDate <DateTime>]
     [-DeadlineDateTime <DateTime>]
     [-DeadlineTime <DateTime>]
     [-DeployAction <DeployActionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-EnableMomAlert <Boolean>]
     [-FailParameterValue <Int32>]
     [-GenerateScomAlertOnFailure <Boolean>]
     [-Name] <String>
     [-OverrideServiceWindow <Boolean>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-PostponeDate <DateTime>]
     [-PostponeDateTime <DateTime>]
     [-PostponeTime <DateTime>]
     [-PreDeploy <Boolean>]
     [-RebootOutsideServiceWindow <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SuccessParameterValue <Int32>]
     [-TimeBaseOn <TimeType>]
     [-UpdateSupersedence <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

Cette applet de commande est déconseillée. Utilisez New-CMApplicationDeployment à la place.

L’applet de commande Start-CMApplicationDeployment démarre un déploiement d’application.

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 : Démarrer le déploiement d’applications

PS XYZ:\> Start-CMApplicationDeployment -CollectionName "All Users" -Name "7zip" -AvaliableDate 2012/10/1 -AvaliableTime 12:45 -Comment "test" -DeadlineDate 2013/10/23 -DeadlineTime 21:12 -DeployAction Uninstall -EnableMomAlert $True -FailParameterValue 40 -OverrideServiceWindow $True -PersistOnWriteFilterDevice $False -PostponeDate 2014/2/8 -PostponeTime 11:11 -PreDeploy $True -RaiseMomAlertsOnFailure $True -RebootOutsideServiceWindow $True -SendWakeUpPacket $True -SuccessParameterValue 30 -UseMeteredNetwork $True -UserNotification DisplaySoftwareCenterOnly

Cette commande démarre un déploiement d’application nommé 7zip.

Paramètres

-ApprovalRequired

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

-AvailableDate

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

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

-AvailableTime

Type:DateTime
Alias:AvailiableTime
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 une collection cible pour déployer cette 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

-Comment

Spécifie un commentaire pour l’application.

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

-DeadlineDate

Spécifie un jour d’installation d’une application. L’installation automatique effectue l’installation si l’application n’est pas installée.

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

-DeadlineDateTime

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

-DeadlineTime

Spécifie une heure d’installation d’une application. L’installation automatique effectue l’installation si l’application n’est pas installée.

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

-DeployAction

Spécifie une action pour un déploiement. Les valeurs valides sont les suivantes :

  • Installer. Installez l’application.

  • Désinstallez. Désinstallez l’application.

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écifie l’objectif du déploiement.

Les valeurs valides sont les suivantes :

  • Disponible. Si le regroupement cible est un regroupement d’appareils, l’application est disponible dans le centre logiciel. Si la collection cible est une collection d’utilisateurs, l’application est disponible dans le site web du catalogue.

  • Obligatoire. L’installation se produit lorsque l’échéance est écoulée.

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

-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

Indique s’il faut activer le mode de maintenance Operations Manager.

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 une valeur qui génère une alerte de déploiement en cas de dépassement.

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

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écifie un tableau d’ID.

Type:Int32
Alias:CIId, CI_ID
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 déploiement d’application.

Type:IResultObject
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 un tableau de noms pour le déploiement de l’application.

Type:String
Alias:LocalizedDisplayName
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 une installation d’application se produit 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

-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 si les modifications doivent être validées sur un appareil Windows Embedded à l’échéance ou pendant une fenêtre de maintenance. Sinon, les modifications sont écrites sur la superposition et validées 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

-PostponeDate

Spécifie une date après laquelle créer une alerte.

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

-PostponeDateTime

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

-PostponeTime

Spécifie un délai après lequel créer une alerte.

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 copier le logiciel sur un appareil avant l’installation. Pour utiliser ce paramètre, définissez le paramètre DeployPurpose sur Obligatoire.

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 service. Une fenêtre de service 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 service. Si cette valeur est $False, l’ordinateur ne redémarre pas en dehors d’une fenêtre de service.

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 met un ordinateur en veille. Si cette valeur est $False, elle ne met pas en veille les ordinateurs. 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 une valeur que le seuil doit dépasser avant la création d’une alerte.

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.

Les valeurs valides sont les suivantes :

  • LocalTime. Utilisez l’heure locale.
  • UTC. Utilisez le temps universel coordonné (UTC), également appelé heure moyenne de Greenwich.
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

{{ Fill UpdateSupersedence Description }}

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 si les clients peuvent télécharger du contenu sur des connexions Internet limitées après l’échéance de l’installation. Les clients peuvent 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

-UserNotification

Spécifie les types de notification utilisateur.

Les valeurs valides sont les suivantes :

  • DisplayAll. Afficher dans le Centre logiciel et afficher toutes les notifications.

  • DisplaySoftwareCenterOnly. Afficher dans le Centre logiciel et afficher uniquement les notifications pour les redémarrages de l’ordinateur.

  • HideAll. Ne pas afficher dans le Centre logiciel et ne pas afficher 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

System.Object