Get-​RM​SServer​Authentication

Gets the status of your service principal authentication to Azure RMS.

Syntax

Get-RMSServerAuthentication []

Description

The Get-RMSServerAuthentication cmdlet gets the status and details of your service principal authentication to Azure Rights Management (Azure RMS) that was previous set by using Set-RMSServerAuthentication. The status must be ON for you to protect or unprotect files for Azure RMS by using a service principal rather than your user account. This status remains on for the duration of your Windows PowerShell session.

This cmdlet applies to Azure RMS only and does not apply to AD RMS. This cmdlet also does not apply if you are authenticating to Azure RMS by using your user account. For more information about using a service principal account to connect to the Azure Rights Management service, see Using PowerShell with the Azure Information Protection client from the Azure Information Protection client admin guide.

Examples

Example 1: Get the status of your service principal authentication to Azure RMS

PS C:\>Get-RMSServerAuthentication
The RmsServerAuthentication is ON

Base64Key                                         AppPrincipalId                          BposTenantId
---------                                         --------------                          ------------
zIeMu8zNJ6U377CLtppkhkbl4gjodmYSXUVwAO5ycgA=      b5e3f76a-b5c2-4c96-a594-a0807f65bba4    23976bc6-dcd4-4173-9d96-dad1f48efd42

This command gets the status of the service principal authentication and outputs the currently used identifiers, if authentication is successful.