Add-CMTaskSequenceDeploymentType

模块:

ConfigurationManager

创建任务序列作为应用模型部署类型。

语法

Add-CMTaskSequenceDeploymentType
   -ApplicationName <String>
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -ApplicationId <Int32>
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

适用于版本 2006 及更高版本。 创建任务序列作为应用模型部署类型。 有关详细信息，请参阅 任务序列部署类型。

此 cmdlet 的语法与 MSI 部署类型 cmdlet Add-CMMsiDeploymentType 类似。 主要区别是以下参数：

• -InstallTaskSequenceId <string> 需要 () ：用于安装应用的任务序列的 ID

• -UninstallTaskSequenceId <string> (可选) ：要卸载应用的任务序列的 ID

这两个参数与部署类型任务序列选项相关。 它们替换 -InstallCommand MSI cmdlet 上的 和 -UninstallCommand 参数。

示例

示例 1：添加任务序列部署类型

本示例将任务序列 ID ABC001EB 添加到应用 CBI。 它还ABC00378添加卸载任务序列 ID。

Add-CMTaskSequenceDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -Comment "New Deployment Type" -InstallTaskSequenceId "ABC001EB" -UninstallTaskSequenceId "ABC00378" -ScriptLanguage "PowerShell" -ScriptText "dir"

参数

-AddDetectionClause

为此部署类型指定检测方法子句的数组。 若要创建检测子句，请使用以下 cmdlet 之一：

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

将这些 cmdlet 的输出保存到变量中。 然后将这些变量指定为此参数的数组。 例如，-AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3。

还可以使用 Get-CMDeploymentTypeDetectionClause 从另一个应用程序获取现有检测子句。

类型:	DetectionClause[]
别名:	AddDetectionClauses
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-AddLanguage

指定部署类型支持的语言标记数组。 例如，若要添加 俄语 (俄罗斯) ，请指定 标记 ru-RU。

有关详细信息和语言标记列表，请参阅 Windows 语言代码标识符 (LCID) 参考。

类型:	String[]
别名:	AddLanguages, Languages, Language
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AddRequirement

为部署类型指定要求对象的数组。 若要创建要求规则对象，请使用以下 cmdlet 之一：

• 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

从版本 2111 开始，可以使用 Get-CMDeploymentTypeRequirement cmdlet 从其他部署类型复制规则。

