Applies to: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-08-24

The Get-UMMailboxPolicy cmdlet displays the properties and values of a Unified Messaging (UM) mailbox policy.


Get-UMMailboxPolicy [-Identity <MailboxPolicyIdParameter>] [-DomainController <Fqdn>]


Parameter Required Type Description




To specify the fully qualified domain name of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter on the cmdlet.




This parameter specifies the identifier for the UM mailbox policy that is being viewed. This is the directory object ID for the UM mailbox policy.

Detailed Description

The Get-UMMailboxPolicy cmdlet retrieves the configuration properties and values for a UM mailbox policy or returns a list of UM mailbox policies. If the Identity parameter is supplied, the properties and values for the specified UM mailbox policy object are returned. If no parameter is specified at the command line, all UM mailbox policies in the Active Directory forest are returned.

To run the Get-UMMailboxPolicy cmdlet, the account you use must be delegated the Exchange View-Only Administrator role.

For more information about permissions, delegating roles, and the rights that are required to administer Microsoft Exchange Server 2007, see Permission Considerations.

Input Types

Return Types


Error Description




Exceptions Description




The first code example returns a formatted list of all UM mailbox policies in the Active Directory forest.

The second code example returns the properties and values for a UM mailbox policy named MyUMMailboxPolicy and in a formatted list.

Copy Code
Get-UMMailboxPolicy | format-list

Get-UMMailboxPolicy -Identity MyUMMailboxPolicy