Quest KACE Endpoint Systems Management Appliances - Run Script
- 16 Mar 2023
- 3 Minutes to read
-
Print
-
DarkLight
-
PDF
Quest KACE Endpoint Systems Management Appliances - Run Script
- Updated on 16 Mar 2023
- 3 Minutes to read
-
Print
-
DarkLight
-
PDF
Quest KACE Endpoint Systems Management Appliances - Run Script runs a KACE script on each of the assets that are the result of the saved query supplied as a trigger (or devices 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 Axonious. You can change the name according to your needs.
- Add description (optional) - 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 and Adapter Fetch History Modules
- Action name - The name of the Main action. A default value is added by Axonious. You can change the name according to your needs.
- Configure Action Conditions - Toggle on to enter a condition statement. See Configuring Enforcement Action Conditions to learn more about condition statement syntax.
Connection Settings
- Use stored credentials from the Quest KACE adapter (required, default: False) - Select this option to use the first connected Quest KACE adapter credentials.
NOTE
- To use this option, you must successfully configure a Quest KACE adapter connection.
- The user name and the password used for the adapter connection must have the Required Permissions to fetch assets.
- KACE SMA Domain (required) - The hostname of the KACE Systems Management Appliance (SMA) server.
- User Name and Password (required) - The user name and password for an account that has permissions to run scripts on machines.
- Organization Name (optional, default: empty) - The organization name. If the KACE Systems Management Appliance (SMA) appliance is configured for multiple organizations, The connection is limited to a single specified organization for the requesting user.
- If supplied, Axonius will use the specified organization name when connecting to the host defined for this connection and authenticating the API request.
- If not supplied, Axonius will use "Default" organization name connecting to the host defined for this connection and authenticating the API request.
- Verify SSL (required, default: False) - Verify the SSL certificate offered by the host supplied in KACE SMA Domain. For more details, see SSL Trust & CA Settings.
- If enabled, the SSL certificate offered by the host will be verified against the CA database inside of Axonius. If it fails validation, the connection will fail with an error.
- If disabled, the SSL certificate offered by the host will not be verified against the CA database inside of Axonius.
- HTTPS proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in KACE SMA Domain.
- If supplied, Axonius will utilize the proxy when connecting to the value supplied in KACE SMA Domain.
- If not supplied, Axonius will connect directly to the value supplied in KACE SMA Domain.
- HTTPS proxy user name (optional, default: empty) - The user name to use when connecting to the value supplied in KACE SMA Domain via the value supplied in HTTPS proxy.
- If supplied, Axonius will authenticate with this value when connecting to the value supplied in HTTPS proxy.
- If not supplied, Axonius will not perform authentication when connecting to the value supplied in HTTPS proxy.
- HTTPS proxy password (optional, default: empty) - The password to use when connecting to the value supplied in KACE SMA Domain via the value supplied in HTTPS proxy.
- If supplied, Axonius will authenticate with this value when connecting to the value supplied in HTTPS proxy.
- If not supplied, Axonius will not perform authentication when connecting to the value supplied in HTTPS proxy.
Action Settings
- Script ID (required) - The ID of the KACE script to run.
- Identify the correct Script ID
APIs
Axonius uses the KACE Systems Management Appliance (SMA) API.
Required Ports
Axonius must be able to communicate with the value supplied in Hostname or IP Address via the following ports:
- TCP port 443
For more details about other Enforcement Actions available, see Action Library.