Share via


Get-WebServicesVirtualDirectory

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

The Get-WebServicesVirtualDirectory cmdlet retrieves the information for the virtual directory named EWS in the Active Directory directory service from a computer that is running Microsoft Exchange Server 2007 with the Client Access server role installed.

Syntax

Get-WebServicesVirtualDirectory [-Identity <VirtualDirectoryIdParameter>] [-DomainController <Fqdn>]

Get-WebServicesVirtualDirectory -Server <ServerIdParameter> [-DomainController <Fqdn>]

Detailed Description

The Get-WebServicesVirtualDirectory cmdlet retrieves the information for the EWS virtual directory object in Active Directory from a computer that is running Exchange 2007 with the Client Access server role installed.

The Get-WebServicesVirtualDirectory cmdlet can be run on a local server, or run remotely if the server name is specified in the Identity or Server parameters. It can also be run without parameters to retrieve the configuration settings from all Outlook Web Access virtual directories on all Internet Information Services (IIS) Web sites that are located on the Client Access servers in the organization.

The Get-WebServicesVirtualDirectory cmdlet can be run on any server that has the Exchange administration tools installed. The account you use must be delegated the Exchange View-Only Administrator role.

For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.

Parameters

Parameter Required Type Description

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

This parameter specifies the name or GUID of the server that hosts the virtual directories that you want to display.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory, include the DomainController parameter in the command.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

This parameter specifies either the GUID of the server, the name of the Web site, or the name of the virtual directory that you want to display.

Input Types

Return Types

Errors

Error Description

 

 

Exceptions

Exceptions Description

 

 

Example

The first code example returns the settings for the Exchange Web Services virtual directory named EWS under the default Web site in Internet Information Services (IIS).

The second code example shows how to use the Identity parameter to retrieve all settings for the Web services virtual directories on a server named "CAS01".

Get-WebServicesVirtualDirectory -Identity EWS(default web site)
Get-WebServicesVirtualDirectory -Identity CAS01