Automox Return Codes
When running policies in Automox, return codes indicate whether the execution was successful or failed. Understanding these codes helps identify and troubleshoot issues efficiently.
Return Codes for Patch Policies
- Success (0): A return code of 0 means the patch policy was executed successfully.
- Failure (1): A return code of 1 indicates that the policy failed to run as intended.
- Other Codes:
- Example codes include 124, 1609, and 1848. These codes originate from the software package being executed, not Automox itself.
- For assistance interpreting these codes, refer to the activity logs or contact Automox Support.
Return Codes for Worklet and Required Software Policies
- Success (0): Indicates successful execution of the worklet or software policy.
- Failure (1): Indicates the policy failed.
- Custom Return Codes:
- Worklets and required software policies can include custom exit codes.
Automox recommends scripting evaluations with an "if" statement, such as:
if [condition]; then
exit 0 # Success
else
exit 1 # Failure
fi
- Any non-zero exit code provided by the remediation script (e.g., exit 2) will cause Automox to flag the policy as failed, even if the intent was success.
Note: The only exception where a 0 might be returned but the policy still fails is if the remediation script exits with a non-zero code internally.
Where to Get Help
- Review the Activity Log in the Automox console to interpret additional error codes.
- Contact Automox Support for assistance with package-specific codes or stuck policies.