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.
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.