Set-OutlookAnywhere

模組:
Exchange PowerShell

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

使用 Set-OutlookAnywhere Cmdlet 修改 Exchange 伺服器上 Internet Information Services (IIS) 中使用的 Outlook Anywhere 虛擬目錄Microsoft。 Outlook Anywhere 使用名稱中包含 “rpc” 的虛擬目錄。

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

語法

Default (預設值) 

Set-OutlookAnywhere
    [-Identity] <VirtualDirectoryIdParameter>
    [-ClientAuthenticationMethod <AuthenticationMethod>]
    [-Confirm]
    [-DefaultAuthenticationMethod <AuthenticationMethod>]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalClientAuthenticationMethod <AuthenticationMethod>]
    [-ExternalClientsRequireSsl <Boolean>]
    [-ExternalHostname <Hostname>]
    [-IISAuthenticationMethods <MultiValuedProperty>]
    [-InternalClientAuthenticationMethod <AuthenticationMethod>]
    [-InternalClientsRequireSsl <Boolean>]
    [-InternalHostname <String>]
    [-Name <String>]
    [-SSLOffloading <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

如需本文中可以看到的不同驗證方法的詳細資訊，請參閱 了解 HTTP 驗證。

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

範例

範例 1

Set-OutlookAnywhere -Identity:CAS01\Rpc (Default Web Site) -ClientAuthenticationMethod:Ntlm

在 Exchange 2010 中，此範例會針對用戶端存取伺服器 CAS01 上的 /rpc 虛擬目錄，將用戶端驗證方法設定為 NTLM。

範例 2

Set-OutlookAnywhere -Identity: "EXCH1\rpc (Default Web Site)" -ExternalClientAuthenticationMethod NTLM

此範例會針對伺服器 EXCH1 上的 Outlook Anywhere 虛擬目錄，將用戶端驗證方法設定為 NTLM。

範例 3

Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -SSLOffloading $false -InternalClientsRequireSsl $true -ExternalClientsRequireSsl $true

此範例會針對伺服器 EXCH1 上的 Outlook Anywhere 虛擬目錄，將 SSLOffloading 參數設定為 $false。 此設定會通知 Outlook Anywhere 預期用戶端和伺服器之間不會有 TLS 解密，並在虛擬目錄上啟用 [需要 SSL] 設定。 由於現在 Outlook Anywhere 連線需要 TLS，因此我們需要設定內部和外部用戶端以使用 TLS。

範例 4

Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -IISAuthenticationMethods NTLM

此範例會將 IIS 中的 Outlook Anywhere 虛擬目錄設定的驗證方法設定為 NTLM。

範例 5

Set-OutlookAnywhere -Identity "EXCH1\rpc (Default Web Site)" -IISAuthenticationMethods Basic,NTLM

在 Exchange 2010 和 Exchange 2013 中，本範例會設定 IIS 中 /rpc 虛擬目錄設定的可用驗證方法，以使用基本和 NTLM 驗證。 設定此值之後，您可以使用 IIS 虛擬目錄來處理需要不同驗證方法的多個應用程式驗證。

參數

-ClientAuthenticationMethod

適用：Exchange Server 2010

ClientAuthenticationMethod 參數會指定自動探索服務提供給 Outlook Anywhere 用戶端的驗證方法，用以向用戶端存取伺服器驗證。 有效值為：

  • Basic
  • NTLM

雖然您可以使用此參數只設定一種驗證方法，但如果您包含多個值，命令不會傳回錯誤。

參數屬性

類型:AuthenticationMethod
預設值: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

-DefaultAuthenticationMethod

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DefaultAuthenticationMethod 參數會指定 Outlook Anywhere 的預設驗證方法。 此參數會以您指定的值取代現有的 ExternalClientAuthenticationMethod、InternalClientAuthenticationMethod 及 IISAuthenticationMethods 屬性值。 有效值為：

  • Basic
  • NTLM
  • 交涉

您無法將此參數與 ExternalClientAuthenticationMethod、InternalClientAuthenticationMethod 和 IISAuthenticationMethods 參數搭配使用。

參數屬性

類型:AuthenticationMethod
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(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

-ExternalClientAuthenticationMethod

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExternalClientAuthenticationMethod 參數會指定用來驗證外部 Outlook Anywhere 用戶端的驗證方法。 有效值為：

  • Basic
  • NTLM
  • 協商預設值 ()

您無法將此參數與 DefaultAuthenticationMethods 參數搭配使用。

參數屬性

類型:AuthenticationMethod
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExternalClientsRequireSsl

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExternalClientsRequireSsl 參數會指定外部 Outlook Anywhere 用戶端是否必須使用傳輸層安全性 (TLS) 。 有效值為：

  • $true：從組織外部透過 Outlook Anywhere 連線的用戶端必須使用 TLS。
  • $false：從組織外部透過 Outlook Anywhere 連線的用戶端不需要使用 TLS。 此值為預設值。

此參數的值與 SSLOffloading 參數的值相關。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExternalHostname

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExternalHostname 參數會指定 Outlook Anywhere 虛擬目錄的外部主機名稱。 例如，mail.contoso.com。

參數屬性

類型:Hostname
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

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

參數屬性

類型:VirtualDirectoryIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IISAuthenticationMethods

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

IISAuthenticationMethods 參數會指定 IIS 中 Outlook Anywhere 虛擬目錄上所使用的驗證方法。 有效值為：

  • Basic
  • NTLM
  • 交涉

您可以指定多個值，並以逗號分隔。 根據預設，會使用所有值。

您無法將此參數與 DefaultAuthenticationMethods 參數搭配使用。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InternalClientAuthenticationMethod

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

InternalClientAuthenticationMethod 參數會指定用來驗證內部 Outlook Anywhere 用戶端的驗證方法。 有效值為：

  • Basic
  • Ntlm (預設值)
  • 交涉

您無法將此參數與 DefaultAuthenticationMethods 參數搭配使用。

參數屬性

類型:AuthenticationMethod
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InternalClientsRequireSsl

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

InternalClientsRequireSsl 參數會指定內部 Outlook Anywhere 用戶端是否必須使用傳輸層安全性 (TLS) 。 有效值為：

  • $true：從組織內部透過 Outlook Anywhere 連線的用戶端必須使用 TLS。
  • $false：從組織內部透過 Outlook Anywhere 連線的用戶端不需要使用 TLS。 此值為預設值。

此參數的值與 SSLOffloading 參數的值相關。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InternalHostname

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

InternalHostname 參數指定 Outlook Anywhere 虛擬目錄的內部主機名稱。 例如，mail.contoso.com。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Name 參數會指定 Outlook Anywhere 虛擬目錄的名稱。 預設值為 [Rpc] ([預設網站) ]。 如果您指定的值包含空格，請將值括在引號中 (“) 。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SSLOffloading

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

SSLOffloading 參數會指定網路裝置是否接受傳輸層安全性 (TLS) 連線，並在 Proxy 連線到 Exchange 伺服器上的 Outlook Anywhere 虛擬目錄之前對其進行解密。 有效值為：

  • $true：使用 TLS 的 Outlook Anywhere 用戶端不會沿著整個網路路徑維護 TLS 連線到 Exchange 伺服器。 伺服器前面的網路裝置將解密 TLS 連線，並將未加密的 (HTTP) 用戶端連線代理到 Outlook Anywhere 虛擬目錄。 使用 HTTP 的網路區段應該是安全的網路。
  • $false：使用 TLS 的 Outlook Anywhere 用戶端會沿著整個網路路徑維護 TLS 連線到 Exchange 伺服器。 只允許 TLS 連線到 Outlook Anywhere 虛擬目錄。 此值為預設值。

此參數用於設定 Outlook Anywhere 虛擬目錄上的「需要 SSL」設定。 當您將此參數設為 $true 時，系統會停用「需要 SSL」。 當您將此參數設定為 $false 時，會啟用「需要 SSL」。 不過，可能需要數分鐘的時間，變更才會顯示在 IIS 管理員中。

如果您不需要內部或外部 Outlook Anywhere 用戶端的 TLS 連線，則需要使用此參數的值$true。

此參數的值與 ExternalClientsRequireSsl 和 InternalClientsRequireSsl 參數的值相關。

參數屬性

類型:Boolean
預設值: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

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