Set-CMTaskSequenceDeploymentType

Module:

ConfigurationManager

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

Syntax

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 aux versions 2006 et ultérieures. Utilisez cette cmdlet pour configurer un type de déploiement de séquence de tâches sur une application. Pour plus d’informations, voir Type de déploiement séquence de tâches.

Cette cmdlet a une syntaxe similaire à celle de la cmdlet 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 déploiement. Ils remplacent -InstallCommand les -UninstallCommand paramètres et les paramètres de la cmdlet MSI.

Exemples

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

Cette commande modifie le nom du type de déploiement de l’installation complexe à l’installation avancée. Il ajoute l’anglais (États-Unis) ( en-US ) et le chinois (simplifié) ( ) en tant que zh-CN langues pris en charge. Il spécifie que l’installation prendra environ 14 minutes et s’exécutera uniquement lorsqu’aucun utilisateur n’est 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 avec des règles de conditions requises et des méthodes de détection, voir Set-CMScriptDeploymentType et Add-CMMsiDeploymentType.

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

-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 cmdlets suivantes :

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

Enregistrez la sortie de ces cmdlets 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[]
Aliases:	AddDetectionClauses
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguage

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

Pour plus d’informations et une liste de balises de langue, voir Windows language Code Identifier (LCID) Reference.

Type:	String[]
Aliases:	AddLanguages, Languages, Language
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddRequirement

Spécifiez un tableau d’objets de conditions requises pour le type de déploiement. Pour créer un objet de règle de conditions requises, utilisez l’une des cmdlets suivantes :

• New-CMRequirementRuleActiveDirectorySiteValue
• New-CMRequirementRuleBooleanValue
• New-CMRequirementRuleCMSiteValue
• New-CMRequirementRuleCommonValue
• New-CMRequirementRuleDeviceOwnershipValue
• New-CMRequirementRuleExistential
• New-CMRequirementRuleExpression
• New-CMRequirementRuleFileAttributeValue
• New-CMRequirementRuleFilePermissionValue
• New-CMRequirementRuleFreeDiskSpaceValue
• New-CMRequirementRuleInputTypeValue
• New-CMRequirementRuleOperatingSystemLanguageValue
• New-CMRequirementRuleOperatingSystemValue
• New-CMRequirementRuleOUValue
• New-CMRequirementRuleRegistryKeyPermissionValue
• New-CMRequirementRuleScreenResolutionValue

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

Type:	Rule[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Application

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

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

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

Type:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

Spécifiez une description facultative pour le type de déploiement.

Type:	String
Aliases:	AdministratorComment
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentTypeName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DetectionClauseConnector

Lorsque vous utilisez le paramètre GroupDetectionClauses pour grouper des 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[]
Aliases:	DetectionClauseConnectors
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

-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
Aliases:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Force l’exécuter sans demander confirmation à l’utilisateur.

Type:	SwitchParameter
Aliases:	ForceForUnknownPublisher
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 pour exécuter le script en tant que processus 32 bits sur les $true clients 64 bits.

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

-GroupDetectionClauses

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

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

Enregistrez la sortie de ces cmdlets dans une variable. Ensuite, utilisez le format suivant pour grouper les clauses : $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Conseil

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

Type:	String[]
Aliases:	GroupDetectionClausesByLogicalName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Spécifiez un objet de type de déploiement à configurer. Pour obtenir cet objet, utilisez la cmdlet Get-CMDeploymentType.

Type:	IResultObject
Aliases:	DeploymentType
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallationBehaviorType

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

• InstallForUser: le client installe uniquement l’application pour l’utilisateur vers lequel vous déployez l’application.
• InstallForSystem: le client n’installe l’application qu’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 pour un utilisateur, le client l’installe uniquement pour cet utilisateur.

Type:	InstallationBehaviorType
Accepted values:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallTaskSequenceId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LogonRequirementType

Spécifiez la condition requise pour un utilisateur inscrit :

• OnlyWhenNoUserLoggedOn: uniquement lorsqu’aucun utilisateur n’est Windows.

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

• WhetherOrNotUserLoggedOn: si un utilisateur est ou non signé.

  Notes

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

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

Type:	LogonRequirementType
Accepted values:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumRuntimeMins

Spécifiez la durée d’utilisation maximale autorisée du programme de déploiement pour cette application. Définissez une valeur de l’ensemble en minutes.

Type:	Int32
Aliases:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

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

Type:	String
Aliases:	NewDeploymentTypeName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette cmdlet peut ne pas générer de sortie.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProductCode

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RebootBehavior

Spécifiez le comportement post-installation :

• BasedOnExitCode: Déterminer 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, voir Créer des applications dans Configuration Manager.

Type:	PostExecutionBehavior
Accepted values:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveDetectionClause

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

Type:	String[]
Aliases:	RemoveDetectionClauses
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguage

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

Type:	String[]
Aliases:	RemoveLanguages
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveRequirement

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

Type:	Rule[]
Aliases:	RemoveRequirements
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RequireUserInteraction

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

Type:	Boolean
Aliases:	RequiresUserInteraction
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptLanguage

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

Type:	ScriptLanguage
Aliases:	ScriptType
Accepted values:	PowerShell, VBScript, JavaScript
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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, voir À propos des méthodes de détection de script personnalisées.

Type:	String
Aliases:	ScriptContent, Script
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 le contenu à partir du point de distribution et s’exécuter localement

Type:	ContentHandlingMode
Accepted values:	DoNothing, Download
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UninstallTaskSequenceId

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

Type:	String
Aliases:	ContentLocation, UninstallId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 le mode par défaut.
• Minimized: le type de déploiement s’exécute en mode réduit 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 façon agrandie sur les appareils clients. Les utilisateurs voient toutes les activités 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
Aliases:	InstallationProgramVisibility
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Liens associés

• Add-CMTaskSequenceDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• Type de déploiement de séquence de tâches