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 -UninstallCommand MSI cmdlet 上的 和 参数。

示例

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

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

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 从另一个应用程序获取现有检测子句。

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

-AddLanguage

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

有关详细信息和语言标记列表，请参阅 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

为部署类型指定要求对象数组。 若要创建要求规则对象，请使用以下 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 从另一个部署类型复制规则。

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

-ApplicationId

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

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

-ApplicationName

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

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

-Comment

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

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

-Confirm

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

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

-DeploymentTypeName

为此显示名称指定一个策略。

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

-DetectionClauseConnector

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

以下示例定义 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

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

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

-EstimatedRuntimeMins

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

Type:	Int32
Aliases:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

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

-ForceScriptDetection32Bit

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

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

-ForceWildcardHandling

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

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

-GroupDetectionClauses

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

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

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

提示

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

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

-InputObject

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

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

-InstallationBehaviorType

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

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

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

-InstallTaskSequenceId

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

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

-LogonRequirementType

指定登录用户的要求：

• OnlyWhenNoUserLoggedOn：仅在用户未登录Windows。

• OnlyWhenUserLoggedOn：仅在用户登录时。 此选项为默认选项。

• WhetherOrNotUserLoggedOn：用户是否已登录。

  备注

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

如果将 InstallationBehaviorType 设置为 InstallForUser ，则不能设置此参数。

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

-MaximumRuntimeMins

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

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

-ProductCode

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

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

-RebootBehavior

指定安装后的行为：

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

• NoAction：无特定操作。

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

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

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

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

-RemoveLanguage

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

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

-RemoveRequirement

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

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

-RequireUserInteraction

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

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

-ScriptFile

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

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

-ScriptLanguage

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

Type:	ScriptLanguage
Aliases:	ScriptType
Accepted values:	PowerShell, VBScript, JavaScript
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptText

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

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

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

-SlowNetworkDeploymentMode

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

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

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

-UninstallTaskSequenceId

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

Type:	String
Aliases:	UninstallId, UninstallTaskSequencePackageId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserInteractionMode

指定安装程序可见性：

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

Type:	UserInteractionMode
Aliases:	InstallationProgramVisibility
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

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