New-OwaVirtualDirectory

 

適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間: 2010-02-25

New-OWAVirtualDirectory 指令程式會在執行 Microsoft Exchange Server 2007 的電腦上,於現有的網際網路資訊服務 (IIS) 網站中建立新的 Outlook Web Access 虛擬目錄。

語法

New-OwaVirtualDirectory [-Name <String>] [-ApplicationRoot <String>] [-AppPoolId <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-OwaVersion <Exchange2003or2000 | Exchange2007>] [-Path <String>] [-TemplateInstance <PSObject>] [-VirtualDirectoryType <NotSpecified | Mailboxes | PublicFolders | Exchweb | Exadmin>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

依預設,當安裝 Exchange 2007 時,在執行 Microsoft Exchange 的本機伺服器的預設 IIS 網站中會建立下列 Outlook Web Access 虛擬目錄:

  • Owa   Exchange 2007 Outlook Web Access 虛擬目錄。

  • Exchange   傳統的 Outlook Web Access 虛擬目錄,在執行 Exchange Server 2003 或 Exchange 2000 Server 的伺服器上具有信箱的使用者可存取此目錄。

  • Public   傳統的 Outlook Web Access 虛擬目錄,此目錄會指向執行 Exchange 2003 或 Exchange 2000 的伺服器上的公用資料夾。

  • Exchweb   傳統的 Outlook Web Access 虛擬目錄,可供使用者用來存取 Outlook Web Access 虛擬目錄。依預設,對 exchweb 虛擬目錄提出的要求會傳送至使用者的信箱伺服器。

    note附註:
    一般來說,如果因為業務上的特殊需要而要求其他的虛擬目錄,如主控或進行 Outlook Web Access 疑難排解工作 (如刪除及重新建立 Outlook Web Access 虛擬目錄),您可以使用 New-OWAVirtualDirectory 指令程式。

New-OwaVirtualDirectory 指令程式必須在 Exchange 2007 伺服器上執行,該伺服器主控您想要用來主控新虛擬目錄的 Client Access server role。您使用的帳戶必須已獲委派 Exchange Server Administrator 角色及目標伺服器本機 Administrators 群組的成員資格。

如需管理 Exchange 2007 所需之權限、委派角色及權利的相關資訊,請參閱權限考量

參數

參數 必要 類型 描述

ApplicationRoot

選用

System.String

此參數設定 Metabase 中之虛擬目錄的路徑。

note附註:
尚未執行此參數。

AppPoolId

選用

System.String

此參數設定執行 Outlook Web Access 的 IIS 應用程式集區。最佳作法是保留此參數的預設值。

Confirm

選用

System.Management.Automation.SwitchParameter

此參數會使得命令暫停處理,並要求您確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

此參數指定從 Active Directory 目錄服務擷取資料的網域控制站的網域全名 (FQDN)。

ExternalAuthenticationMethods

選用

Microsoft.Exchange.Data.MultiValuedProperty

此參數 (服務探索內容設定) 指定 Exchange 伺服器上支援對於來自防火牆外的驗證方法。

note附註:
尚未執行此參數,但是可以使用 Set-OwaVirtualDirectory 來設定。

ExternalUrl

選用

System.Uri

此參數指定用來從防火牆外連接到 Exchange 伺服器的主機名稱。此設定在使用安全通訊端層 (SSL) 時也很重要。

note附註:
您只能在 Exchange 2007 虛擬目錄上設定此設定。預設的 Exchange 2007 虛擬目錄為 /owa。

InternalUrl

選用

System.Uri

此參數指定主控從防火牆內連線之 Exchange 伺服器的主機名稱。此設定在使用 SSL 時也很重要。

note附註:
您只能在 Exchange 2007 虛擬目錄上設定此設定。預設的 Exchange 2007 虛擬目錄為 /owa。

Name

選用

System.String

此參數指定 Outlook Web Access 虛擬目錄的名稱 (如果 Outlook Web Access 虛擬目錄位於執行 Exchange 2003 或 Exchange 2000 的伺服器上)。

如果 Outlook Web Access 虛擬目錄位於 Exchange 2007 伺服器上,則會忽略此參數。

OWAVersion

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.OwaVersions

此參數指定 Outlook Web Access 虛擬目錄的版本是否為 Exchange 2007、Exchange 2003 或 Exchange 2000。

Path

選用

System.String

此參數會設定虛擬目錄的檔案系統路徑。此參數應小心使用,只有在必須使用非預設的檔案系統路徑時才使用此參數。

TemplateInstance

選用

System.Management.Automation.PSObject

此參數指定將現有的物件提供給此參數時,指令程式會使用該物件的組態,在本機或目標伺服器上建立該物件完全相同的副本。

note附註:
尚未執行此參數。

VirtualDirectoryType

選用

Microsoft.Exchange.Data.Directory.SystemConfiguration.VirtualDirectoryTypes

此參數指定 Outlook Web Access 虛擬目錄指向信箱、公用資料夾或 exchweb。如果 Outlook Web Access 虛擬目錄位在 Exchange 2003 或 Exchange 2000 伺服器上,則需要此參數。

如果 Outlook Web Access 虛擬目錄位於 Exchange 2007 伺服器上,則會忽略此參數。

WebSiteName

選用

System.String

此參數指定在其中建立 Outlook Web Access 虛擬目錄之 IIS 網站的名稱。

WhatIf

選用

System.Management.Automation.SwitchParameter

此參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下例程式碼範例會在本機 Exchange 伺服器的非預設 IIS 網站 (名為 "contoso.com") 中建立名為 "exchange"、"public" 及 "exchweb" 的一組新 Outlook Web Access 傳統虛擬目錄。

New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Mailboxes -Name "exchange" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType PublicFolders -Name "public" -WebSiteName "Contoso.com"
New-OWAVirtualDirectory -OwaVersion:Exchange2003or2000 -VirtualDirectoryType Exchweb -Name "exchweb" -WebSiteName "Contoso.com"