Creating an AD RMS Cluster Windows PowerShell Drive

Updated: October 22, 2009

Applies To: Windows Server 2008 R2, Windows Server 2008 R2 with SP1

By creating an Active Directory Rights Management Services (AD RMS) deployment Windows PowerShell provider drive, you create a namespace that contains items that represent configuration settings of the server you are installing and provisioning.

To create the Windows PowerShell drive

  • At a Windows PowerShell prompt, type:

    Import-Module ADRMS

    New-PSDrive -PSProvider ADRMSInstall -Name <drive> -Root <cluster_type>

    where <drive> is the name of the Windows PowerShell drive you are creating, and <drive_type> is the type of cluster you are installing: RootCluster or LicensingCluster.

For example, to create a Windows PowerShell drive named RC to install and provision the first server in an AD RMS root cluster, type:

New-PSDrive -PSProvider ADRMSInstall -Name RC -Root RootCluster

To create a Windows PowerShell drive named LC to install and provision the first server in an AD RMS licensing-only cluster, type:

New-PSDrive -PSProvider ADRMSInstall -Name LC -Root LicensingCluster

After creating the drive, do not exit the Windows PowerShell command prompt until you have finished installing the AD RMS server role. Doing so will delete the drive and all property settings will be lost.

See Also

Concepts

Installing an AD RMS Cluster
Setting Properties on Objects in the AD RMS Drive Namespace
Running the Install-ADRMS Cmdlet