Creating an AD RMS Server Windows PowerShell Drive

  • Article

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 joining to an existing AD RMS cluster.

To create the Windows PowerShell drive

  • At a Windows PowerShell prompt, type:

    Import-Module ADRMS

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

    where <drive> is the name of the Windows PowerShell drive you are creating.

For example, to create a Windows PowerShell drive named NewSvr to install and provision a new server in an existing AD RMS cluster, type:

New-PSDrive -PSProvider ADRMSInstall -Name NewSvr -Root JoinCluster

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

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