Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

New-EcpVirtualDirectory

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

Use the New-EcpVirtualDirectory cmdlet to create an Exchange Control Panel virtual directory. This is a command that Microsoft Exchange Server 2010 Setup runs when you install Exchange 2010 in your organization.


New-EcpVirtualDirectory [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-Server <ServerIdParameter>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

Parameter Required Type Description

AppPoolId

Optional

System.String

The AppPoolId parameter sets the Internet Information Services (IIS) application pool in which the Exchange Control Panel virtual directory runs. We recommend that you leave this parameter at its default setting.

Confirm

Optional

System.Management.Automation.SwitchParameter

The Confirm switch 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 switch.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory.

ExternalUrl

Optional

System.Uri

The ExternalUrl parameter specifies the host name used to connect to the server running Exchange from outside the firewall. This setting is important when Secure Sockets Layer (SSL) is used. This parameter must be set to allow the Autodiscover service to return the URL for the Exchange Control Panel virtual directory.

InternalUrl

Optional

System.Uri

The InternalUrl parameter specifies the host name used to connect to the server running Exchange from inside the firewall. This setting is important when SSL is used. This parameter must be set to allow the Autodiscover service to return the URL for the Exchange Control Panel virtual directory.

Path

Optional

System.String

The Path parameter sets the file system path of the Exchange Control Panel virtual directory. This parameter should be used with care and only when you must use a different file system path than the default.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the name or GUID of the server that hosts the Exchange Control Panel virtual directories that you want to create. You can't create an Exchange Control Panel virtual directory remotely. You can only create an Exchange Control Panel virtual directory on the local computer.

WebSiteName

Optional

System.String

The WebSiteName parameter specifies the name of the IIS Web site under which the Exchange Control Panel virtual directory is created.

WhatIf

Optional

System.Management.Automation.SwitchParameter

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the WhatIf switch, 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 switch.

You should only need to run this command in specific troubleshooting scenarios.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Exchange Control Panel (ECP) virtual directory settings" entry in the Client Access Permissions topic.

Error Description

 

 

This example creates the Exchange Control Panel virtual directory named ecp that's located on the default IIS Web site on the Exchange server Server01.

New-EcpVirtualDirectory -Identity "Server01\ecp (default Web site)"
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.