New-EcpVirtualDirectory
內部部署 Exchange 才有提供此 Cmdlet。
使用 New-EcpVirtualDirectory Cmdlet 建立 Exchange 控制台 (ECP) Exchange 伺服器上 Internet Information Services (IIS) 中使用的虛擬目錄Microsoft。 這是當您在組織中安裝 Exchange 時，Microsoft Exchange Server 設定所執行的命令。 ECP 虛擬目錄會管理 Exchange 系統管理中心。
ECP Web 管理介面是在 Exchange Server 2010 中引進。 在 Exchange Server 2013 和 Exchange Server 2016 中，EAC 虛擬目錄和對應的管理 Cmdlet 仍然在名稱中使用 ECP。 您可以使用這些 Cmdlet 來管理 Exchange 2010、Exchange 2013 和 Exchange 2016 伺服器上的 ECP 虛擬目錄。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
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 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 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
此範例會在 Exchange 伺服器上建立名為 Server01 的 ECP 虛擬目錄。
參數
-AppPoolId
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
AppPoolId 參數會設定執行 ECP 虛擬目錄的 IIS 應用程式集區。 我們建議您將這個參數保留為其預設設定。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExtendedProtectionFlags
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExtendedProtectionFlags 參數會指定虛擬目錄上驗證擴充保護的自訂設定。 有效值為：
- 無：這是預設的設定。
- AllowDotlessSPN：如果要使用服務主體名稱 (SPN) 不包含 FQDN 的值，則為必要 (例如 HTTP/ContosoMail 而不是 HTTP/mail.contoso.com) 。 您可以使用 ExtendedProtectionSPNList 參數指定 SPN。 此設定會降低驗證的延伸保護安全性，因為無點憑證並不是唯一的，因此無法確保透過安全通道建立用戶端對 Proxy 的連線。
- NoServiceNameCheck：不會檢查 SPN 清單以驗證通道繫結權杖。 此設定會降低驗證的延伸保護安全性。 通常不建議使用此設定。
- Proxy：Proxy 伺服器負責終止 TLS 通道。 若要使用此設定，您必須使用 ExtendedProtectionSPNList 參數來註冊 SPN。
- ProxyCoHosting：HTTP 和 HTTPS 流量可能正在存取虛擬目錄，並且 Proxy 伺服器至少位於部分用戶端和 Exchange 伺服器上的用戶端存取服務之間。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExtendedProtectionSPNList
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExtendedProtectionSPNList 參數會指定有效的服務主體名稱清單 (SPN，) 如果您正在虛擬目錄上使用延伸保護進行驗證。 有效值為：
- $null：此值為預設值。
- 有效 SPN 的單一 SPN 或逗號分隔清單： SPN 值格式為
Protocol\FQDN。 例如，HTTP/mail.contoso.com。 若要新增非 FQDN (的 SPN，例如 HTTP/ContosoMail) ，您也需要針對 ExtendedProtectionFlags 參數使用 AllowDotlessSPN 值。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExtendedProtectionTokenChecking
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExtendedProtectionTokenChecking 參數會指定是否將驗證擴充保護用於用戶端連線至虛擬目錄。 有效值為：
- 無：驗證擴充保護不用於用戶端連線至虛擬目錄。 此值為預設值。
- 允許：如果用戶端和伺服器都支援驗證擴充保護，則驗證擴充保護用於用戶端連線至虛擬目錄。
- 需要：用戶端連線至虛擬目錄時，需要驗證擴充保護。 如果用戶端或伺服器不支援，連線就會失敗。 這個值也需要 ExtendedProtectionSPNList 參數的服務主體名稱 (SPN) 值。
注意：如果 Exchange 伺服器前面的 Proxy 伺服器終止用戶端對 Proxy 傳輸層安全性 (TLS) 通道，則 ExtendedProtectionSPNList 參數的 [允許] 或 [要求] 值需要一個或多個 SPN 值。
參數屬性
| 類型: | ExtendedProtectionTokenCheckingMode |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExternalUrl
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExternalURL 參數會指定從防火牆外部連線至虛擬目錄的 URL。
當傳輸層安全性 (TLS) 加密連線時，此參數的值非常重要。
您必須為此參數指定值，以允許自動探索服務傳回 ECP 虛擬目錄的 URL。
參數屬性
| 類型: | Uri |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InternalUrl
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
InternalURL 參數會指定從防火牆內部連線至虛擬目錄的 URL。
當傳輸層安全性 (TLS) 加密連線時，此參數的值非常重要。
您必須為此參數指定值，以允許自動探索服務傳回 ECP 虛擬目錄的 URL。
參數屬性
| 類型: | Uri |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Path 參數會設定 ECP 虛擬目錄的檔案系統路徑。 此參數應謹慎使用，並且只有在必須使用與預設值不同的檔案系統路徑時才使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Role
適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Role 參數可指定虛擬目錄的設定。 有效值為：
- ClientAccess：在信箱伺服器上設定用戶端存取 (前端) 服務的虛擬目錄。
- 信箱：在信箱伺服器上設定後端服務的虛擬目錄。
用戶端連線會從用戶端存取服務 proxy 至本機或遠端信箱伺服器上的後端服務。 Clients don't connect directly to the backend services.
參數屬性
| 類型: | VirtualDirectoryRole |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Server
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 參數指定裝載虛擬目錄的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- ExchangeLegacyDN
您無法從遠端建立 ECP 虛擬目錄。 您只能在本機電腦上建立 ECP 虛擬目錄。
參數屬性
| 類型: | ServerIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WebSiteName
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
WebSiteName 參數會指定建立 ECP 虛擬目錄的 IIS 網站名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
Input types
若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。