1. Knowledge Base
  2. Deploy the Cloud & NAS Agent
  3. Scan Microsoft365, Dropbox, and Google Cloud Services

One-Time Scan of Cloud Drives and Email Attachments

Here, you'll learn how to run a one-time scan of your cloud storage or email attachments using the Actifile Cloud & NAS Agent.

To run a one-time scan of your cloud storage or email attachments, follow the steps below.

Note: The Actifile agent only scans email attachments, not the email body.

 

Step 1. Open your command line interface and navigate to the folder where the Actifile Cloud & NAS Agent is stored. The Actifile team provides this agent directly. If you haven’t received it yet, please contact our support.

 

Step 2. Download the configuration file for the app of your choice and ensure you have access to the files you wish to scan with at least Read permissions. This article explains how to generate the file.

 

Step 3. Let’s check what drives are available for scanning. Run the following command in your command line, replacing the placeholders with your values.

  • YOUR_CONFIG_FOLDER_PATH > the full path to the folder containing the config file you generated during step 2.

Microsoft OneDrive or SharePoint

./agent --onedrive --config YOUR_CONFIG_FOLDER_PATH\actifile_onedrive.conf

Microsoft Outlook:

./agent --outlook --config YOUR_CONFIG_FOLDER_PATH\actifile_outlook.conf

Google Drive:

./agent --google-drive --config YOUR_CONFIG_FOLDER_PATH\actifile_googledrive.conf

Gmail:

Skip this step.

Example:

image-44-1024x90

This command will output all accessible drives in JSON format. Example:

[
{
"id": "b!2NKWrQObE0CEm8pbd-T8FvdlTYy5Vz5AqLy8-TFe-lYyT-TlqqDHS5Ee1W5bqqFl",
"name": "files_for_test_mem/Documents"
},
{
"id": "b!9UsK1m6_ykGS7UYhHwZtBavIsdPCc6NFte-ZH-fiScFJSxI1RlifTa0EddOgpq1z",
"name": "Drive2/Documents"
},
.....
{
"id": "b!z7Db_DCcEU-u9CKuRWo4n0w-tk-6KnZFtYY9FRPHIxy4vFWuL3hsQoaVHU0Kr9SZ",
"name": "Communication Site2/Documents"
}
]

 

Step 4. To start the scan, execute the following commands, replacing placeholders with your values.

  • YOUR_CONFIG_FOLDER_PATH > the full path to the folder containing the config file you generated during step 2.
  • YOUR_DRIVE_ID > your drive’s “id” value from the JSON output.
  • YOUR_DEVICE_NAME > choose a meaningful name for your device (can be omitted). 
  • YOUR_CACHE_FOLDER_PATH > the path to the folder where the agent will store the cache (can be omitted).

Note:  By default, the device name is set to the user’s email address. Use the  –device-name parameter to override it to your value.

 

Microsoft OneDrive or SharePoint

./agent --onedrive --config YOUR_CONFIG_FOLDER_PATH\actifile_onedrive.conf  --drive-id='YOUR_DRIVE_ID'  --device-name=YOUR_DEVICE_NAME --cache-dir YOUR_CACHE_FOLDER_PATH

Microsoft Outlook:

./agent --outlook --config YOUR_CONFIG_FOLDER_PATH\actifile_outlook.conf  --user-id=YOUR_USER_ID --device-name=YOUR_DEVICE_NAME --cache-dir YOUR_CACHE_FOLDER_PATH

Google Drive:

./agent --google-drive --config YOUR_CONFIG_FOLDER_PATH\actifile_googledrive.conf --drive-id='YOUR_DRIVE_ID' --device-name=YOUR_DEVICE_NAME --cache-dir YOUR_CACHE_FOLDER_PATH

Gmail:

./agent --gmail --config YOUR_CONFIG_FOLDER_PATH\actifile_googlemail.conf --device-name=YOUR_DEVICE_NAME --cache-dir=YOUR_CACHE_FOLDER_PATH

Example:

image-45-1024x80

 

Step 5. Open the Actifile Portal portal and select Deployment > Installed Devices. Your device will appear in the list under the name you chose earlier.

Old interface:

image-19-2

New interface:

image-png-Feb-12-2025-11-53-17-1275-AM (1)

 

You have completed a one-time scan of your cloud storage.