Announcement: Windows Azure RMS Documentation Library Update for March 2014

[Azure Information Protection Team]

First published on CloudBlogs on Mar, 26 2014

Hi everybody

As per Carol’s introduction post , she's letting you know what's new and hot in the docs for this month.

Reminders: Follow us on twitter ( @TheRMSGuy ) and join in our new RMS peer community at www.yammer.com/AskIPTeam .

Cheers,

Dan (on behalf of the RMS team)

The Documentation Library for Windows Azure Rights Management has been updated on the web and the latest content has Updated: March 1, 2014 at the top of the topic.

Summary of the documentation available:

• Getting Started with Rights Management
• Configuring Rights Management
• Using Rights Management
• Administering Rights Management by using Windows PowerShell

In addition, there are the Rights Management sharing application guides (also applicable to AD RMS):

• Rights Management sharing application user guide
• Rights Management sharing application administrator guide
• FAQ for Microsoft Rights Management Sharing Application for Windows

This month is all about PowerShell . I know many admins have come to love using PowerShell to help cut down their administrative overheads - after all, it's a lot easier to document a single-line command than to document a click, click, click procedure that uses the UI. But in addition, many configurations are now only possible by using PowerShell - which is the case with some of our popular and newly introduced features, such as usage logging and bring your own key (BYOK). If you don't have good documentation to support the cmdlets that these features rely on for their configuration, chances are you'll have a frustrating time trying to implement the new functionality that's available.

The Windows Azure Rights Management documentation for PowerShell was written a while ago, when both the service and the module were still in preview.  So it was time to give these docs a thorough spring clean. As a result, we've got all the cmdlets documented online, with the standard format that uses a short and long description (links to the docs where applicable), syntax and parameters, and at least one example. These replace the task-based topics that used to be under the Administering Rights Management by using Windows PowerShell section - for example, Adding, Listing, or Removing Role-based Administrators for Windows Azure Rights Management .  If you were used to using these topics and had them marked as favorites, you can still get to them but they are removed from the table of contents and they now contain links to the relevant cmdlet topics. Some topics still link to them and will be updated soon.  All the information that was in these task-based topics is in the new cmdlet topics, and more.

*** Check them out *** Windows Azure Rights Management Cmdlets

Note that the Add-AadrmKey cmdlet, although documented, is not yet publically supported.  This cmdlet lets you generate your own tenant key over the Internet, without having to fly to Redmond (this scenario is also known as "remote BYOK" or "no-fly BYOK").  This cmdlet relies on a toolset and other instructions in the core documentation that will be published when this scenario is publically supported - watch this blog for that breaking news. For more information about this new functionality, see Dan's post about this being in preview: Azure RMS BYOK, now without flying

The same cmdlet help information will soon be added to the Windows Azure RMS module itself, so that when you download the module , you have the latest help locally available when you use the Get-Help commands. Unfortunately, the module does not support online help (that takes you directly to the latest version on the web) or updatable help (download the latest help file for the module).  This PowerShell functionality is something that the team is looking at adding but at the moment, when the module prompts you to download help, it's downloading the latest help for other PowerShell modules you've installed that do support this feature. That means that to ensure you're looking at the latest help for the Windows Azure RMS module, you must manually check on the web, and I'll let you know on this blog when and if these topics are updated.

We value customer feedback and try to incorporate it when possible.  Although we can't promise to make the docs perfect for everybody, we are committed to continual improvement.  If you are a PowerShell fan and want to help improve our cmdlet help, or if you have any feedback about any of the docs for Windows Azure RMS, email AskIPTeam@Microsoft.com .

What's New in the Documentation Library for Windows Azure Rights Management, March 2014

The following information lists the topics that contain significant changes since the last update (February 2014).

Administering Rights Management by using Windows PowerShell

- Updated so that the table now includes the new scenarios of BYOK and usage logging, and the relevant cmdlets are now listed with links to their reference topics.

Installing Windows PowerShell for Windows Azure Rights Management

- Updated for cleaner, leaner information, with links to related topics.

Connecting to the Windows Azure Rights Management Service

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topic: Connect-AadrmService

Disconnecting from the Windows Azure Rights Management Service

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topic: Disconnect-AadrmService

Disabling the Windows Azure Rights Management Service

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topic: Disable-Aadrma

Enabling the Windows Azure Rights Management Service

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topic: Enable-Aadrm

Adding, Listing, or Removing Role-based Administrators for Windows Azure Rights Management

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topics: Add-AadrmRoleBasedAdministrator , Get-AadrmRoleBasedAdministrator , Remove-AadrmRoleBasedAdministrator

Listing or Setting the URL for Use in Migrating Windows Azure Rights Managed Content to AD RMS ...

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topics: Set-AadrmMigrationUrl and Get-AadrmMigrationUrl

Managing Super Users for Windows Azure Rights Managed Content

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topics: Enable-AadrmSuperUserFeature , Disable-AadrmSuperUserFeature , Add-AadrmSuperUser , Get–AadrmSuperUser , Remove-AadrmSuperUser

Downloading Audit Logs for Windows Azure Rights Management

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topic: Get-AadrmAdminLog

Displaying the Current Windows Azure Rights Management Configuration

- Removed from the table of contents with links to the new Windows Azure Rights Management cmdlet reference topic: Get-AadrmConfiguration