Set-CMDeploymentTypeReturnCode

  • 参考
模块:
ConfigurationManager

修改指定应用程序部署类型的返回代码。

语法

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：部署类型已成功安装，但请求设备重启。 在设备重启之前，可能会进行其他安装。

Type:ExitCodeClass
Accepted values:Failure, Success, FastRetry, HardReboot, SoftReboot
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-Description

指定可选说明以帮助识别和描述此返回代码。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InputObject

指定要修改其返回代码的部署类型对象。 若要获取此对象，请使用 Get-CMDeploymentType cmdlet。

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

-NewName

指定新名称来描述此返回代码。

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

-PassThru

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

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

-ReturnCode

为此部署类型所期望的返回代码指定一个整数值。 此值是 和 2147483647之间的-2147483648任意正整数或负整数。

Type:Int32
Aliases:ReturnCodeValue
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_Application服务器 WMI 类。