如何將虛擬目錄新增至應用程式

本主題描述如何使用 BTSTask 命令列工具，將虛擬目錄加入到 BizTalk 應用程式。 BizTalk Server 管理主控台上無法使用這個選項。 如果您已經撰寫自訂 Web 服務或建立 ASP.NET 網站來與 BizTalk Server 互動，而且您想要搭配此應用程式部署虛擬目錄，此時您可能會想要新增虛擬目錄。

將虛擬目錄新增至應用程式的另一種方式是指定 SOAP 或 HTTP 接收位置的虛擬目錄，如 如何設定 HTTP 接收位置中所述。 在所有情況下，此虛擬目錄都會加入到 BizTalk 管理資料庫。 當您使用命令列新增虛擬目錄時，它也會顯示在 [BizTalk Server管理主控台] 的 [資源] 資料夾中，當您使用ListApp 命令時，將它新增至應用程式的 [資源] 資料夾，以及應用程式中的成品清單。 如果您之後匯出此應用程式，然後將它匯入到另一個 BizTalk 群組，則此虛擬目錄會顯示在 [資源] 資料夾中。

當您將虛擬目錄加入到應用程式時，請牢記下列要點：

• 您可以覆寫應用程式中現有的虛擬目錄，只要指定覆寫選項即可。 只有在現有虛擬目錄的名稱與您要新增的虛擬目錄相同時，才需要覆寫選項。 如果未指定，且虛擬目錄已存在於與所新增相同名稱的應用程式中，則新增作業將會失敗。

• 如果您要加入之虛擬目錄的 URL 包含 https，指定 URL 時必須改用 http 代替 https。 若是使用 https，虛擬目錄加入作業將會失敗。 雖然您在 URL 中使用 http 來加入，Internet Information Services Metabase 仍會沿用 URL 的 https 設定使之生效，因此虛擬目錄將可正常運作。

• 如果您所加入的虛擬目錄來自 64 位元版的 Web 服務，而您試圖將含有該虛擬目錄的應用程式安裝於 32 位元電腦，屆時將不會安裝該虛擬目錄。 它必須安裝在 64 位元電腦上。

重要

當您匯入包含虛擬目錄的應用程式時，該虛擬目錄上的安全性設定就是在應用程式匯出期間產生 .msi 檔案時生效的那些安全性設定。 如果您將應用程式部署到實際執行環境，則在匯出應用程式之前，應該驗證設定是否符合安全性需求。

如果目的地環境中已經有虛擬目錄存在，則現有虛擬目錄上的安全性設定將會生效。 這些設定不會為了要與您部署之虛擬目錄上的設定相符而變更。 在此情況下，您應該驗證現有虛擬目錄上的安全性設定是否符合您的需求。

警告

如果虛擬目錄使用的是 HTTPS (超文字安全傳輸通訊協定) 通訊協定，則在匯出期間不會保留其安全性設定，而且在匯入時，虛擬目錄會繼承根目錄的安全性設定。 您應該驗證這些安全性設定是否符合您的需求。

必要條件

若要執行這個主題中的程序，您必須使用「BizTalk Server 系統管理員」群組成員的帳戶登入。 如需許可權的詳細資訊，請參閱 部署和管理 BizTalk 應用程式所需的許可權。

若要將虛擬目錄加入至應用程式

1. 開啟命令提示字元，如下所示：按一下 [ 開始]，按一下 [ 執行]，輸入 cmd ，然後按一下 [ 確定]。

2. 輸入下列命令，並以適當的值替代，如下表所述：

   BTSTask AddResource [/ApplicationName：value] /Type：System.BizTalk：WebDirectory[/Overwrite] /Source：value [/Destination：value] [/Server：value] [/Database：value]

   範例：

   BTSTask AddResource /ApplicationName：MyApplication /Type： System.BizTalk：WebDirectory /Overwrite /Source： http://Host1:90/MyVirtualDirectory /Destination http://Host2:90/MyVirtualDirectory ： /Server：MyDatabaseServer /Database：BizTalkMgmtDb

   參數	值
   /ApplicationName	加入虛擬目錄的 BizTalk 應用程式名稱。 若未指定應用程式名稱，將使用群組預設的 BizTalk 應用程式。 如果名稱包含空格，您必須將它括在雙引號 (") 中。
   /類型	System.BizTalk：WebDirectory (此值不區分大小寫。)
   /覆蓋	更新現有虛擬目錄的選項。 若未指定此選項，且應用程式中現有的虛擬目錄與所加入的虛擬目錄同名，AddResources 作業將會失敗。
   /源	來源虛擬目錄的 URI。
   /目的地	從 .msi 檔案安裝應用程式時，指派給虛擬目錄的 URI。 若未指定此參數，將使用 Source 參數的值並以 localhost 做為主控件。
   /伺服器	裝載 BizTalk 管理資料庫之 SQL Server 執行個體的名稱，其格式為：伺服器名稱\執行個體名稱,連接埠。 只有在執行個體名稱和伺服器名稱不同時，才需要執行個體名稱。 只有在 SQL Server 使用預設值 (1433) 以外的連接埠編號時，才需要連接埠。 範例： Server=MyServer Server=MyServer\MySQLServer,1533 如果不提供，將會使用在本機電腦上執行的 SQL Server 執行個體的名稱。
   /資料庫	BizTalk 管理資料庫的名稱。 如果沒有指定，將會使用在 SQL Server 本機執行個體中執行的 BizTalk 管理資料庫。

另請參閱

管理 .NET 組件、憑證和其他資源
AddResource 命令：虛擬目錄
建立和修改 BizTalk 應用程式