类型:	Rule[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ApplicationId

为此部署类型指定应用程序的 ID。

类型:	Int32
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationName

为此部署类型指定应用程序的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Comment

为部署类型指定可选说明。

类型:	String
别名:	AdministratorComment
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeploymentTypeName

指定此部署类型的显示名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DetectionClauseConnector

使用 GroupDetectionClauses 参数对检测子句进行分组时，请使用此参数指定连接器。

以下示例定义 OR 连接器： @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

类型:	Hashtable[]
别名:	DetectionClauseConnectors
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EstimatedRuntimeMins

指定应用程序的此部署类型的估计安装时间（以分钟为单位）。 软件中心在安装应用程序之前向用户显示此估算值。

类型:	Int32
别名:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

强制运行命令而不要求用户确认。

类型:	SwitchParameter
别名:	ForceForUnknownPublisher
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceScriptDetection32Bit

如果使用自定义脚本来检测是否存在此部署类型，请将此参数设置为 $true 以在 64 位客户端上以 32 位进程的形式运行脚本。

类型:	SwitchParameter
别名:	Force32BitDetectionScript
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GroupDetectionClauses

配置规则以检测是否存在此部署类型时，请使用此参数对子句进行分组。 若要创建检测子句，请使用以下 cmdlet 之一：

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

将这些 cmdlet 的输出保存到变量中。 然后使用以下格式对子句进行分组： $clause2.Setting.LogicalName, $clause3.Setting.LogicalName。

提示

在 Configuration Manager 控制台中，选择 “组 ”操作时，子句在分组子句之前和之后显示括号。

类型:	String[]
别名:	GroupDetectionClausesByLogicalName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

指定要配置的应用程序对象。 若要获取此对象，请使用 Get-CMApplication cmdlet。

类型:	IResultObject
别名:	Application
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-InstallationBehaviorType

指定此部署类型的安装行为：

• InstallForUser：客户端仅为部署应用程序的用户安装应用程序。
• InstallForSystem：客户端仅安装一次应用程序。 它可供所有用户使用。
• InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser：如果将应用程序部署到设备，则客户端会为所有用户安装该应用程序。 如果将应用程序部署到用户，则客户端仅为该用户安装该应用程序。

类型:	InstallationBehaviorType
接受的值:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstallTaskSequenceId

要安装应用的任务序列的 ID。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-LogonRequirementType

指定已登录用户的要求：

• OnlyWhenNoUserLoggedOn：仅当没有用户登录到 Windows 时。

• OnlyWhenUserLoggedOn：仅当用户登录时。 此选项是默认选项。

• WhetherOrNotUserLoggedOn：用户是否已登录。

  注意

  值 WhereOrNotUserLoggedOn 已弃用。 它已替换为 WhetherOrNotUserLoggedOn。

如果将 InstallationBehaviorType 设置为 InstallForUser，则无法设置此参数。

类型:	LogonRequirementType
接受的值:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaximumRuntimeMins

指定此应用程序的部署程序允许的最大运行时间。 设置整数值（以分钟为单位）。

类型:	Int32
别名:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProductCode

如果应用程序使用 Windows Installer 技术，请指定要设置为检测方法的 MSI 产品代码。 使用此参数时，它会覆盖任何现有的检测方法。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RebootBehavior

指定安装后行为：

• BasedOnExitCode：根据返回代码确定行为。

• NoAction：无特定操作。

• ProgramReboot：软件安装程序可能会强制重启设备。

• ForceReboot：Configuration Manager 客户端将强制重启设备。

有关这些行为的详细信息，请参阅 在 Configuration Manager 中创建应用程序。

类型:	PostExecutionBehavior
接受的值:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveLanguage

指定要从此部署类型中删除的受支持语言的数组。

类型:	String[]
别名:	RemoveLanguages
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveRequirement

指定要从此部署类型中删除的要求规则数组。

类型:	Rule[]
别名:	RemoveRequirements
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequireUserInteraction

将此参数设置为 以 $true 允许用户查看部署类型安装并与之交互。

类型:	SwitchParameter
别名:	RequiresUserInteraction
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScriptFile

指定用于检测此部署类型的脚本文件。 另请使用 ScriptLanguage 参数。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScriptLanguage

如果使用 ScriptFile 或 ScriptText 参数，请使用此参数指定脚本语言。

类型:	ScriptLanguage
别名:	ScriptType
接受的值:	PowerShell, VBScript, JavaScript
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ScriptText

指定用于检测此部署类型的脚本文本。 另请使用 ScriptLanguage 参数。

有关详细信息，请参阅 关于自定义脚本检测方法。

类型:	String
别名:	ScriptContent
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SlowNetworkDeploymentMode

当客户端使用来自相邻边界组或默认站点边界组的分发点时，请指定部署选项：

• DoNothing：不下载内容
• Download：从分发点下载内容并在本地运行

类型:	ContentHandlingMode
接受的值:	DoNothing, Download
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UninstallTaskSequenceId

要卸载应用的任务序列的 ID。

类型:	String
别名:	UninstallId, UninstallTaskSequencePackageId
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserInteractionMode

指定安装程序可见性：

• Normal：部署类型根据系统和程序默认值在正常模式下运行。 此模式是默认模式。
• Minimized：部署类型在客户端设备上以最小化方式运行。 用户可能会在通知区域或任务栏中看到安装活动。
• Maximized：部署类型在客户端设备上运行最大化。 用户将看到所有安装活动。
• Hidden：部署类型在客户端设备上隐藏运行。 用户看不到安装活动。

类型:	UserInteractionMode
别名:	InstallationProgramVisibility
接受的值:	Normal, Minimized, Maximized, Hidden
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Set-CMTaskSequenceDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• 任务序列部署类型