New-OabVirtualDirectory
內部部署 Exchange 才有提供此 Cmdlet。
使用 New-OABVirtualDirectory Cmdlet 建立離線通訊錄 (OAB) Exchange 伺服器上 Internet Information Services (IIS) 中使用的虛擬目錄Microsoft。 OAB 虛擬目錄會將伺服器設定為離線通訊錄 (OAB) 的 Web 發佈點。 一般而言,您會在已安裝用戶端存取伺服器角色的 Exchange 伺服器上建立虛擬目錄。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
New-OabVirtualDirectory
[-Confirm]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalUrl <Uri>]
[-InternalUrl <Uri>]
[-Path <String>]
[-PollInterval <Int32>]
[-Recovery]
[-RequireSSL <Boolean>]
[-Role <VirtualDirectoryRole>]
[-Server <ServerIdParameter>]
[-WebSiteName <String>]
[-WhatIf]
[<CommonParameters>]
Description
New-OABVirtualDirectory Cmdlet 會設定 OAB 的 Web 發佈點,並建立 OAB 虛擬目錄。
您必須在裝載 OAB 檔案的伺服器上手動建立檔案系統資料夾。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-OABVirtualDirectory -Server CASServer01 -PollInterval 120
此範例會在 CASServer01 上建立 OAB 虛擬目錄,並將發佈服務設定為每隔兩小時輪詢產生伺服器。
參數
-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。
參數屬性
| 類型: | 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。
參數屬性
| 類型: | 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 |
-PollInterval
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
PollInterval 參數會指定發佈服務輪詢離線通訊錄產生伺服器以取得更新的時間間隔,以分鐘為單位。 預設值為 480 分鐘 (8 小時) 。
參數屬性
| 類型: | Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Recovery
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequireSSL
適用項目:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
RequireSSL 參數會指定連線至虛擬目錄的用戶端連線是否需要傳輸層安全性 (TLS) 加密。 有效值為:
- $true:需要 TLS 加密才能連線到虛擬目錄。 此值為預設值。
- $false:連線到虛擬目錄不需要 TLS 加密。
參數屬性
| 類型: | Boolean |
| 預設值: | 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
參數屬性
| 類型: | 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。