Export (0) Print
Expand All

Installing Windows PowerShell for Azure Rights Management

 

Updated: July 1, 2015

Applies To: Azure Rights Management, Office 365

Use the following information to help you install Windows PowerShell for Microsoft Azure Rights Management (Azure RMS).

You can use this Windows PowerShell module to administer Azure Rights Management from the command line by using any computer that has an Internet connection and that meets the prerequisites listed in the next section. Windows PowerShell for Azure Rights Management supports scripting for automation or might be necessary for advanced configuration scenarios. For more information about the administration tasks and configurations that the module supports, see Administering Azure Rights Management by Using Windows PowerShell.

This table lists the prerequisites to install and use Windows PowerShell for Azure Rights Management.

Requirement

More information

A version of Windows that supports the Rights Management administration module

Check the list of supported operating systems in the System Requirements section of the download page for the Azure Rights Management Administration Tool.

Minimum version of Windows PowerShell: 2.0

Support for the Rights Management administration module is introduced in Windows PowerShell 2.0.

By default, most Windows operating systems install with at least version 2.0 of Windows PowerShell. If you need to install Windows PowerShell 2.0, see Install Windows PowerShell 2.0.

System_CAPS_tipTip

You can confirm the version of Windows PowerShell that you are running by typing $PSVersionTable in a Windows PowerShell session.

Minimum version of the Microsoft .NET Framework: 4.5

System_CAPS_tipTip

This version of the Microsoft .NET Framework is included with the later operating systems, so you should only need to manually install it if your client operating system is less than Windows 8.0 or your server operating system is less than Windows Server 2012.

If this is not already installed, you can download the Microsoft .NET Framework 4.5.

This version of the Microsoft .NET Framework is required for some of the classes that the Rights Management administration module uses.

Microsoft Online Services Sign-In Assistant 7.0

The Microsoft Online Services Sign-In Assistant is required for Azure Rights Management authentication.

For more information, see Download Center: Microsoft Online Services Assistant for IT Professionals RTW.

  1. Go to the Microsoft Download Center and download the Azure Rights Management Administration Tool, which contains the Azure Rights Management administration module for Windows PowerShell.

  2. From the local folder where you downloaded and saved the Rights Management installer file, double-click the executable file that you downloaded for your platform (WindowsAzureADRightsManagementAdministration_x64 or WindowsAzureADRightsManagementAdministration_x86.exe) to start the Azure AD Rights Management Administration Setup Wizard.

  3. Complete the wizard.

Windows PowerShell for Azure Rights Management is now installed.

To see which cmdlets are available, start Windows PowerShell with the Run as administrator option and type the following:

Get-Command -Module aadrm

Use the Get-Help <cmdlet_name> command to see the Help for a specific cmdlet.

For more information:

Before you can run any commands that configure the Azure Rights Management service, you must connect to the service by using the Connect-AadrmService cmdlet. When you have finished running the configuration commands that you want, disconnect from the service by using the Disconnect-AadrmService cmdlet.

System_CAPS_noteNote

If you have not yet activated Rights Management, you can do this after you have connected to the service, by using the Enable-Aadrm cmdlet.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2015 Microsoft