Enable users to sync IRM-protected files with the OneDrive sync client (Preview)

We're adding a new feature to the new OneDrive sync client: the ability to sync IRM-protected SharePoint document libraries and OneDrive locations. This article provides instructions for previewing the feature and providing feedback.

Disclaimer: This is a pre-release feature, so you might encounter bugs and other issues. We recommend that you set up a test environment and a set of test users to preview the feature. Do not use this feature with production data.

Setup overview

  1. Complete the prerequisite steps for your environment.

  2. Deploy the RMS client to test computers.

  3. Set the update ring to "Internal" (for IT-managed devices) or set up Windows or Office Insider on the test computers (for unmanaged devices).

  4. Enable the IRM feature for test computers using the registry opt-in file.

  5. Select to sync an IRM-protected library and provide feedback.

Prerequisites

  1. Users are running Windows 7 or later.

  2. You have IRM applied to a SharePoint Online library. (On-premises SharePoint Server libraries can't be synced with the new OneDrive sync client.)

  3. Your users have disabled syncing using the previous OneDrive for Business sync client.

  4. OneDrive Files On-Demand is disabled.

  5. The IRM setting "After download, document access rights will expire after these number of days (1-365)" is not selected for the document library you want to test.

Known issues

  • This preview feature doesn't support Files On-Demand yet.

  • This feature doesn't support the IRM setting that expires document access rights.

  • In this preview, if you change the IRM settings for a location, the sync client won't automatically apply the changes. You must stop syncing the location and then select to sync it again.

Disabling the previous OneDrive for Business sync client

To prevent reliability issues, any users that are using the previous OneDrive for Business sync client (Groove.exe) to sync an IRM-protected library must disable syncing before joining the preview.

  1. On a computer that uses the previous OneDrive for Business sync client to sync IRM-protected libraries, right-click the blue OneDrive for Business icon in the notification area, at the far right of the taskbar:

    OneDrive for Business - System icon_C3_2017820142618

  2. Click Stop syncing a folder.

    OneDrive for Business - Menu_C3_201782014275

  3. Select the IRM-protected library and click Stop syncing.

    OneDrive for Business - stop sync dialog_C3_2017820142811

Setup instructions

If your IT department manages the computers in your organization, follow the setup instructions for IT-managed devices. Otherwise, refer to the setup instructions for unmanaged devices.

Setup for IT-managed devices

Step 1: Install the RMS client on your test computers

For this preview, you need to deploy the RMS client to users' computers. Download the Rights Management Service client.

To silently install the client on computers, use the /qn switch as part of the command-line options of the Microsoft Windows Installer Tool (Msiexec.exe). For example, the following command shows the silent mode installation (assuming the RMS Client installer package is already downloaded to C:\Downloads)

msiexec /qn c:\downloads\setup.msi

You can have the setup file on a network share and use managed software deployment to run the msiexec command.

Step 2: Add your test computers to the Internal ring for receiving OneDrive sync client updates

Make the following registry change on these computers: 

REG ADD HKCU\SOFTWARE\Microsoft\OneDrive /f /v EnableTeamTier_Internal /t REG_DWORD /d 1

This feature can be previewed on any sync client build above 17.3.6944.0627. 17.3.6998.0830 is currently available to users in the Internal ring. To view your sync client build number, right-click the OneDrive icon in the notification area, click Settings, and then click the About tab.

Note: It may take 24 hours for your sync client to update to Internal release.

Step 3: Enable the IRM feature

Download the registry opt-in file and run it on any computers that will sync IRM-protected libraries.

Step 4: Start syncing an IRM-protected library

Have your users browse to the library in SharePoint and click the Sync button. This will open the OneDrive sync client and create the sync relationship for the location.

Setup for unmanaged devices

Step 1: Install the RMS client on your test computers

For this preview, you need to install the RMS client on test computers. Download the Rights Management Service client.

Step 2: Set up Windows or Office Insider on the test computers

Follow the instructions to join one of the Insider programs and update to an Insider build on the test computers:

Windows Insider program

Office Insider program

This feature can be previewed on any sync client build above 17.3.6944.0627. 17.3.6998.0830 is currently available to users in the Insider programs. To view your sync client build number, right-click the OneDrive icon in the notification area, click Settings, and then click the About tab.

Note: It may take 24 hours for your sync client to update to the current release for the Insider program.

Step 3: Enable the IRM feature

Download the registry opt-in file and run it on any computers that will sync IRM-protected libraries.

Step 4: Start syncing an IRM-protected library

Browse to the library in SharePoint and click the Sync button. This will open the OneDrive sync client and create the sync relationship for the location.

Providing feedback

Please let us know if you have feedback on this feature or encounter any issues! Right-click the OneDrive icon in the notification area and click "Report a problem." Please tag any feedback with "IRMIssue" so that your feedback will be sent directly to engineers working on this feature.

Report an IRM problem_C3_2017820153849

Connect with an expert
Contact us
Expand your skills
Explore training

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×