- 24 Feb 2022
- 7 Minutes to read
-
Print
-
DarkLight
-
PDF
Device Actions
- Updated on 24 Feb 2022
- 7 Minutes to read
-
Print
-
DarkLight
-
PDF
After creating queries and investigating devices and their adherence to policies, you can perform actions on a single selected device or in bulk on selected devices:
- On the Devices page, select one or multiple device checkboxes. When at least one device is selected, the Actions button is displayed above the query results table.
- To perform an action, click Actions and then click the desired action.
Axonius supports the following device actions:
Tag
Use tags to assign context to your assets for granular filters and queries. Apply new or existing tags to the selected devices. The list of selected tags is applied to all selected devices. Hence, tagging may result in the removal of existing tags from one or from several of the selected devices.
- Partial tag indicator is displayed when some but not all of the selected devices are tagged.
- New, checked, partial and unchecked tags are sorted and displayed in different sections. Displayed from top to bottom are: newly created tags, checked tags, partial tags, and unchecked tags.
- "New" is displayed when you add new tags.
Adding Tags to Devices
- Select one or more devices; the Action menu is enabled.
- From the Actions menu choose Tag; the Tag Devices dialog opens.
- Either select an existing tag, or add a new tag.
- To add a new tag, enter the tag name and select Add New.
- Choose Save.
The new tag name is displayed, with a label New next to it.
You can also add an automatic expiration date for the tags. Learn more about Setting Automatic Expiration Dates for Tags.
Setting an Automatic Expiration Date for Tags
You can set an automatic expiration date for a tag or a group of tags. In this way you can add a tag to an asset for a defined period of time; once the defined time ends, the tag is automatically removed. This can be useful for instance, if you have a system that cannot be patched for a specific period of time. You can create a saved query that will exclude this specific tag. As a result, tagged assets will not be included in reports and dashboards using that saved query for the set time, until the tag expires.
- Select one or more devices.
- From the actions menu choose Tag; Tag Devices opens.
- Choose an existing tag name, or click Add New to create a new one.
- Click Add Expiration Date, a context menu opens.
- Select Specific Date, or Days From Now
Setting a Specific Date
- A date picker opens
- Choose a date.
Expires on
-
Choose Save.
Setting Days From Now -
Select Days From Now; the date calculator opens.
-
Select the number of days from now for the tag to expire. The date below changes accordingly.
-
Choose Save.
Deleting an Expiration Date
You can delete an expiration date.
- Select one or more devices.
- From the actions menu choose Tag.
- Choose Delete Expiration Date.
Changing an Expiration Date
You can change an expiration date
- Select one or more devices
- From the actions menu choose Tag.
- Choose Edit Expiration Date.
- The date menu opens. Set a new date as required.
If you choose a number of devices which have different tags with different expiration dates you can't delete or edit the dates.
Viewing Information About Tags
Add columns to display information about Tags to the Devices page.
- Auto-Expiring Tags - complex field with all auto expiring tag names and their expiration date.
- Auto-Expiring Tags: Name - the names of the auto-expiring tags
- Auto-Expiring Tags: Expiration Date - the expiration dates of the auto-expiring tags.
The Devices page then shows the list of tags that you have on your system, and information about expiration dates. A device may have more than one tag when each tag has a different expiration date.
Mouse over the Auto-Expiring Tags column to see when each tag on a device expires.
View more information about tags on your system on the Device Profile Page.
Clearing Tags from Devices
You can clear or delete tags from devices.
To delete tags from devices
-
Select one or more devices.
-
From the Actions menu choose Tag; Tag Devices opens.
-
The tags on the device are shown as selected.
-
Clear the checkbox and choose Save. The tags are now removed from the selected devices
Delete
Delete selected devices from Axonius. Deleted devices may be added again to Axonius if they are discovered in any future discovery cycle.
Link Devices
Manually correlate at least two device records and consolidate their details into a single device.
Manual linkage cannot be reverted. It will not be overridden by the next correlation.
Unlink Devices
Unlink and break the different device adapter sources into several separate devices, with each individual entry referring to data received from a single adapter. For example, if a device has been correlated from three different adapters, unlinking that device will result in three different unlinked devices.
Any manually unlinked devices may be relinked the next time the Axonius has correlated devices as part of a discovery cycle or data fetch from a specific adapter connection, if the correlation logic determines to do so.
Enforce - Create New Enforcement
Create a new enforcement set from the Devices page with a Main Action that will run on the entities you selected ('custom selection').
When you select this option, a drawer is opened that lets you configure the following:
- Enforcement set name.
- Main Action - Select an action from the Action Library, to be performed when the enforcement set is executed.
Once configured, click Save and Run to save the enforcement set and to generate an enforcement task that will run on the entities you have selected ('custom selection').
For more details, see Creating New Enforcement Sets.
Enforce - Use Existing Enforcement
Select and run one of the enforcement sets that is already configured in the system.
For more details, see Enforcement Center Page
Filter out from query results
Filter out the selected devices from the query results. Once filtered out, the Query Wizard will add a new Filtered out from query result line. Click Clear to restore the filtered out devices.
Add Custom Field
You can add custom fields to one or more devices.
-
Click Add custom fields, the Add Custom Fields dialog opens.
-
Click in the field drop down box. You can either define a new custom field or set a custom value for a predefined field for the selected devices.
To Add a Custom Field to the System
-
Start typing in the Field box, if a field of that name already exists it will be displayed, otherwise set a name for the field, and then click Add Field.
-
Select a Type for the field, you can choose Boolean, Float, Integer, List (String), List (Float), List (INT*)* or String.
-
Set a value in the Value field. The value is determined by the Type.
-
When you choose one of the list types, you can enter a list in the value field. Each item in the list is separated by a comma, a semi-colon or by clicking enter. You can also paste a comma separated list into the field.
-
Once you add a list of values, you can click on the x to remove it, or click on a value to edit it.
- Click Add Field to add your new field to the device or devices that are selected.
Custom fields are marked with a user icon in the list of fields.
- Continue adding fields as required.
Use the delete icon to remove custom fields.
Assigning a Custom Value to a Field
To assign a custom value to a predefined field in the system:
- From the Field drop down box, choose a field. The type is pre-set (determined by the field itself).
- From the Value drop-down box, assign a value, and click Add Field. You can also add lists of values, make sure the values are separated by commas.
Editing Fields
To edit a value in the Add Custom Fields:
- Click in the Value field, and type the new value.
- When you have finished adding or editing custom fields, click Save.
Managing and Viewing Custom Fields
-
The custom fields that you added now appear in the list of fields in the Query Wizard and on the Custom Data tab in the Adapter Connections tab on the Device Profile page.
-
You can manage custom fields that you added to the system from the Device Profile page.