Set-WebServicesVirtualDirectory

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

使用 Set-WebServicesVirtualDirectory Cmdlet 來修改 Internet Information Services 中使用的現有 Exchange Web 服務虛擬目錄, (Microsoft Exchange 伺服器上的 IIS) 。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

Set-WebServicesVirtualDirectory
   [-Identity] <VirtualDirectoryIdParameter>
   [-BasicAuthentication <Boolean>]
   [-CertificateAuthentication <Boolean>]
   [-Confirm]
   [-DigestAuthentication <Boolean>]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalUrl <Uri>]
   [-Force]
   [-GzipLevel <GzipLevel>]
   [-InternalNLBBypassUrl <Uri>]
   [-InternalUrl <Uri>]
   [-MRSProxyEnabled <Boolean>]
   [-MRSProxyMaxConnections <Unlimited>]
   [-OAuthAuthentication <Boolean>]
   [-WhatIf]
   [-WindowsAuthentication <Boolean>]
   [-WSSecurityAuthentication <Boolean>]
   [<CommonParameters>]

Description

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

範例

範例 1

Set-WebServicesVirtualDirectory -Identity Contoso\EWS(Default Web Site) -ExternalUrl https://www.contoso.com/EWS/exchange.asmx -BasicAuthentication $true -InternalUrl https://contoso.internal.com/EWS/exchange.asmx

此範例會將伺服器 Contoso 上虛擬目錄 EWS 的驗證方法設為基本驗證。 此範例也會設定此虛擬目錄的外部和內部 URL。

範例 2

Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/EWS/exchange.asmx

此範例會使用萬用字元,而非範例 1 中使用的「Default Web 網站」。

範例 3

Set-WebServicesVirtualDirectory -Identity "EWS (Default Web Site)" -MRSProxyEnabled $true

此範例會在 EWS 預設網站上啟用 MRSProxy。 MRSProxy 是負責協助遠端信箱移動的服務。

參數

-BasicAuthentication

BasicAuthentication 參數會指定是否在虛擬目錄上啟用基本驗證。 有效值為:

  • $true:已啟用基本驗證。 這是預設值。
  • $true:啟用基本驗證。此為預設值。
Type:Boolean
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

-CertificateAuthentication

CertificateAuthentication 參數會指定是否啟用憑證驗證。 此參數會影響 <Servername>/ews/management/ 虛擬目錄。 它不會影響 <Servername>/ews/ 虛擬目錄。

Type:Boolean
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

-DigestAuthentication

DigestAuthentication 參數會指定是否在虛擬目錄上啟用摘要式驗證。 有效值為:

  • $true:已啟用摘要式驗證。
  • $false:已停用摘要式驗證。 這是預設值。
Type:Boolean
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) 時很重要。

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

-Force

Force 參數會隱藏警告或確認訊息。 您不需要使用此參數指定值。

在不適合提示系統管理員輸入的場合中,您可以使用此參數來利用程式設計方式執行工作。

Type:SwitchParameter
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

-GzipLevel

GzipLevel 參數會設定 Exchange Web 服務虛擬目錄的 Gzip 設定。 有效值為:

  • 關閉:無壓縮。
  • 低:僅限靜態壓縮。 這是預設值。 此值的結果與 Off 值相同,因為 Exchange Web Services 內容是動態的。
  • 高:靜態和動態壓縮。 如果用戶端在其要求中表示支援 Gzip 壓縮,則會壓縮 Exchange Web 服務的內容。
  • 錯誤:識別 Gzip 壓縮組態中的錯誤。
Type:GzipLevel
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

-Identity

Identity 參數會指定您要修改的 EWS 虛擬目錄。 您可以使用任何可唯一識別虛擬目錄的值。 例如:

  • 名稱或伺服器名稱
  • 辨別名稱 (DN)
  • GUID

Name 值會使用來自虛擬目錄屬性的語法 "VirtualDirectoryName (WebsiteName)" 。 您可以使用 語 VirtualDirectoryName* 法來指定萬用字元 (*) ,而不是預設網站。

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

-InternalNLBBypassUrl

注意: 此參數僅適用于 Exchange 2010。 根據預設,Exchange 2013 或更新版本已經在後端 Exchange Web 服務上設定 InternalNLBBypassUrl 值, (信箱伺服器上的 EWS) 虛擬目錄。

InternalNLBBypassUrl 參數會指定已安裝用戶端存取伺服器角色的 Exchange 伺服器 URL,不論其是否位於 NLB) 陣列 (網路負載平衡後方。

當您設定 InternalUrl NLB 陣列的 url 參數時,您應該設定 InternalNLBBypassUrl 參數的 Client Access Server 本身的 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 時很重要。

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

-MRSProxyEnabled

MRSProxyEnabled 參數會指定是否要針對已安裝 Client Access 伺服器角色的 Exchange 伺服器上的 Exchange Web 服務虛擬目錄啟用 MRSProxy。 MRSProxy 可協助 Proxy 信箱在 Active Directory 樹系之間移動。 預設值為 $false。

Type:Boolean
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

-MRSProxyMaxConnections

此參數僅適用于 2010 Exchange Server。

MRSProxyMaxConnections 參數會指定 MRSProxy 實例將接受的同時移動會話數目上限。 此設定接受從 0 到無限制的值。 預設值為 100。 如需 MRSProxy 的詳細資訊,請 參閱瞭解移動要求

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-OAuthAuthentication

OAuthAuthentication 參數會指定是否已在虛擬目錄上啟用 OAuth 驗證。 有效值為:

  • $true:已啟用 OAuth 驗證。 這是預設值。
  • $false:已停用 OAuth 驗證。
Type:Boolean
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

-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

-WindowsAuthentication

WindowsAuthentication 參數會指定是否在虛擬目錄上啟用整合Windows 驗證。 有效值為:

  • $true:已啟用整合Windows 驗證。 這是預設值。
  • $false:已停用整合Windows 驗證。
Type:Boolean
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

-WSSecurityAuthentication

WSSecurityAuthentication 參數會指定是否在虛擬目錄上啟用WS-Security (Web 服務安全性) 驗證。 有效值為:

  • $true:啟用WS-Security驗證。 這是預設值。
  • $true:啟用 WS-Security 驗證。此為預設值。
Type:Boolean
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

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