Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11
The New-UMMailboxPolicy cmdlet creates a new Unified Messaging (UM) mailbox policy.
Syntax
New-UMMailboxPolicy -Name <String> -UMDialPlan
<UMDialPlanIdParameter> [-DomainController <Fqdn>]
[-TemplateInstance <PSObject>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Name |
Required |
System.String |
This parameter specifies the display name for the UM mailbox policy. The name for the UM mailbox policy can contain as many as 64 characters. |
|
UMDialPlan |
Required |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
This parameter specifies the identifier for the UM dial plan to be associated with the UM mailbox policy. This parameter is the directory object ID for the UM dial plan. |
|
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. |
|
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
When an existing object is supplied to this parameter, the cmdlet will use the configuration of that object to create an identical copy of the object on a local or target server. |
Detailed Description
The New-UMMailboxPolicy cmdlet creates a new UM mailbox policy that has organization-wide scope. UM mailbox policies provide a set of policy values to be applied to UM-enabled users who are associated with a particular UM dial plan. UM mailbox policies are directly associated with UM dial plans. Therefore, the settings that are contained within a UM mailbox policy apply only to UM-enabled users of the UM dial plan to which the UM mailbox policy is associated. You can also use the New-UMMailboxPolicy cmdlet to create a UM mailbox policy template that can be used to create additional UM mailbox policies.
To run the New-UMMailboxPolicy cmdlet, the account you use must be delegated the following:
- Exchange Organization Administrator role
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
|
Example
This example creates a new UM mailbox policy named MyUMMailboxPolicy that is associated with a UM dial plan named MyUMDialPlan.
 Copy Code |
|
|---|---|
New-UMMailboxPolicy -Name MyUMMailboxPolicy -UMDialPlan MyUMDialPlan |
|