.png?sv=2022-11-02&spr=https&st=2024-07-27T07%3A06%3A02Z&se=2024-07-27T07%3A16%3A02Z&sr=c&sp=r&sig=pgdB4C6ULeDAZrYOl8rDZofwkQDk3kMqJSeuotQcXMk%3D){kind=logo}
Absolute - Run Script
- 16 Mar 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
Absolute - Run Script
- Updated on 16 Mar 2023
- 3 Minutes to read
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Absolute - Run Script runs an Absolute script on each device that is the result of the saved query supplied as a trigger (or users selected in the asset table).
See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.
General Settings
- Enforcement Set name (required) - The name of the Enforcement Set. A default value is added by Axonius. You can change the name according to your needs.
- Add description - Click to add a description of the Enforcement Set. It is recommended to describe what the Enforcement Set does.
- Run action on assets matching following query (required) - Select an asset category and a query. The Enforcement Action will be run on the assets that match the query parameters.
- A query only returns results for the asset type it was created for.
- Not all asset categories are supported for all Enforcement Actions.
- See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.
- See Actions supported for Vulnerabilities.
- See Actions supported for Software.
- Action name (required) - The name of the Main action. A default value is added by Axonius. You can change the name according to your needs.
- Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.
Connection Settings
- Use stored credentials from the Absolute adapter (required, default: False) - Select this option to use the first connected Absolute adapter credentials.NOTE
- To use this option, you must successfully configure a Absolute adapter connection.
- The user name and the password used for the adapter connection must have the required permissions to run scripts.
- Title (optional) - The user-defined title of the run-script request.
- Script UID (required) - The system-defined unique identifier for the script.
- Max run time (optional) - The maximum length of time a script is allowed to run on a device.
- Max run time unit (optional) - The unit of time used for Max run time.
- Display mode (optional) - The visibility of the Windows PowerShell dialog when the script runs on a device.
- Run privilideges (optional) - The permissions used to run the script.
- Run when (optional, default: UserIsOrIsNotSigedIn) - The run condition that determines when the script is allowed to run, according to the sign-in status of the user. Valid conditions include:
- UserIsOrIsNotSigedIn (default) - The script runs regardless of whether a user is logged in or not.
- UserIsSignedIn - The script runs only when a user is logged in.
- NoUserIsSignedIn - The script runs only when no user is logged in.
- Command line (optional) - The PowerShell command line parameters used to execute the script.
- Startup dir (optional) - The directory location used by the agent to download and run scripts on the device.
- Absolute Domain (optional) - Your Absolute domain. The Absolute API access is limited to two regions:
- Canadian Data Center (CADC) - https://api.absolute.com
- US Data Center (USDC) - https://api.us.absolute.com
- Always run 32 bits - Run 32-bit version: Version of PowerShell used on 64-bit Windows devices.
- Mac script option (optional) - The configurations used to execute the Bash script on Mac devices.
- Windows script option (optional) - The configurations used to execute the PowerShell script on Windows devices.
- Data center (optional) - Specify the regional data center (must be in lowercase):
- uscd - For the US Data Center.
- cadc - For the Canadian Data Center.
- Token ID and Client Secret (required) - The Absolute API requires an authentication token which consists of two parts: token ID and secret key. These are generated from the Absolute console, using a custom user role, defined by your organization, or the Guest user role.
For more details about creating a Token ID and a Secret Key, see Working with Absolute APIs.NoteThe System Administrator of your Absolute console can assign the role. - Verify SSL (required) - Verify the SSL certificate offered by the value supplied in Absolute Domain that is defined in the Active Directory adapter. For more details, see SSL Trust & CA Settings.
- If enabled, the SSL certificate offered by the value supplied in Absolute Domain is verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
- If disabled, the SSL certificate offered by the value supplied in Absolute Domain is not verified against the CA database inside of Axonius.
For more details about other Enforcement Actions available, see Action Library.
Was this article helpful?