Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2007-06-28
The Remove-OwaVirtualDirectory cmdlet removes Outlook Web Access virtual directories that are located in the Internet Information Services (IIS) Web site on a server that is running Microsoft Exchange Server 2007.
Syntax
Remove-OwaVirtualDirectory -Identity
<VirtualDirectoryIdParameter> [-Confirm
[<SwitchParameter>]] [-DomainController <Fqdn>]
[-WhatIf [<SwitchParameter>]]
|
Parameters
Parameter | Required | Type | Description |
---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
This parameter specifies the name or GUID of an
Outlook Web Access virtual directory. It is represented
as: |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
This parameter causes the command to pause processing and requires that you 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 |
This parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
This 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
To run the Remove-OwaVirtualDirectory cmdlet, you must specify the name of the Outlook Web Access virtual directory that you want to remove.
You might be required to use the Remove-OwaVirtualDirectory cmdlet in the following situations:
- The Get-OwaVirtualDirectory cmdlet detects an
Outlook Web Access virtual directory that is deleted in
IIS but is not deleted in the Active Directory directory
service. These abandoned Outlook Web Access virtual
directory objects are known as Active Directory orphans. We
recommend that you remove this kind of Outlook Web Access
virtual directory in Active Directory by using the
Remove-OwaVirtualDirectory cmdlet.
- You want to remove all legacy Outlook Web Access
virtual directories from your native Exchange 2007
organization. The legacy Outlook Web Access virtual
directories may have been created during Exchange 2007 Setup
or manually created in an Exchange mixed environment.
- You are troubleshooting an Outlook Web Access
configuration issue that requires that you delete the existing
Outlook Web Access virtual directory and then re-create
the Outlook Web Access virtual directory.
- If you uninstall the Client Access server role from the
Exchange server, all Outlook Web Access virtual
directories on that Exchange server are also removed.
Caution: |
---|
The Remove-OwaVirtualDirectory cmdlet permanently removes an Outlook Web Access virtual directory or directories. When you use the Remove-OwaVirtualDirectory cmdlet, make sure that you do not accidentally delete a default Outlook Web Access virtual directory. There are no default values for the Remove-OwaVirtualDirectory cmdlet. |
Note: |
---|
The Remove-OwaVirtualDirectory cmdlet supports the Confirm flag. |
The Remove-OwaVirtualDirectory cmdlet can be run on any server that has the Exchange Server administration tools installed. The account you use must be delegated the Exchange Server Administrators role and membership in the local Administrators group for the target server.
For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.
Input Types
Return Types
Errors
Error | Description |
---|---|
|
|
Exceptions
Exceptions | Description |
---|---|
|
|
Example
The following code example removes a specified Outlook Web Access virtual directory named "owa" that is located on the default IIS Web site on an Exchange server named "Contoso."
Copy Code | |
---|---|
Remove-OwaVirtualDirectory -identity "Contoso\owa (default web site)" |