> ## Documentation Index
> Fetch the complete documentation index at: https://specterops-feat-poc-api-playground.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Run an On Demand Scan

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

## Purpose

This article outlines how to run an On Demand Scan to perform a one-time immediate data collection with a collector client. BHE administrators may use it during collector client deployment, one-time collections, or troubleshooting.

## Prerequisites

* Creation of one SharpHound Enterprise client, see [Create a SharpHound Enterprise collector client](/collect-data/enterprise-collection/create-collector)
* Logged in as a user role which is authorized to run an On Demand Scan, see [User Role Definitions](/manage-bloodhound/auth/users-and-roles)

## Process

1. In the top right, click settings ⚙️ → **Administration**

<Frame>
  <img src="https://mintcdn.com/specterops-feat-poc-api-playground/ZAFvW39LrOK-TX1k/assets/image-63.png?fit=max&auto=format&n=ZAFvW39LrOK-TX1k&q=85&s=af6e09b2ac39d45156c27a4190fd199d" alt="" width="246" height="301" data-path="assets/image-63.png" />
</Frame>

2. In the top left side, click **Manage Clients**

<Frame>
  <img src="https://mintcdn.com/specterops-feat-poc-api-playground/ZAFvW39LrOK-TX1k/assets/image-64.png?fit=max&auto=format&n=ZAFvW39LrOK-TX1k&q=85&s=86f48576cded484c35a909061e0ac657" alt="" width="323" height="317" data-path="assets/image-64.png" />
</Frame>

3. On the client, click the burger menu and select **On Demand Scan**
   * Tip: Verify the client is online by validating **Status** is **Ready**

<Frame>
  <img src="https://mintcdn.com/specterops-feat-poc-api-playground/ZAFvW39LrOK-TX1k/assets/image-65.png?fit=max&auto=format&n=ZAFvW39LrOK-TX1k&q=85&s=2f6fbb8029f52355fb9444901e871d74" alt="" width="1242" height="384" data-path="assets/image-65.png" />
</Frame>

4. In the *On Demand Scan* window, configure the scan:
   1. **Data**: The type of data the schedule collects, see [SharpHound Data Collection and Permissions](/collect-data/permissions)
   2. **Advanced Options**: See the [Scanning section in the article SharpHound Enterprise Tenant Configuration](/install-data-collector/install-sharphound/tenant-configuration)

<Frame>
  <img src="https://mintcdn.com/specterops-feat-poc-api-playground/ZAFvW39LrOK-TX1k/assets/image-66.png?fit=max&auto=format&n=ZAFvW39LrOK-TX1k&q=85&s=a23e76395fae1bb358a7feef0e9e02a5" alt="" width="581" height="516" data-path="assets/image-66.png" />
</Frame>

5. Start the scan by clicking **Run**

## Outcome

The client will start the On Demand Scan after the next client check-in, usually within one minute.

Once started, the client's **Status** will show **Running a Job**:

<Frame>
  <img src="https://mintcdn.com/specterops-feat-poc-api-playground/ZAFvW39LrOK-TX1k/assets/image-67.png?fit=max&auto=format&n=ZAFvW39LrOK-TX1k&q=85&s=33bae1a9442eca41d1b08e757c46df0a" alt="" width="1238" height="276" data-path="assets/image-67.png" />
</Frame>

After completion, see the job's status in the *Finished Jobs Log* by clicking ⚙️ → **Administration**, and in the top left side, click **Finished Jobs** **Log**\_. \_The columns **Status** and **Status Message** report on the job's completion.

<Frame>
  <img src="https://mintcdn.com/specterops-feat-poc-api-playground/ZAFvW39LrOK-TX1k/assets/image-68.png?fit=max&auto=format&n=ZAFvW39LrOK-TX1k&q=85&s=c82b7a2a2b16eb2378d870fb946d318f" alt="" width="1267" height="319" data-path="assets/image-68.png" />
</Frame>
