New-EcpVirtualDirectory

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

使用 New-EcpVirtualDirectory Cmdlet 建立 Exchange 主控台 (ECP) 虛擬目錄，這些虛擬目錄是用於 Microsoft Exchange 伺服器上的 Internet Information Services (IIS) 。這是當您在組織中安裝 Exchange 時，Microsoft Exchange Server安裝程式執行的命令。 ECP 虛擬目錄會管理 Exchange 系統管理中心。

ECP Web 管理介面是在 2010 Exchange Server引進。在 Exchange Server 2013 和 Exchange Server 2016 中，EAC 虛擬目錄和對應的管理 Cmdlet 仍會在名稱中使用 ECP。您可以使用這些 Cmdlet 來管理 Exchange 2010、Exchange 2013 和 Exchange 2016 伺服器上的 ECP 虛擬目錄。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

New-EcpVirtualDirectory
   [-AppPoolId <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalUrl <Uri>]
   [-InternalUrl <Uri>]
   [-Path <String>]
   [-Role <VirtualDirectoryRole>]
   [-Server <ServerIdParameter>]
   [-WebSiteName <String>]
   [-WhatIf]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

New-EcpVirtualDirectory -Server SERVER01 -ExternalURL https://mail.contoso.com/ecp -InternalURL https://mail.contoso.com/ecp

此範例會在名為 Server01 的 Exchange 伺服器上建立 ECP 虛擬目錄。

參數

-AppPoolId

AppPoolId 參數會設定 ECP 虛擬目錄執行所在的 IIS 應用程式集區。我們建議您將這個參數保留為其預設設定。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm 參數會指定要顯示或隱藏確認提示。這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。例如，dc01.contoso.com。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionFlags

ExtendedProtectionFlags 參數會指定虛擬目錄上驗證擴充保護的自訂設定。有效值為：

無：這是預設的設定。
AllowDotlessSPN：如果您想要使用服務主體名稱 (SPN) 不包含 FQDN 的值 (例如 HTTP/ContosoMail，而不是 HTTP/mail.contoso.com) 。您可以使用 ExtendedProtectionSPNList 參數指定 SPN。此設定讓驗證的擴充保護較不安全，因為無點憑證不是唯一的，因此無法確保透過安全通道建立用戶端對 Proxy 連線。
NoServiceNameCheck：不會檢查 SPN 清單來驗證通道系結權杖。此設定可讓驗證的擴充保護較不安全。我們通常不建議使用此設定。
Proxy：Proxy 伺服器負責終止 SSL 通道。若要使用此設定，您必須使用 ExtendedProtectionSPNList 參數來註冊 SPN。
ProxyCoHosting：HTTP 和 HTTPS 流量可能會存取虛擬目錄，而 Proxy 伺服器至少位於部分用戶端與 Exchange 伺服器上的用戶端存取服務之間。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionSPNList

如果在虛擬目錄上使用驗證的擴充保護，ExtendedProtectionSPNList 參數會指定有效的服務主體名稱清單 (SPN) 。有效值為：

$null：這是預設值。
有效 SPN 的單一 SPN 或逗號分隔清單：SPN 值格式為 Protocol\FQDN 。例如，HTTP/mail.contoso.com。若要新增不是 FQDN (例如 HTTP/ContosoMail) 的 SPN，您也需要針對 ExtendedProtectionFlags 參數使用 AllowDotlessSPN 值。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionTokenChecking

ExtendedProtectionTokenChecking 參數會定義您要如何在虛擬目錄上使用驗證的擴充保護。預設不會啟用驗證的擴充保護。有效值為：

無：虛擬目錄上不使用驗證的擴充保護。這是預設值。
None：不在虛擬目錄上使用驗證擴充保護。此為預設值。
需要：驗證的擴充保護用於用戶端與虛擬目錄之間的所有連線。如果用戶端或伺服器不支援，連線將會失敗。如果您使用此值，也需要設定 ExtendedProtectionSPNList 參數的 SPN 值。

注意：如果您使用 [允許] 或 [需要] 值，而且您在設定為終止用戶端對 Proxy SSL 通道的信箱伺服器上，用戶端與用戶端存取服務之間有 Proxy 伺服器，您也需要使用 ExtendedProtectionSPNList 參數 (SPN 設定一或多個服務主體名稱) 。

Type:	ExtendedProtectionTokenCheckingMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalUrl

ExternalURL 參數會指定用來從防火牆外部連線至虛擬目錄的 URL。

此設定在使用安全通訊端層 (SSL) 時很重要。您必須設定此參數，以允許自動探索服務傳回 ECP 虛擬目錄的 URL。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalUrl

InternalURL 參數會指定用來從防火牆內部連線至虛擬目錄的 URL。

此設定在使用 SSL 時很重要。您必須設定此參數，以允許自動探索服務傳回 ECP 虛擬目錄的 URL。

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Path

Path 參數會設定 ECP 虛擬目錄的檔案系統路徑。只有在您必須使用與預設不同的檔案系統路徑時，才應該小心使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Role

Role 參數會建立虛擬目錄的組態。有效值為：

ClientAccess：設定信箱伺服器上用戶端存取 (前端) 服務的虛擬目錄。
信箱：設定信箱伺服器上後端服務的虛擬目錄。

用戶端連線會從用戶端存取服務代理到本機或遠端信箱伺服器上的後端服務。 Clients don't connect directly to the backend services.

Type:	VirtualDirectoryRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Server 參數會指定裝載虛擬目錄的 Exchange 伺服器。您可以使用唯一識別伺服器的任何值。例如：

Name
FQDN
辨別名稱 (DN)
ExchangeLegacyDN

您無法從遠端建立 ECP 虛擬目錄。您只能在本機電腦上建立 ECP 虛擬目錄。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WebSiteName

WebSiteName 參數會指定建立 ECP 虛擬目錄的 IIS 網站名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf 參數會模擬命令的動作。使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。您不需要使用此參數指定值。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。