> ## 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.

# Create a Data Collection Schedule

> Learn how to configure a SharpHound Enterprise collector client to run data collection on a schedule.

<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 explains how to configure a data collector client to run on a schedule. Administrators should use it when deploying a new client or adding an additional schedule to an existing client.

<Note>Azure and Active Directory objects typically change slowly, so daily collection is usually sufficient. To capture activity across different times of day, schedule Local Groups and Sessions more frequently (for example, every 7 hours).</Note>

## Prerequisites

The following prerequisites are required to create a data collection schedule:

* 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 modify clients

## Process

The process to create a data collection schedule consists of the following steps:

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

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

    <Frame>
      <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/edit-client.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=f4321f86689c0a88aca363e8f0cc072a" alt="Navigate to the Edit Client button on the Clients page" width="315" height="334" data-path="images/data_collectors/edit-client.png" />
    </Frame>
  </Step>

  <Step title="Create a data collection schedule">
    1. Click <Icon icon="plus" /> under **Collection Schedule** to add a new schedule.

           <Frame>
             <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/add-schedule.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=d874b1a0540283b6783a94e620964cc6" alt="Click the plus icon to add a new collection schedule" width="640" height="577" data-path="images/data_collectors/add-schedule.png" />
           </Frame>

    2. Configure the following details in the **Schedule** window:
       * **Start Date**: The time at which the first collection should run
       * **Frequency**: The frequency at which the collection should run
       * **Data**: The [type of data](/collect-data/permissions) that the schedule collects
       * **Advanced Options**:

             <Frame>
               <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/configure-schedule.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=b4d14596bf11343214875831dc6c45ea" alt="Configure the schedule details" width="704" height="744" data-path="images/data_collectors/configure-schedule.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.* |

    3. Click **Save** in the **Schedule** window.

    4. Click **Save** in the **Edit SharpHound Client** window.
  </Step>
</Steps>

## Outcome

The client is now configured for continuous data collection with one schedule. You can add multiple schedules to a single client for more granular control.

A summary of a client's schedule displays in the *Collection Schedule* column on the **Clients** page.

<Frame>
  <img src="https://mintcdn.com/specterops/g2ltNIVwNN2AtKcq/images/data_collectors/client-schedule-summary.png?fit=max&auto=format&n=g2ltNIVwNN2AtKcq&q=85&s=c5e1bb4dfd83cb9917a2362e2d4e604e" alt="View of the Collection Schedule column on the Clients page" width="1113" height="266" data-path="images/data_collectors/client-schedule-summary.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>
