Partager via


Set-CMTaskSequenceDeploymentType

Configurer un type de déploiement de séquence de tâches sur une application.

Syntaxe

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -Application <IResultObject>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

S’applique à la version 2006 et ultérieure. Utilisez cette applet de commande pour configurer un type de déploiement de séquence de tâches sur une application. Pour plus d’informations, consultez Type de déploiement de séquence de tâches.

Cette applet de commande a une syntaxe similaire à celle de l’applet de commande de type de déploiement MSI Set-CMMsiDeploymentType. Les principales différences sont les paramètres suivants :

  • -InstallTaskSequenceId <string> (obligatoire) : ID de la séquence de tâches pour installer l’application

  • -UninstallTaskSequenceId <string> (facultatif) : ID de la séquence de tâches pour désinstaller l’application

Ces deux paramètres sont liés aux options de séquence de tâches de type de déploiement. Ils remplacent les -InstallCommand paramètres et -UninstallCommand sur l’applet de commande MSI.

Exemples

Exemple 1 : Modifier un type de déploiement de séquence de tâches

Cette commande remplace le nom du type de déploiement Installation complexe par Installation avancée. Il ajoute l’anglais (États-Unis) (en-US) et le chinois (simplifié) () commezh-CN langues prises en charge. Il spécifie que l’installation prend environ 14 minutes et ne s’exécute que lorsqu’aucun utilisateur n’est connecté à Windows.

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

Pour obtenir d’autres exemples de règles d’exigence et de méthodes de détection, consultez Set-CMScriptDeploymentType et Add-CMMsiDeploymentType.

Paramètres

-AddDetectionClause

Spécifiez un tableau de clauses de méthode de détection pour ce type de déploiement. Pour créer une clause de détection, utilisez l’une des applets de commande suivantes :

Enregistrez la sortie de ces applets de commande dans une variable. Spécifiez ensuite ces variables en tant que tableau pour ce paramètre. Par exemple : -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Vous pouvez également utiliser Get-CMDeploymentTypeDetectionClause pour obtenir une clause de détection existante à partir d’une autre application.

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

-AddLanguage

Spécifiez un tableau de balises de langue que le type de déploiement prend en charge. Par exemple, pour ajouter russe (Russie), spécifiez la balise ru-RU.

Pour plus d’informations et pour obtenir la liste des balises de langue, consultez Informations de référence sur l’identificateur de code de langue Windows (LCID).

Type:String[]
Alias:AddLanguages, Languages, Language
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AddRequirement

Spécifiez un tableau d’objets de spécification pour le type de déploiement. Pour créer un objet de règle d’exigence, utilisez l’une des applets de commande suivantes :

À compter de la version 2111, vous pouvez utiliser l’applet de commande Get-CMDeploymentTypeRequirement pour copier des règles à partir d’un autre type de déploiement.

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

-Application

Spécifiez un objet d’application pour ce type de déploiement. Pour obtenir cet objet, utilisez l’applet de commande Get-CMApplication .

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

-ApplicationId

Spécifiez l’ID de l’application pour ce type de déploiement.

Type:Int32
Alias:CI_ID, CIId
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écifiez le nom de l’application pour ce type de déploiement.

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écifiez une description facultative pour le type de déploiement.

Type:String
Alias:AdministratorComment
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

-DeploymentTypeName

Spécifiez le nom du type de déploiement à configurer.

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

-DetectionClauseConnector

Lorsque vous utilisez le paramètre GroupDetectionClauses pour regrouper les clauses de détection, utilisez ce paramètre pour spécifier le connecteur.

L’exemple suivant définit le connecteur OR : @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Type:Hashtable[]
Alias:DetectionClauseConnectors
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

-EstimatedRuntimeMins

Spécifiez la durée d’installation estimée, en minutes, de ce type de déploiement pour l’application. Le Centre logiciel affiche cette estimation à l’utilisateur avant l’installation de l’application.

Type:Int32
Alias:EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-ForceScriptDetection32Bit

Si vous utilisez un script personnalisé pour détecter la présence de ce type de déploiement, définissez ce paramètre sur $true pour exécuter le script en tant que processus 32 bits sur les clients 64 bits.

Type:Boolean
Alias:Force32BitDetectionScript
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

-GroupDetectionClauses

Lorsque vous configurez des règles pour détecter la présence de ce type de déploiement, utilisez ce paramètre pour regrouper les clauses. Pour créer une clause de détection, utilisez l’une des applets de commande suivantes :

Enregistrez la sortie de ces applets de commande dans une variable. Utilisez ensuite le format suivant pour regrouper les clauses : $clause2.Setting.LogicalName, $clause3.Setting.LogicalName.

Conseil

Dans la console Configuration Manager, lorsque vous sélectionnez l’action Grouper , les clauses affichent des parenthèses avant et après les clauses groupées.

Type:String[]
Alias:GroupDetectionClausesByLogicalName
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 type de déploiement à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDeploymentType .

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

-InstallationBehaviorType

