Códigos de salida de Windows más allá de éxito/fallo: la máscara de bits de robocopy, los códigos del instalador de msiexec y $LASTEXITCODE

Qué es

robocopy agrupa varios hechos independientes de tipo sí/no en un único valor de salida; los valores documentados se combinan como bits (1 copiado, 2 extra, 4 discrepancia, 8 fallos):

Valor	Significado
0	No se copió ningún archivo; no hubo fallos ni discrepancias (el destino ya coincidía con el origen)
1	Todos los archivos se copiaron correctamente
2	En el destino existen archivos o directorios extra que no están en el origen
3	Se copiaron archivos y existen archivos extra
5	Se copiaron archivos y algunos presentaban discrepancias
6	Existen archivos extra y con discrepancias, pero no se copió nada y no hubo fallos
7	Se copiaron archivos, hubo una discrepancia y había archivos extra
8	Varios archivos no se copiaron

La regla documentada: "Any value equal to or greater than 8 indicates that there was at least one failure during the copy operation" (cualquier valor igual o superior a 8 indica que hubo al menos un fallo durante la copia). Por debajo de 8, el número es meramente informativo, no indica éxito ni fallo.

msiexec devuelve códigos de error específicos de Windows Installer, dos de los cuales son éxitos disfrazados:

Código	Nombre	Significado
0	ERROR_SUCCESS	Finalizó con normalidad
1603	ERROR_INSTALL_FAILURE	Se produjo un error grave durante la instalación
1618	ERROR_INSTALL_ALREADY_RUNNING	Ya hay otra instalación en curso
3010	ERROR_SUCCESS_REBOOT_REQUIRED	"A restart is required to complete the install. This message indicates success."
1641	ERROR_SUCCESS_REBOOT_INITIATED	"The installer has initiated a restart. This message indicates success."

$LASTEXITCODE es la vía de PowerShell para ver el código real de un programa nativo, pero su valor depende de cómo se invocó el script: si se llama directamente o con &, no cambia a menos que el script llame a exit o ejecute un comando nativo; con pwsh -File, pasa a ser 1 si hay una excepción no capturada o el valor indicado con exit, y 0 si termina con éxito; con pwsh -Command, pasa a ser 1 si el último comando dejó $? en falso y 0 en caso contrario, de modo que cualquier código nativo más específico se reduce a 1.

sc.exe no usa una tabla fija y pequeña; expone directamente el código de error de sistema de Win32, por ejemplo 1060 (ERROR_SERVICE_DOES_NOT_EXIST, "The specified service does not exist as an installed service"). Conviene buscar los códigos en la referencia de códigos de error del sistema (System Error Codes) en lugar de suponer una lista breve y enumerada.

Por qué importa

Un script que comprueba robocopy ...; if ($LASTEXITCODE -ne 0) { fail } trata de forma incoherente los casos rutinarios de "nada que copiar" (0) y "copiado correctamente" (1), y además da por fallida una ejecución de msiexec que en realidad tuvo éxito pero necesita un reinicio (3010/1641).

Cómo aplicarlo

• Con robocopy, comprueba if ($LASTEXITCODE -ge 8) { fail }, no -ne 0.
• Con msiexec, trata 0, 3010 y 1641 como éxito (programando un reinicio en los dos últimos casos); trata 1603 y 1618 como fallos reales.
• Captura $LASTEXITCODE justo después de la llamada nativa, antes de que otro comando lo sobrescriba, y ten presente qué modo de invocación (-File frente a -Command) reduce su granularidad.
• Con sc.exe, contrasta su resultado numérico con la referencia de códigos de error del sistema en lugar de usar una sentencia switch fija en el código.

Trampas

• Comparar el código de robocopy o de msiexec con un simple booleano de cero/distinto de cero en un pipeline de automatización.
• Suponer que el modo -Command conserva el código específico de un programa nativo; se reduce a 0 o 1 salvo que el comando termine con exit $LASTEXITCODE.