Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28
Use the Remove-OABVirtualDirectory cmdlet to remove a server from the offline address book (OAB) distribution points list.
Syntax
Remove-OabVirtualDirectory -Identity
<VirtualDirectoryIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>] [-Force
<SwitchParameter>] [-WhatIf [<SwitchParameter>]]
|
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
Use the Identity parameter to specify the GUID, distinguished name or offline address book virtual directory name that represents a specific offline address book virtual directory. You can also include the path by using the format Server\OfflineAddressBookVirtualDirectoryName. You can omit the parameter label Identity so that only the offline address book virtual directory name or GUID is supplied. |
|
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name of the domain controller that retrieves data from Active Directory® directory service, include the DomainController parameter in the command. |
|
Force |
Optional |
System.Management.Automation.SwitchParameter |
If set to |
|
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter. |
Detailed Description
This cmdlet removes a Client Access server from the OAB distribution points list. For example, if you wish to uninstall a Client Access server that contains an OAB distribution points list, you will have to remove the OAB virtual directory and recreate it on another Client Access server.
To run the Remove-OABVirtualDirectory cmdlet, the account you use must be delegated the following:
- Exchange Server Administrator role and local Administrators
group for the target server
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 first example removes the default OAB virtual directory from the local server.
The second example removes the default OAB virtual directory from Server1.
 Copy Code |
|
|---|---|
Remove-OabVirtualDirectory -Identity "OAB (Default Web Site)" Remove-OabVirtualDirectory -Identity "Server1\OAB (Default Web Site)" |
|