Get-AutodiscoverVirtualDirectory
Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3
The Get-AutodiscoverVirtualDirectory cmdlet retrieves the settings for the Autodiscover virtual directory on a computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.
Syntax
Get-AutodiscoverVirtualDirectory [-Identity <VirtualDirectoryIdParameter>] [-DomainController <Fqdn>]
Get-AutodiscoverVirtualDirectory -Server <ServerIdParameter> [-DomainController <Fqdn>]
Detailed Description
The Get-AutodiscoverVirtualDirectory cmdlet retrieves the settings for the Autodiscover virtual directory on the specified Client Access server.
You can run the Get-AutodiscoverVirtualDirectory cmdlet on a local server or run it remotely if the server name is specified in the Identity or Server parameters. You can also run this cmdlet without parameters to retrieve the configuration settings from all Autodiscover virtual directories on all Internet Information Services (IIS) Web sites that are located on the Client Access servers in the organization.
You can run the Get-AutodiscoverVirtualDirectory cmdlet on any server that has the Exchange Server 2007 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 |
|---|---|---|---|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the cmdlet. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
This parameter specifies the virtual directory and Web site for the Autodiscover virtual directory. |
Server |
Required |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
This parameter specifies the name or GUID of the Client Access server that hosts the virtual directories that you want to display. |
Input Types
Return Types
Errors
| Error | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Example
This code example returns the settings for the Autodiscover virtual directory under the default Web site in IIS on the Client Access server named CAS01 for the autodiscover.contoso.com site.
Get-AutoDiscoverVirtualDirectory -Identity "CAS01\autodiscover(autodiscover.contoso.com)"