Set-WebServicesVirtualDirectory
適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間： 2011-06-21
Set-WebServicesVirtualDirectory 指令程式可讓您在已安裝 Client Access server role 的 Exchange 2007 電腦上修改現有的 Exchange Web 服務虛擬目錄。
語法
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-WebServicesVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADWebServicesVirtualDirectory>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
詳細描述
Set-WebServicesVirtualDirectory 指令程式可讓您在 Exchange 2007 Client Access Server 上修改現有的 Exchange Web 服務虛擬目錄。
.gif "note") 附註： |
|---|
| 如果您有 Client Access Server 的負載平衡集，則不必在執行指令程式時指定每一部伺服器的名稱。只需使用其中一個網路負載平衡伺服器的名稱就足夠。 |
若要執行 Set-WebServicesVirtualDirectory 指令程式，必須對您使用的帳戶委派 Exchange Server 系統管理員角色及目標伺服器本機 Administrators 群組的成員資格。
如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
此參數可指定虛擬目錄的名稱。您也可以指定萬用字元來代替預設網站。 |
BasicAuthentication |
選用 |
System.Boolean |
此參數可指定是否要在 Exchange Web 服務虛擬目錄上啟用基本驗證。此參數可與 FormsAuthentication 或與 DigestAuthentication 及 WindowsAuthentication 搭配使用。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。 |
DigestAuthentication |
選用 |
System.Boolean |
此參數指定是否在虛擬目錄上啟用摘要認證。 |
DomainController |
選用 |
Microsoft.Exchange.Data.Fqdn |
若要指定從 Active Directory 目錄服務擷取資料之網域控制站的網域全名 (FQDN)，請在指令程式中加入 DomainController 參數。 |
ExternalUrl |
選用 |
System.Uri |
此參數指定從防火牆外連接至 Exchange 伺服器時所用的主機名稱。此設定在使用安全通訊端層 (SSL) 時也很重要。 |
Instance |
選用 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
Instance 參數可讓您將整個物件傳遞至指令程式以進行處理。 |
InternalNLBBypassUrl |
選用 |
System.Uri |
此參數指定 Client Access Server 的 URL，即使該 Client Access Server 位於網路負載平衡器 (NLB) 後面也一樣。 |
InternalUrl |
選用 |
System.Uri |
此參數可指定從防火牆內連接至 Exchange 伺服器時所用的主機名稱。此設定在使用 SSL 時也很重要。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。 |
WindowsAuthentication |
選用 |
System.Boolean |
此參數指定 Exchange Web 服務虛擬目錄上是否允許整合式 Windows 驗證。 |
輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
例外狀況
| 例外狀況 | 描述 |
|---|---|
|
|
範例
下列程式碼範例會在 "Contoso" 伺服器上，將 "EWS" 虛擬目錄的驗證方法設為基本驗證。此程式碼範例也會設定此虛擬目錄的外部和內部 URL。
第二個程式碼範例會使用萬用字元來代替 "default Web site"。
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.asmx - BasicAuthentication $true InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.asmx
若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.