Ajustes de Distribución
En Distribución > Ajustes configure las asignaciones de códigos de retorno de las aplicaciones. Las acciones de paquetes ejecutables y scripts pueden devolver un código numérico positivo o negativo al salir, indicando varios resultados. Estos códigos de retorno afectan al estado de la aplicación y determinan si una acción tiene éxito, falla o requiere un reinicio.
Utilice asignaciones de código de retorno personalizadas para personalizar el resultado de las acciones EXE, MSI y script. Por ejemplo, la utilidad Robocopy de Microsoft tiene varios códigos de retorno que indican éxito. Por defecto, un código de retorno ejecutable distinto de cero indica un fallo. Puede crear una asignación personalizada de códigos de retorno para Robocopy que asigne estos códigos de retorno distintos de cero a éxito, y así permitir que continúe el procesamiento del paquete.
Los códigos de retorno se almacenan en un archivo de registro del dispositivo como parte de cada distribución. Para obtener más información sobre registros y cómo acceder a ellos, consulte Registro de reglas y acciones de detección.
Además de tener códigos de retorno numéricos almacenados en el registro, puede asignar esos códigos de retorno a cadenas informativas. Estas cadenas que describen los códigos de retorno también aparecerán en el registro.
Existen tres tipos de plantillas de código de retorno:
- Nuevas plantillas creadas por usted.
- Copias clonadas de una plantilla existente. Para clonar una plantilla existente, utilice el menú de opciones (
) situado a la derecha de dicha plantilla.
- Plantillas predeterminadas que no puede editar ni eliminar, salvo marcar una como plantilla predeterminada. Puede editar una copia clonada.
Estas son las plantillas de código de retorno por defecto. El comportamiento por defecto para códigos de retorno no asignados en estas plantillas es error+.
- Plantilla del sistema: MSI por defecto: contiene el conjunto estandarizado de códigos de retorno MSI. Están preconfigurados para usted.
- Plantilla del sistema: EXE predeterminado: contiene una asignación de código de retorno para el número cero, que indica éxito.
- Plantilla del sistema: PowerShell predeterminado: contiene dos asignaciones de códigos de retorno. El número cero indica éxito, y el número uno, fracaso.
Se puede marcar como predeterminada una de cada tipo de plantilla, MSI, EXE y PowerShell. La lista Asignaciones de código de retorno tiene una columna que muestra qué plantillas son las predeterminadas. Para cambiar un valor predeterminado, edite la plantilla y seleccione esa opción.
Cuando se crea una acción de paquete que admita una plantilla de código de retorno, se preselecciona la plantilla predeterminada por usted. Si no desea utilizar la predeterminada, puede seleccionar otras plantillas para ese tipo de acción. Los cambios realizados en la plantilla se aplicarán la próxima vez que el motor de distribución se ejecute en el cliente.
Las plantillas de código de retorno MSI incluyen una asignación de código de retorno para 3010, Éxito: requiere reinicio. Este resultado es el mismo que Éxito, pero con una nota en el registro del dispositivo para esa distribución de que necesitará un reinicio en algún momento. El estado de despliegue también mostrará "Éxito (requiere reinicio)" para ese paquete.
Para crear o editar una plantilla de código de devolución
- Seleccione Crear nuevo y el tipo de plantilla que desee, o seleccione una plantilla existente. Las plantillas de sistema preconfiguradas son de solo lectura.
- Introduzca un Nombre de plantilla y una Descripción.
- En Hacer que esta sea la plantilla predeterminada, seleccione Verdadero si desea que esta plantilla sea la predeterminada para el tipo de plantilla que ha seleccionado (como EXE o PowerShell).
- Seleccione la opción Resultado por defecto para códigos de retorno no asignados. El valor predeterminado es Error. El resultado que seleccione es el que se producirá para cualquier código de retorno procedente de la acción que no figure en la lista de códigos de retorno. Por ejemplo, si elige Fallo (recomendado), todos los códigos de retorno que no estén en la lista harán que la acción se devuelva como fallida. Si elige Correcto, todos los demás códigos de retorno se devolverán como correctos.
- Especifique el texto del Mensaje por defecto que aparece para el resultado de código de retorno no asignado por defecto seleccionado.
- Seleccione + Agregar código de devolución.
- Introduzca el número o rango de números del Código de retorno en formato entero (sin decimales), Resultado (Fallo o Éxito) y el texto del Mensaje que desee registrar junto con el código de retorno. Para introducir un intervalo de números, separe los números con dos puntos, como 15.30.
- Seleccione Guardar.
- Repita los pasos 7 y 8 para cada código de devolución que desee.
- Cuando haya terminado, cierre el panel Agregar nueva asignación y seleccione Guardar.
