Workflow: OneDrive compliance

Overview

OneDrive is critical to remain productive. However, synchronization issues are common, leading to many frustrations, productivity issues, and, ultimately, L1 tickets. Although in most cases, the fix is simple, it still requires a ticket and calls to the desk, taking up more of IT support's time.

Trigger an automated workflow across any group of devices to verify and ensure OneDrive is present and properly synchronized. If any issues are detected, the workflow automatically performs the necessary remediation.

This workflow automatically enables you to resolve and filter out common OneDrive issues. This saves significant time for any support team, enabling them to investigate and focus on more serious problems.

Changelog

V1.0.0.0 - Initial Release

Dependencies

In order to use this flow the following content needs to be installed into your Nexthink Infinity tenant using the Nexthink Library.

Remote actions

Get OneDrive status
Repair OneDrive
Get OneDrive sync status
Reset OneDrive

For more details about remote actions in workflows see https://nexthink.gitbook.io/opd/user-guide/workflows/creating-workflows/designer.

Campaigns

Reset OneDrive agent - Invoke
Reset OneDrive agent - Complete (macOS only)

For more details about campaigns see https://nexthink.gitbook.io/opd/user-guide/campaigns and campaigns in workflows see https://nexthink.gitbook.io/opd/user-guide/workflows/creating-workflows/designer.

Configuration

Remote action and campaign configuration

Please note: To be used in a workflow, the following remote actions must be configured with a manual trigger. It can be combined with other execution triggers if the remote action is also used outside of a workflow.

The following remote actions require campaigns.

Reset OneDrive
- [campaign_id]: Reset OneDrive agent - Invoke
- [campaign_completed_id]: Reset OneDrive agent - Complete (macOS only)

Service/API configuration

Connector credentials are required for the service/API call step - "Report this device via ITSM ticket". Connector credentials must be manually configured based on your ITSM solution and its current configuration. For more information about setting up connector credentials in Nexthink, you can refer to this documentation page.

Trigger configuration for the workflow

This workflow has been designed primarily to run automatically using the schedule trigger however it can be useful to also enable the manual trigger to allow on-the-fly client remediations to be sent.

When configuring the scheduler we recommend the following settings as a baseline:

NQL:

Code

devices during past 7d
| where operating_system.platform == Windows
 and operating_system.name !in ["*server*"]

Recurrence: Weekly - select at least one day.

Please note: Once all the prerequisites and workflow are installed and configured, you can use the built-in validation feature that runs every time you save the workflow.

Workflow Structure

Please note: The workflow uses campaigns that alert users before every step that affects their Microsoft OneDrive client software. Users can cancel a workflow if it's not the right time to work with their Microsoft OneDrive client.

This section describes the key steps in this workflow:

At the start of this workflow, there is a "Get OneDrive client status" thinklet configured to automate the retrieval of Microsoft OneDrive client status information using a remote action;
Based on the results of this analysis, the workflow determines whether the following issues need to be resolved with additional remote actions:
- Does the device have the Microsoft OneDrive client installed?
- Does the Microsoft OneDrive client report sync issues?

Once these issues are identified, the workflow resets the OneDrive client and waits for the reset to complete.

The workflow then checks the OneDrive client status again and generates an ITSM ticket if the problem persists.