Set-CMDeploymentTypeReturnCode
修改指定应用程序部署类型的返回代码。
语法
Set-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-NewName <String>]
[-Description <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
从版本 2107 开始,使用此 cmdlet 修改指定应用程序部署类型的返回代码。 有关更多常规信息,请参阅 部署类型返回代码。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:修改 3010 返回代码的行为
此示例修改默认 3010
返回代码的行为,默认为 软重新启动 类型。 它将它配置为 硬重启 ,并更改名称和说明。
$appName = "CenterApp"
$dtName = "InterDept - Windows Installer (.msi file)"
$msi_dt = Get-CMDeploymentType -ApplicationName $appName -DeploymentTypeName $dtName
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"
参数
-CodeType
指定返回代码的类型。 此设置定义 Configuration Manager 如何解释此部署类型的指定返回代码。 可用类型因部署类型技术而异。
Failure
:部署类型安装失败。Success
:部署类型已成功安装,无需重启。FastRetry
:已在设备上进行另一个安装。 客户端每两小时重试一次,总共 10 次。HardReboot
:部署类型已成功安装,但需要重启设备。 在设备重启之前,无法安装任何其他内容。SoftReboot
:部署类型已成功安装,但请求设备重启。 在设备重启之前,可能会进行其他安装。
类型: | ExitCodeClass |
接受的值: | Failure, Success, FastRetry, HardReboot, SoftReboot |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
指定可选说明,以帮助识别和描述此返回代码。
类型: | String |
别名: | ReturnCodeDescription |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InputObject
指定要修改其返回代码的部署类型对象。 若要获取此对象,请使用 Get-CMDeploymentType cmdlet。
类型: | IResultObject |
别名: | DeploymentType |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-NewName
指定新名称来描述此返回代码。
类型: | String |
别名: | ReturnCodeName |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-PassThru
添加此参数可返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ReturnCode
为此部署类型预期返回代码指定一个整数值。 此值是 和 2147483647
之间的-2147483648
任意正整数或负整数。
类型: | Int32 |
别名: | ReturnCodeValue |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject
备注
有关此返回对象及其属性的详细信息,请参阅 SMS_Application服务器 WMI 类。