Add-CMDeploymentTypeReturnCode
将返回代码添加到受支持的应用程序部署类型。
语法
Add-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-Name <String>]
[-Description <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 说明
从版本 2107 开始，使用此 cmdlet 将返回代码添加到受支持的应用程序部署类型。 有关更多常规信息，请参阅 部署类型返回代码。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。
示例
示例 1：将返回代码 1602 添加到 MSI 部署类型
此示例将返回 1602 代码添加到指定的应用程序部署类型。
$appName = "CenterApp"
$dtName = "InterDept - Windows Installer (.msi file)"
$msi_dt = Get-CMDeploymentType -ApplicationName $appName -DeploymentTypeName $dtName
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"参数
-CodeType
指定返回代码的类型。 此设置定义 Configuration Manager 如何解释此部署类型的指定返回代码。 可用类型因部署类型技术而异。
Failure：部署类型安装失败。Success：已成功安装部署类型，无需重新启动。FastRetry：其他安装已在设备上进行。 客户端每两小时重试一次，总共 10 次。HardReboot：已成功安装部署类型，但需要重新启动设备。 在设备重新启动之前，无法安装任何其他内容。SoftReboot：已成功安装部署类型，但请求重新启动设备。 在设备重新启动之前，可能会发生其他安装。
| Type: | ExitCodeClass |
| Accepted values: | Failure, Success, FastRetry, HardReboot, SoftReboot |
| 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 |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
| Type: | SwitchParameter |
| 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 |
-InputObject
指定要添加返回代码的部署类型对象。 若要获取此对象，请使用 Get-CMDeploymentType cmdlet。
| Type: | IResultObject |
| Aliases: | DeploymentType |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReturnCode
为此部署类型预期返回代码指定整数值。 此值是 和 之间的任意正整数或负 -2147483648 整数 2147483647 。
| Type: | Int32 |
| Aliases: | ReturnCodeValue |
| 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 |
-名称
指定描述此返回代码的可选名称。
| Type: | String |
| Aliases: | ReturnCodeName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-描述
指定可选的说明以帮助您标识和描述此返回代码。
| Type: | String |
| Aliases: | ReturnCodeDescription |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject
备注
有关此返回对象及其属性的信息，请参阅 SMS_Application 服务器 WMI 类。