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 сервера.