Set-CMDeploymentTypeReturnCode
修改指定應用程式部署類型的傳回碼。
語法
Set-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-NewName <String>]
[-Description <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
從 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
針對您預期來自此部署類型的傳回碼指定整數值。 這個值是和之間的 -2147483648 任何正數或負整數 2147483647。
| 類型: | 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 類別。