Spécifiez le comportement d’installation pour ce type de déploiement :

  • InstallForUser: le client installe uniquement l’application pour l’utilisateur sur lequel vous déployez l’application.
  • InstallForSystem: le client installe l’application une seule fois. Il est disponible pour tous les utilisateurs.
  • InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: si vous déployez l’application sur un appareil, le client l’installe pour tous les utilisateurs. Si vous déployez l’application sur un utilisateur, le client l’installe uniquement pour cet utilisateur.
Type:InstallationBehaviorType
Valeurs acceptées:InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InstallTaskSequenceId

ID de la séquence de tâches pour installer l’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

-LogonRequirementType

Spécifiez la condition requise pour un utilisateur connecté :

  • OnlyWhenNoUserLoggedOn: uniquement quand aucun utilisateur n’est connecté à Windows.

  • OnlyWhenUserLoggedOn: uniquement lorsqu’un utilisateur est connecté. Cette option est activée par défaut.

  • WhetherOrNotUserLoggedOn: indique si un utilisateur est connecté ou non.

    Remarque

    La valeur WhereOrNotUserLoggedOn est déconseillée. Il est remplacé par WhetherOrNotUserLoggedOn.

Si vous définissez InstallationBehaviorType sur InstallForUser, vous ne pouvez pas définir ce paramètre.

Type:LogonRequirementType
Valeurs acceptées:OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaximumRuntimeMins

Spécifiez la durée d’exécution maximale autorisée du programme de déploiement pour cette application. Définissez une valeur entière en minutes.

Type:Int32
Alias:MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NewName

Spécifiez un nouveau nom pour renommer ce type de déploiement.

Type:String
Alias:NewDeploymentTypeName
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

-ProductCode

Si l’application utilise la technologie Windows Installer, spécifiez un code de produit MSI à définir comme méthode de détection. Lorsque vous utilisez ce paramètre, il remplace toutes les méthodes de détection existantes.

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

-RebootBehavior

Spécifiez le comportement de post-installation :

  • BasedOnExitCode: déterminez le comportement en fonction des codes de retour.

  • NoAction: aucune action spécifique.

  • ProgramReboot: le programme d’installation de logiciels peut forcer le redémarrage d’un appareil.

  • ForceReboot: le client Configuration Manager force un redémarrage obligatoire de l’appareil.

Pour plus d’informations sur ces comportements, consultez Créer des applications dans Configuration Manager.

Type:PostExecutionBehavior
Valeurs acceptées:BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveDetectionClause

Spécifiez un tableau de clauses de méthode de détection à supprimer.

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

-RemoveLanguage

Spécifiez un tableau de langues prises en charge à supprimer de ce type de déploiement.

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

-RemoveRequirement

Spécifiez un tableau de règles d’exigence à supprimer de ce type de déploiement.

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

-RequireUserInteraction

Définissez ce paramètre sur $true pour permettre aux utilisateurs d’afficher et d’interagir avec l’installation du type de déploiement.

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

-ScriptFile

Spécifiez le fichier de script à utiliser pour détecter ce type de déploiement. Utilisez également le paramètre ScriptLanguage .

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

-ScriptLanguage

Si vous utilisez les paramètres ScriptFile ou ScriptText , utilisez ce paramètre pour spécifier le langage de script.

Type:ScriptLanguage
Alias:ScriptType
Valeurs acceptées:PowerShell, VBScript, JavaScript
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ScriptText

Spécifiez le texte d’un script pour détecter ce type de déploiement. Utilisez également le paramètre ScriptLanguage .

Pour plus d’informations, consultez À propos des méthodes de détection de script personnalisées.

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

-SlowNetworkDeploymentMode

Lorsqu’un client utilise un point de distribution à partir d’un groupe de limites voisin ou du groupe de limites de site par défaut, spécifiez l’option de déploiement :

  • DoNothing: Ne pas télécharger de contenu
  • Download: télécharger du contenu à partir du point de distribution et exécuter localement
Type:ContentHandlingMode
Valeurs acceptées:DoNothing, Download
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UninstallTaskSequenceId

ID de la séquence de tâches pour désinstaller l’application.

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

-UserInteractionMode

Spécifiez la visibilité du programme d’installation :

  • Normal: le type de déploiement s’exécute en mode normal en fonction des valeurs par défaut du système et du programme. Ce mode est la valeur par défaut.
  • Minimized: le type de déploiement s’exécute au minimum sur les appareils clients. Les utilisateurs peuvent voir l’activité d’installation dans la zone de notification ou la barre des tâches.
  • Maximized: le type de déploiement s’exécute de manière agrandie sur les appareils clients. Les utilisateurs voient toute l’activité d’installation.
  • Hidden: le type de déploiement s’exécute masqué sur les appareils clients. Les utilisateurs ne voient aucune activité d’installation.
Type:UserInteractionMode
Alias:InstallationProgramVisibility
Valeurs acceptées:Normal, Minimized, Maximized, Hidden
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