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