Azure Information Protection client administrator guide
Applies to: Active Directory Rights Management Services, Azure Information Protection, Windows 10, Windows 8.1, Windows 8, Windows 7 with SP1, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2
Use the information in this guide if you are responsible for the Azure Information Protection client on an enterprise network, or if you want more technical information than is in the Azure Information Protection client user guide.
Understand the different components of this client and whether you should install it
How to install the client for users, with information about prerequisites, installation options and parameters, and verification checks
How to accommodate custom configurations that often require editing the registry
Locate the client files and usage logs
Identify the file types supported by the client
Configure and use the document tracking site for users
Use the client with PowerShell for command-line control
Have a question that's not addressed by this documentation? Visit our Azure Information Protection Yammer site.
Technical overview of the Azure Information Protection client
The Azure Information Protection client includes the following:
An Office add-in, that installs the Azure Information Protection bar for users to select classification labels, and a Protect button on the ribbon for additional options. For Outlook, a Do Not Forward button is also available for the ribbon.
Windows File Explorer, right-click options for users to apply classification labels and protection to files.
A viewer to display protected files when a native application cannot open it.
A PowerShell module to apply and remove classification labels and protection from files.
This module includes cmdlets to install and configure the Azure Information Protection scanner that runs as a service on Windows Server. This service lets you discover, classify, and protect files on data stores such as network shares and SharePoint Server libraries.
The Rights Management client that communicates with Azure Rights Management (Azure RMS) or Active Directory Rights Management Services (AD RMS).
The Azure Information Protection client is best suited to work with its Azure services; Azure Information Protection and its data protection service, Azure Rights Management. However, with some limitations, the Azure Information Protection client also works with the on-premises version of Rights Management, AD RMS. For a comprehensive comparison of features that are supported by Azure Information Protection and AD RMS, see Comparing Azure Information Protection and AD RMS.
If you have AD RMS and want to migrate to Azure Information Protection, see Migrating from AD RMS to Azure Information Protection.
Should you deploy the Azure Information Protection client?
Deploy the Azure Information Protection client if any of the following applies:
You want to classify (and optionally, protect) documents and email messages by selecting labels from within your Office applications (Word, Excel, PowerPoint, Outlook).
You want to classify (and optionally, protect) documents and email messages by using File Explorer, which supports additional file types, multi-select, and folders.
You want to run scripts that classify (and optionally, protect) documents by using PowerShell commands.
You want to run a service that discovers, classifies (and optionally, protects) files that are stored on-premises.
You want to view protected documents when a native application to display the file is not installed or cannot open these documents.
You want to just protect files by using File Explorer or by using PowerShell commands.
You want users and administrators to be able to track and revoke protected documents.
You want to remove encryption from files and containers (unprotect) in bulk for data recovery purposes.
You run Office 2010 and want to protect documents and email messages by using the Azure Rights Management service.
Example showing the Azure Information Protection client add-in for an Office application, displaying the classification labels for your organization, and the new Protect button on the ribbon:
Installing and supporting the Azure Information Protection client
You can install the Azure Information Protection client by using Windows Update, an executable, or a Windows installer file. For more information about each choice, and instructions, see Install the Azure Information Protection client for users.
Use the following sections for supporting information about installing the client.
Installation checks and troubleshooting
When the client is installed, use the Help and Feedback option to open the Microsoft Azure Information Protection dialog box:
From an Office application: On the Home tab, in the Protection group, select Protect, and then select Help and Feedback.
From File Explorer: Right-select a file, files, or folder, select Classify and protect, and then select Help and Feedback.
Help and Feedback section
The Report an Issue link displays in preview versions of the client and not in general availability versions. By default, this option sends an email to Microsoft but you can configure the HTTP string for your users by specifying an advanced client setting. For example, specify the email address of your help desk.
The Export Logs automatically collects and attaches log files for the Azure Information Protection client if you have been asked to send these to Microsoft Support. This option can also be used by end users to send these log files to your help desk.
The Reset Settings signs out the user, deletes the currently downloaded Azure Information Protection policy, and resets the user settings for the Azure Rights Management service.
More information about the Reset Settings option
You do not have to be a local administrator to use this option and this action is not logged in the Event Viewer.
Unless files are locked, this action deletes all the files in the following locations. These files include client certificates, Rights Management templates, the Azure Information Protection policy, and the cached user credentials. The client log files are not deleted.
The following registry keys and settings are deleted. If the settings for any of these registry keys have custom values, these must be reconfigured after you reset the client.
Typically for enterprise networks, these settings are configured by using group policy, in which case they are automatically reapplied when group policy is refreshed on the computer. However, there might be some settings that are configured one time with a script, or manually configured. In these cases, you must take additional steps to reconfigure these settings. As an example, computers might run a script one time to configure settings for redirection to Azure Information Protection because you are migrating from AD RMS and still have a Service Connection Point on your network. After resetting the client, the computer must run this script again.
The currently signed in user is signed out.
Client status section
Use the Connected as value to confirm that the displayed user name identifies the account to be used for Azure Information Protection authentication. This user name must match an account used for Office 365 or Azure Active Directory. The account must also belong to a tenant that is configured for Azure Information Protection.
If you need to sign in as a different user to the one displayed, see the Sign in as a different user customization.
The Last connection displays when the client last connected to your organization's Azure Information Protection service. You can use this information with the Information Protection policy was installed on date and time to confirm when the Azure Information Protection policy was last installed or updated. When the client connects to the service, it automatically downloads the latest policy if it finds changes from its current policy, and also every 24 hours. If you have made policy changes after the displayed time, close and reopen the Office application.
If you see This client is not licensed for Office Professional Plus: The Azure Information Protection client has detected that the installed edition of Office does not support applying Rights Management protection. When this detection is made, labels that apply protection do not display on the Azure Information Protection bar.
Use the Version information to confirm which version of the client is installed. You can check whether this is the latest release version and the corresponding fixes and new features by clicking the What's New link, to read the Version release history for the client.
Support for multiple languages
The Azure Information Protection client supports the same languages that Office 365 supports. For a list of these languages, see the Office 365, Exchange Online Protection, and Power BI section from the International availability page from Office.
For these languages, menu options, dialog boxes, and messages from the Azure Information Protection client display in the user's language. There is a single installer that detects the language, so no additional configuration is required to install the Azure Information Protection client for different languages.
However, label names and descriptions that you specify are not automatically translated when you configure labels in the Azure Information Protection policy. Beginning with August 30, 2017, the current default policy includes support for some languages. For users to see labels in their preferred language, provide your own translations and configure the Azure Information Protection policy to use these translations. For more information, see How to configure labels for different languages in Azure Information Protection. Visual markings are not translated and do not support more than one language.
Post installation tasks
After you have installed the Azure Information Protection client, make sure that you give users instructions for how to label their documents and emails, and guidance for which labels to choose for specific scenarios. For example:
Online user instructions: Azure Information Protection user guide
Download a customizable user guide: Azure Information Protection End User Adoption Guide
Update macros in Excel spreadsheets
If you have Excel spreadsheets that contain macros, edit the macros as follows to ensure that they continue to work as expected after the Azure Information Protection client is installed:
At the beginning of the macro, add:
Application.EnableEvents = False
At the end of the macro, add:
Application.EnableEvents = True
For more information, see Application.EnableEvents Property (Excel).
Upgrading and maintaining the Azure Information Protection client
The Azure Information Protection team regularly updates the Azure Information Protection client for new functionality and fixes. Announcements are posted to the team's Yammer site.
If you are using Windows Update, the Azure Information Protection client automatically upgrades the general availability version of the client, irrespective of how the client was installed. New client releases are published to the catalog a few weeks after the release.
Alternatively, you can manually upgrade the client by downloading the new release from the Microsoft Download Center. Then install the new version to upgrade the client. You must use this method to upgrade preview versions.
When you manually upgrade, uninstall the previous version first only if you're changing the installation method. For example, you change from the executable (.exe) version of the client to the Windows installer (.msi) version of the client. Or, if you need to install a previous version of the client. For example, you have the current preview version installed for testing and now need to revert to the current general availability version.
Use the Version release history and support policy to understand the support policy for the Azure Information Protection client, which versions are currently supported, and what's new and changed for the supported releases.
Upgrading the Azure Information Protection scanner
To upgrade the Azure Information Protection scanner, install the latest version of the Azure Information Protection client. Then do one of the following one-time actions. After you have done this, there is no need to rescan already scanned files.
For the current GA version:
- Rerun the scanner installation command with Install-AIPScanner. Your configuration settings for the scanner and repositories will be retained. Reinstalling the scanner grants the scanner service account delete permissions for the scanner database, which will be required for reports.
For the preview version:
Run Update-AIPScanner after you have upgraded the Azure Information Protection client from the general availability version 22.214.171.124, or earlier. Your configuration settings for the scanner and repositories will be retained. Running this cmdlet is required to update the database schema for the scanner and if required, the scanner service account is also granted delete permissions for the scanner database.
Until you run this update cmdlet, the scanner does not run and you typically see Event ID 1000 in the Windows event log, with the following error message: Invalid object name 'ScannerStatus'.
Uninstalling the Azure Information Protection client
You can use any of the following options to uninstall the client:
Use Control Panel to uninstall a program: Click Microsoft Azure Information Protection > Uninstall
Rerun the executable (for example, AzInfoProtection.exe), and from the Modify Setup page, click Uninstall.
Run the executable with /uninstall. For example:
To install the client, see Install the Azure Information Protection client for users.
If you've already installed the client, see the following for additional information that you might need to support this client: