New-ActiveSyncVirtualDirectory
內部部署 Exchange 才有提供此 Cmdlet。
使用 New-ActiveSyncVirtualDirectory Cmdlet 建立Exchange ActiveSync虛擬目錄，供 Microsoft Exchange 伺服器上的 Internet Information Services (IIS) 中使用。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
New-ActiveSyncVirtualDirectory
[-ApplicationRoot <String>]
[-AppPoolId <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalAuthenticationMethods <MultiValuedProperty>]
[-ExternalUrl <Uri>]
[-InstallProxySubDirectory <Boolean>]
[-InternalAuthenticationMethods <MultiValuedProperty>]
[-InternalUrl <Uri>]
[-Path <String>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-WhatIf]
[<CommonParameters>]
Description
New-ActiveSyncVirtualDirectory Cmdlet 會在指定網站下的指定伺服器上建立Exchange ActiveSync虛擬目錄。 建立的 Exchange ActiveSync 虛擬目錄名為 Microsoft-Server-ActiveSync。 每個 Exchange ActiveSync 網站中只能有一個 Exchange ActiveSync 虛擬目錄。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/Microsoft-Server-ActiveSync
此範例會建立 Exchange ActiveSync 虛擬目錄，並指定用來連線至虛擬目錄的外部 URL。
範例 2
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/mail -InternalUrl https://contoso/mail
此範例會建立 Exchange ActiveSync 虛擬目錄，並指定用來連線至虛擬目錄的外部與內部 URL。
範例 3
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl "https://www.fourthcoffee.com/Microsoft-Server-ActiveSync"
本範例為 Fourth Coffee 公司建立 Exchange ActiveSync 虛擬目錄。
參數
-ApplicationRoot
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ApplicationRoot 參數會指定虛擬目錄的 Metabase 路徑。 此預設路徑與網站建立的虛擬目錄相同。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-AppPoolId
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
AppPoolId 參數會指定虛擬目錄執行所在的 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 |
-ExternalAuthenticationMethods
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExternalAuthenticationMethods 參數會限制可用於從防火牆外部連線到虛擬目錄的驗證方法。 有效值為：
- ADFS
- Basic
- 憑證
- 摘要
- FBA
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- 交涉
- NTLM
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
雖然您可以指定其中任何一個值，但驗證方法是否真的適用於外部連線取決於其他因素。 例如：
- 雖然您可以指定以上任何值，不過驗證方法在實際上是否適用於內部連線乃取決於其他因素。例如：
- 虛擬目錄上是否有可用的驗證方法？
預設值為空白 ($null)，這表示會接受所有可用的驗證方法。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | 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。
參數屬性
| 類型: | Uri |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InstallProxySubDirectory
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
InstallProxySubDirectory 參數可用來建立子目錄，以 Proxy 處理與 Exchange 2007 的 ActiveSync 連線。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InternalAuthenticationMethods
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
InternalAuthenticationMethods 參數限制可用於從防火牆內部連線到虛擬目錄的驗證方法。 有效值為：
- ADFS
- Basic
- 憑證
- 摘要
- FBA
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- 交涉
- NTLM
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
雖然您可以指定其中任何一個值，但驗證方法是否真的適用於內部連線取決於其他因素。 例如：
- 雖然您可以指定以上任何值，不過驗證方法在實際上是否適用於內部連線乃取決於其他因素。例如：
- 虛擬目錄上是否有可用的驗證方法？
預設值為空白 ($null)，這表示會接受所有可用的驗證方法。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | 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。
參數屬性
| 類型: | 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 參數會指定虛擬目錄的檔案系統路徑。 我們建議您唯有虛擬目錄檔案需要使用自訂位置時，再使用此參數。 預設值是空白 ($null)，表示使用預設位置。
參數屬性
| 類型: | 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 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server 參數指定裝載虛擬目錄的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如：
- Name
- FQDN
- 辨別名稱 (DN)
- ExchangeLegacyDN
參數屬性
| 類型: | 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 參數會指定虛擬目錄建立所在地的 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。