Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11
The Remove-UMMailboxPolicy cmdlet deletes a Unified Messaging (UM) mailbox policy.
Syntax
Remove-UMMailboxPolicy -Identity
<MailboxPolicyIdParameter> [-DomainController
<Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter |
This parameter specifies the identifier for the UM dial plan that is being deleted. 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. |
Detailed Description
The Remove-UMMailboxPolicy cmdlet is used to delete or remove a UM mailbox policy. If the UM mailbox policy is deleted from Active Directory, the UM mailbox policy cannot be used when configuring UM-enabled users. The UM mailbox policy cannot be deleted if the UM mailbox policy is referenced by any UM-enabled mailboxes.
To run the Remove-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 deletes a UM mailbox policy named MyUMMailboxPolicy.
 Copy Code |
|
|---|---|
Remove-UMMailboxPolicy -Identity MyUMMailboxPolicy |
|