> ## Documentation Index
> Fetch the complete documentation index at: https://bloodhound.specterops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Run an On Demand Scan

> Learn how to run an on demand scan with a collector client in BloodHound Enterprise.

<img noZoom src="https://mintcdn.com/specterops/tTIczgde9H07oLXf/assets/enterprise-edition-pill-tag.svg?fit=max&auto=format&n=tTIczgde9H07oLXf&q=85&s=b682a26b342bde12302ec829e265bdb6" alt="Applies to BloodHound Enterprise only" width="225" height="45" data-path="assets/enterprise-edition-pill-tag.svg" />

## Purpose

This article describes how to run an unscheduled scan to perform a one-time, immediate data collection with a collector client. Administrators may use it during collector client deployment, one-time collections, or troubleshooting.

## Prerequisites

The following prerequisites are required to run an on demand scan:

* An existing SharpHound Enterprise [collector client](/collect-data/enterprise-collection/create-collector)
* Logged in as a user assigned a [role](/manage-bloodhound/auth/users-and-roles) authorized to run a collector client on demand scan

## Process

The process to run an on demand scan consists of the following steps:

<Steps>
  <Step title="Open the Manage Clients page">
    In the left menu, click **Administration** > **Manage Clients**.
  </Step>

  <Step title="Choose a collector client">
    On the client that you want to schedule, click the <Icon icon="bars" /> icon in the *Action* column and select **On Demand Scan**.

    <Tip>Verify the client is online by validating **Status** is **Ready**</Tip>

    <Frame>
      <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/run-on-demand-scan.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=af70d3c986c35b3d6fbe7e831b8649cc" alt="A collector client with the Action menu open and On Demand Scan selected" width="1242" height="384" data-path="images/data_collectors/run-on-demand-scan.png" />
    </Frame>
  </Step>

  <Step title="Configure the scan">
    Configure the following details in the **On Demand Scan** window:

    * **Data**: The [type of data](/collect-data/permissions) that the scan collects, see:
      * [SharpHound Data and Permissions](/collect-data/sharphound-data-permissions)
      * [AzureHound Data and Permissions](/collect-data/azurehound-data-permissions)
    * **Advanced Options**:

          <Frame>
            <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/configure-on-demand-scan.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=0b64335580c546014f823bf17108c26d" alt="A collector client On Demand Scan configuration window" width="581" height="516" data-path="images/data_collectors/configure-on-demand-scan.png" />
          </Frame>

      | **Option**                                                               | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
      | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
      | Data (Required)                                                          | Multi-select option for the different types of collection available. See [SharpHound Data Collection and Permissions](/collect-data/permissions) for details on the data collected and permissions necessary for each.                                                                                                                                                                                                                                                                          |
      | Domain controller                                                        | By default, SharpHound automatically selects a Domain Controller for LDAP queries. Specifying a Domain Controller hostname or FQDN here will define the default value used for this scan or schedule.<br /><br />If not set, SharpHound will utilize the value set in the client configuration.<br /><br />We recommend not configuring a Domain Controller manually.                                                                                                                           |
      | Target Local Group and/or User Session Collection by Organizational Unit | Define one or more OUs within a domain to only collect Local Group and Session data from computers contained within the specified OUs and their descendants.<br /><br />If left empty, *SharpHound will collect from all OUs.*<br /><br />If defined, the schedule or On Demand Scan will not collect AD structure data. A dedicated schedule or On Demand Scan must therefore be created for AD structure collection.<br /><br />*Note: Not supported with multi-domain collections.*          |
      | Scope Collection to Multiple Domains                                     | Utilize trust relationships in your environment to collect data from multiple domains.<br /><br />If left empty, SharpHound will collect from the domain to which the Service Account belongs.<br /><br />SharpHound supports two options:<br /><br />\* Define a specific list of domains from which to collect data.<br />\* Collect data from all domains within the forest that the SharpHound service account belongs.<br /><br />*Note: Multi-domain collections cannot be scoped by OU.* |
  </Step>

  <Step title="Start the scan">
    Click **Run** to begin the on demand scan.
  </Step>
</Steps>

## Outcome

The client starts the on demand scan after the next client check-in (usually within one minute).

After it starts, the client status shows **Running a Job**:

<Frame>
  <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/summary-on-demand-scan.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=fec53ddf512410bf6c0538de896ffe41" alt="A collector client summary showing Running a Job status" width="1238" height="276" data-path="images/data_collectors/summary-on-demand-scan.png" />
</Frame>

<Note>After the next schedule, see the job's status on the [**Finished Jobs Log**](/collect-data/enterprise-collection/monitor#finished-jobs-log) page.</Note>
