Set-CMDeploymentTypeReturnCode
Измените коды возврата для указанного типа развертывания приложения.
Синтаксис
Set-CMDeploymentTypeReturnCode
-InputObject <IResultObject>
-ReturnCode <Int32>
[-CodeType <ExitCodeClass>]
[-NewName <String>]
[-Description <String>]
[-PassThru]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Начиная с версии 2107, используйте этот командлет для изменения кодов возврата для указанного типа развертывания приложения. Дополнительные общие сведения см. в разделе Коды возврата типа развертывания.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например 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 |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Description
Укажите необязательное описание, чтобы определить и описать этот код возврата.
| Тип: | String |
| Aliases: | ReturnCodeDescription |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputObject
Укажите объект типа развертывания, для которого необходимо изменить код возврата. Чтобы получить этот объект, используйте командлет Get-CMDeploymentType .
| Тип: | IResultObject |
| Aliases: | DeploymentType |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-NewName
Укажите новое имя для описания этого кода возврата.
| Тип: | String |
| Aliases: | ReturnCodeName |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ReturnCode
Укажите целочисленное значение для кода возврата, ожидаемого для этого типа развертывания. Это значение представляет собой любое положительное или отрицательное целое число между -2147483648 и 2147483647.
| Тип: | Int32 |
| Aliases: | ReturnCodeValue |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в разделе SMS_Application класс WMI сервера.