Set-CMTaskSequenceDeploymentType

模块:

ConfigurationManager

在应用程序上配置任务序列部署类型。

语法

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>]

说明

适用于版本 2006 及更高版本。 使用此 cmdlet 在应用程序上配置任务序列部署类型。 有关详细信息，请参阅 任务序列部署类型。

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

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

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

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

示例

示例 1：修改任务序列部署类型

此命令将部署类型的名称从 “复杂安装” 更改为 “高级安装”。 它添加了 美国英语 () (en-US) 和 中文 (简体中文) (zh-CN) 作为支持的语言。 它指定安装大约需要 14 分钟才能完成，并且仅在没有用户登录到 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

有关要求规则和检测方法的其他示例，请参阅 Set-CMScriptDeploymentType 和 Add-CMMsiDeploymentType。

参数

-AddDetectionClause

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

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

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

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

类型:	DetectionClause[]
别名:	AddDetectionClauses
Position:	Named
默认值:	None
必需:	False
接受管道输入:	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

-Application

为此部署类型指定应用程序对象。 若要获取此对象，请使用 Get-CMApplication cmdlet。

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

-ApplicationId

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

类型:	Int32
别名:	CI_ID, CIId
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 位进程的形式运行脚本。

类型:	Boolean
别名:	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-CMDeploymentType cmdlet。

类型:	IResultObject
别名:	DeploymentType
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

-NewName

指定新名称以重命名此部署类型。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

类型:	SwitchParameter
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

-RemoveDetectionClause

指定要删除的检测方法子句的数组。

类型:	String[]
别名:	RemoveDetectionClauses
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 允许用户查看部署类型安装并与之交互。

类型:	Boolean
别名:	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
必需:	False
接受管道输入:	False
接受通配符:	False

-ScriptText

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

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

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

-SlowNetworkDeploymentMode

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

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

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

-UninstallTaskSequenceId

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

类型:	String
别名:	ContentLocation, UninstallId
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

相关链接

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