Skip to content
DeviceQuest DeviceQuest DeviceQuest Docs User Documentation

Documentation

Scan targets

Save the addresses, ranges and hosts you scan, and choose how each one is scanned.

Overview

A scan target is a saved address that schedules scan: an IP address, a CIDR range, a hostname or an FQDN, together with the scan type used for it. Use the Targets tab of Scanning to add targets, see which schedules use them and when they were last scanned.

Screen tour

  1. Search targets…: filters by address or name.
  2. Type: shows All types, or only IP Range, Hostname or FQDN targets.
  3. Status: shows All statuses, or only Active targets.
  4. Address: the IP address, CIDR range, hostname or FQDN. Click the Address or Type header to sort.
  5. Schedules: how many schedules reference this target, or None.
  6. Edit and Delete: change or remove the target.
  7. Last scan: when the most recent scan of the target finished.

The Last scan column shows when the most recent scan of the target finished, for example 10/13/2026, 2:00:41 AM UTC. A red Failed badge appears under the time when that scan failed. Never scanned means the target is waiting for its first scan to finish. The column reflects scans that completed or failed.

Create a target

  1. Type: how the address is written: IP Range, Hostname or FQDN.
  2. Address: the address to scan.
  3. Scan type: how the target is scanned, here Proxmox (hypervisor) for a Proxmox VE node.
  4. Port range (optional): the TCP ports to probe on this target.
  1. On the Targets tab, click New Target.
  2. Choose the Type. Choosing IP Range sets the scan type to Sweep. Choosing Hostname or FQDN sets it to SSH. You can change it afterwards.
  3. Enter the Address, for example 10.20.0.0/24, 10.20.0.15, db01 or db01.example.com.
  4. Choose the Scan type.
  5. Optionally, enter a Port range, for example 22,80,443 or 1-1024.
  6. Click Create target.

New targets are Active.

Target types

TypeAddress formatExample
IP RangeA single IPv4 address, or a CIDR range10.20.0.15, 10.20.0.0/24
HostnameA single machine name: letters, digits and hyphensdb01
FQDNA fully qualified domain namedb01.example.com

Scan types

Scan typeUse it forCredential type
SweepDiscovering which hosts are alive in a rangeNone (optional SSH, WMI or SNMP credential for the follow-up)
SSHLinux, Unix and BSD servers, and Proxmox hostsSSH
WMIWindows servers and workstations, including Hyper-V hostsWMI
SNMPSwitches, routers, firewalls, printers and other network devicesSNMP
VMware vSpherevCenter Server or a standalone ESXi hostVMware
Proxmox (hypervisor)A Proxmox VE node or clusterProxmox

For what each scan type collects and which ports it uses, see Scan types.

CIDR ranges always use Sweep

A CIDR range such as 10.20.0.0/24 covers many hosts, so it must use the Sweep scan type. A sweep finds the live hosts, and DeviceQuest then launches an authenticated follow-up scan of each host that has a matching credential. Use a single address, hostname or FQDN for SSH, WMI, SNMP, VMware and Proxmox targets.

If you combine a CIDR range with another scan type, the modal shows CIDR ranges require a Sweep scan. Use a single host address for SSH, WMI, SNMP, or VMware.

Port range

The Port range lists the TCP ports to probe on the target, as comma-separated ports and inclusive ranges: 22,80,443, 1-1024 or 22,80,443,8000-8100. Leave it empty to use the scanner’s defaults. To reuse the same port list on many schedules, put it in a scan profile instead (the ports key of a Sweep profile). See Scan profiles.

Edit a target

  1. Click Edit on the target’s row.
  2. Change the Type, Address, Scan type or Port range. For a target whose scan type is outside the list, the Scan type shows Keep current, which keeps it.
  3. Click Save changes.

Schedules that use the target pick up the change from their next run.

Delete a target

  1. Click Delete on the target’s row.
  2. In the Delete target dialog, click Delete target.

Schedules that reference the target need a new target before they can run again. Their Run now shows This schedule no longer has an active saved target. Reassign before running.

Fields

FieldDescriptionRules
TypeHow the address is written.IP Range (default), Hostname or FQDN.
AddressThe address to scan.Required. Must match the type: Enter a valid IP address or CIDR (e.g. 10.0.0.0/24)., Enter a valid hostname (letters, digits, hyphens). or Enter a valid FQDN (e.g. host.example.com).
Scan typeHow the target is scanned.A CIDR range requires Sweep.
Port range (optional)TCP ports to probe.Comma-separated ports or ranges, otherwise Enter valid port(s) or range(s) (e.g. 22,80,443 or 1-1024).

Statuses

StatusMeaningNext possible status
ActiveThe target can be used by schedules and Run now.Inactive
InactiveThe target is kept, and its schedules wait until the target is active again.Active