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.
Syntax
Get-UMMailboxPolicy [-Identity
<MailboxPolicyIdParameter>] [-DomainController
<Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
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. |
|
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter |
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
Errors
| Error | Description |
|---|---|
|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
|
Example
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 |
|