Applies to: Exchange Server 2007
Topic Last Modified: 2007-06-11
The Remove-ActiveSyncMailboxPolicy cmdlet enables you to remove a specific Exchange ActiveSync mailbox policy from a Microsoft Exchange Server 2007 computer that has the Client Access server role installed.
Syntax
remove-ActiveSyncMailboxPolicy -Identity
<MailboxPolicyIdParameter> [-DomainController
<Fqdn>]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter |
This parameter specifies the policy name. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to the Active Directory directory service, include the DomainController parameter in the command. |
Detailed Description
An Exchange ActiveSync mailbox policy is a group of settings that specifies how mobile devices connect to Microsoft Exchange. Exchange 2007 supports multiple Exchange ActiveSync mailbox policies. The Remove-ActiveSyncMailboxPolicy cmdlet enables you to remove a specific Exchange ActiveSync mailbox policy from the Client Access server. If any users are assigned to the policy when you remove it, the Remove-ActiveSyncMailboxPolicy cmdlet will fail.
To run the Remove-ActiveSyncMailboxPolicy 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
The following code example removes the Exchange ActiveSync mailbox policy named SalesPolicy.
 Copy Code |
|
|---|---|
Remove-ActiveSyncMailboxPolicy -Identity "SalesPolicy" |
|