Set-CMDeploymentTypeReturnCode

  • Referencia
Módulo:
ConfigurationManager

Modifique los códigos de retorno para el tipo de implementación de aplicación especificado.

Syntax

Set-CMDeploymentTypeReturnCode
   -InputObject <IResultObject>
   -ReturnCode <Int32>
   [-CodeType <ExitCodeClass>]
   [-NewName <String>]
   [-Description <String>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A partir de la versión 2107, use este cmdlet para modificar los códigos de retorno del tipo de implementación de aplicación especificado. Para obtener más información general, vea Códigos de retorno de tipo de implementación.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Modificación del comportamiento del código devuelto 3010

En este ejemplo se modifica el comportamiento del código devuelto predeterminado 3010 , que es el tipo de reinicio temporal de forma predeterminada. Lo configura como un reinicio duro y cambia el nombre y la descripción.

$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"

Parámetros

-CodeType

Especifique el tipo de código devuelto. Esta configuración define cómo interpreta Configuration Manager el código devuelto especificado de este tipo de implementación. Los tipos disponibles varían en función de la tecnología de tipo de implementación.

  • Failure: no se pudo instalar el tipo de implementación.

  • Success: el tipo de implementación se instaló correctamente y no es necesario reiniciar.

  • FastRetry: ya hay otra instalación en curso en el dispositivo. El cliente reintenta cada dos horas, un total de 10 veces.

  • HardReboot: el tipo de implementación se instaló correctamente, pero requiere que el dispositivo se reinicie. No se puede instalar nada más hasta que se reinicie el dispositivo.

  • SoftReboot: el tipo de implementación se instaló correctamente, pero solicita que se reinicie el dispositivo. Pueden producirse otras instalaciones antes de que se reinicie el dispositivo.

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

Solicitará confirmación antes de ejecutar el cmdlet.

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

-Description

Especifique una descripción opcional para ayudarle a identificar y describir este código devuelto.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-InputObject

Especifique un objeto de tipo de implementación en el que modificar el código devuelto. Para obtener este objeto, use el cmdlet Get-CMDeploymentType .

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

-NewName

Especifique un nuevo nombre para describir este código devuelto.

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

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

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

-ReturnCode

Especifique un valor entero para el código devuelto que espera de este tipo de implementación. Este valor es cualquier entero positivo o negativo entre -2147483648 y 2147483647.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Application clase WMI de servidor.