Skip to main content

Get OneDrive Backup Status

Purpose​

The Get OneDrive Backup Status solution answers a simple question: whose files would be lost if this device failed?

For every user on each Windows workstation, it shows whether the Desktop, Documents and Pictures folders are backed up to OneDrive. Use it to find users who still keep their files only on the device.

How It Works​

  1. Collect: The Get OneDrive Backup Status automation runs daily on Windows workstations and stores the result in cPVAL OneDrive Backup Status.
  2. Report (optional): The WYSIWYG Custom Field Report - Organization and Global KB automation runs on one device and turns that field into organization and global Knowledge Base articles and CSV files.

Key Capabilities​

  • Every User Profile: Users do not need to be signed in.
  • Clear Results: True or False for Desktop, Documents and Pictures, with the OneDrive folder path when backed up.
  • Unprotected Users Visible: Users without OneDrive are listed too.
  • Cross-Client View: Optional Knowledge Base articles and CSV files per organization and for all clients.

Associated Content​

Custom Fields​

NameDefaultExampleLevelManaged ByFunction
cPVAL OneDrive Backup Status(blank)HTML tableDeviceAutomationStores the OneDrive backup status of every user profile on the device.
cPVAL Ninja API Client ID(blank)8GIo0Y646lsxWXj5HBO6RcUoKY7SystemManualOptional. Only needed for the reports. Identifies the API application the report automation signs in as.
cPVAL Ninja API Client Secret(blank)67h5w58GIo0Y646lsxWXj5...SystemManualOptional. Only needed for the reports. Authenticates that API application.

Automations​

NameFunction
Get OneDrive Backup StatusChecks every user profile and stores the backup status in the custom field.
WYSIWYG Custom Field Report - Organization and Global KBOptional. Builds the Knowledge Base articles and CSV files from the custom field.

Audit Reports​

NameFunction
OneDrive Backup StatusLists the OneDrive backup status of every user, per organization and for all clients.

Implementation​

Step 1: Create the Custom Field​

Step 2: Create the Automation​

Set Run as to System.

Step 3: Schedule the Data Collection​

Schedule the automation to run once per day against the Windows Workstations group.

Step 4 (Optional): Set Up the Reports​

Skip this step if the partner does not need reports. The data is still collected and kept on each device in the custom field.

  1. API application and credentials: Create the NinjaOne API application and fill the cPVAL Ninja API Client ID and cPVAL Ninja API Client Secret fields, as described in WYSIWYG Custom Field Report - Organization and Global KB. If they are already set up for another ProVal reporting solution, reuse them.
  2. Report automation: Create the WYSIWYG Custom Field Report - Organization and Global KB automation.
  3. Schedule: Schedule the report automation to run once per day against one device, such as a server that is always online. Run it after the data collection. Use the values listed in the Report Settings section of the Audit Report:
note

Knowledge Base articles need the NinjaOne Documentation app. Without it, set Report Output to Local CSV Files to create only the CSV files on the device that runs the report.

Comprehensive FAQs​

General Usage​

Q. What does this solution do?
A: It checks whether each user's Desktop, Documents and Pictures folders are backed up to OneDrive, and refreshes the result every day.

Q. What counts as backed up?
A: A folder counts as backed up when OneDrive manages it, which happens when OneDrive folder backup is turned on for that folder.

Q. Do users need to be signed in?
A: No. The automation reads every user profile on the device.

Q. Why is a user listed with every folder set to False?
A: That user has no OneDrive folder backup. Either OneDrive is not set up for them, or folder backup is turned off.

Q. Does it change any OneDrive settings?
A: No. It only reads the current settings.

Q. Why does the device need internet access?
A: The automation downloads the Strapper PowerShell module it uses to read every user profile.

Reports​

Q. Do I need the reports?
A: No. They are optional. Without them, the data is still collected and kept on each device in its custom field.

Q. What do I need for the Knowledge Base articles?
A: The NinjaOne Documentation app, an API application with its credentials in cPVAL Ninja API Client ID and cPVAL Ninja API Client Secret, and the WYSIWYG Custom Field Report - Organization and Global KB automation. Without the Documentation app, the report can create CSV files only.

Q. How current are the reports?
A: They show the data from the last collection on each device. The DataCollectionDate column shows when each device reported. Schedule the report after the data collection so it picks up the latest data.

Q. Where are the CSV files saved?
A: On the device that runs the report automation, under C:\ProgramData\_Automation\Report. The exact path is listed in each Audit Report document.

Changelog​

2026-10-14​

  • Initial version of the document.