共用方式為

如何使用 WCF 配接器啟用 WCF 擴充性點

  • 發行項

使用 WCF-Custom 和 WCF-CustomIsolated 配接器，啟用三個 WCF 擴充點—行為延伸、繫結項目延伸和系結延伸。 若要這樣做，您必須先在全域組件快取中安裝實作 WCF 擴充點的元件， (GAC) ，然後修改電腦上的 machine.config 檔案，然後使用 BizTalk Server 管理主控台來設定 WCF-Custom 或 WCF-CustomIsolated 配接器。

如需 WCF 擴充點的詳細資訊，請參閱 擴充 WCF 。

必要條件

使用屬於 BizTalk Server Administrators 群組成員的帳戶登入。 部署和管理 BizTalk 應用程式所需的許可權 可提供詳細資訊。

在 GAC 中安裝實作 WCF 擴充點的元件

  1. 將實作 WCF 擴充性點的組件複製到本機電腦的資料夾。

  2. 將 WCF 擴充性點使用的組件 (如果有的話) 複製到本機電腦的資料夾。

  3. 啟動 Visual Studio 命令提示字元。

  4. 輸入以下命令：

    gacutil.exe /if 」 <元件 .dll 檔案> 的路徑」

  5. 這會將組件安裝至 GAC，覆寫任何同名的現有組件。

  6. 在 Visual Studio 命令提示字元中，針對您在此程式的步驟 1 和 2 中複製的所有元件重複步驟 4 和 5。

  7. 如果您有多部 BizTalk Server 執行階段電腦和管理電腦，請在所有電腦上重複本程序的步驟 1 到 6。

    注意

    若要啟用 WCF 配接器的 WCF 擴充性點，執行配接器的 BizTalk 主控件執行個體必須能夠在執行階段載入實作 WCF 擴充性點的組件。

設定 WCF 系結延伸模組的 machine.config 檔案

  1. 在命令提示字元中，移至 %FrameworkDir%\v4。X.XXXXX\CONFIG 資料夾，然後使用 [記事本] 開啟 machine.config 檔案。

  2. 在 [記事本] 中，如果 machine.config 檔案沒有< system.serverModel > \ < extensions >元素，請在 machine.config 檔案的組態 > 元素內新增這些專案 <，然後在system.serverModel > \ < extensions > 元素內 <新增< WCF 系結延伸的 bindingExtensions >元素。 例如，若要啟用自訂系結延伸模組 netHttpBinding，請在 machine.config 檔案的組態 > 專案內 <新增下列程式碼：

    <system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
      <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" />  
    </bindingExtensions>        
  </extensions>  
</system.serviceModel>

    注意

    • 您可以使用命令 gacutil /lr< assembly_name >來尋找要註冊的元件資訊。
    • 請參閱這個專案上的 bindingExtensions 。

  3. 在「記事本」中，儲存 machine.config 檔案。

  4. 如果您有多個BizTalk Server執行時間電腦和管理電腦，請在所有電腦上重複此程式的步驟 1 到 3。

    注意

    您必須在 WCF 基礎結構的所有電腦上重複這些步驟，以處理 BizTalk 主機實例和 BizTalk Server 管理主控台的 WCF 擴充點。

使用 BizTalk 管理主控台設定 WCF 系結延伸模組

  1. 開啟 [BizTalk Server 管理] 。

    注意

    如果BizTalk Server管理主控台已開啟，請重新開機 BizTalk Server 管理主控台。

  2. 如果您使用 WCF-Custom 配接器，請在 BizTalk Server 管理主控台中，依序展開 [平臺設定]、[主機實例]，然後重新開機執行介面卡的 BizTalk 主機實例。

  3. 如果您使用 WCF-CustomIsolated 配接器，請在 IIS 管理主控台中，重新啟動與 WCF 接收位置關聯的應用程式集區。

  4. 如果您想要設定接收位置以使用 WCF 擴充點，請在 BizTalk Server 管理主控台中，依序展開[BizTalk 群組]、< [BizTalk 應用程式 >]、[接收位置]，然後在右窗格中按兩下< [接收位置 >]。

    • 在 [ 接收位置屬性 ] 對話方塊的 [ 類型 ] 下拉式清單中，根據您要使用的 WCF 配接器，選取 [WCF-Custom ] 或 [ WCF-CustomIsolated ]，然後按一下 [ 設定]。

  5. 如果您想要將傳送埠設定為使用 WCF 擴充點，請在 [BizTalk Server 管理主控台] 中，依序展開[BizTalk 群組]、[< BizTalk 應用程式 >]、[傳送埠]，然後在右窗格中按兩下< [傳送埠 >]。

    • 在 [ 傳送埠屬性 ] 對話方塊的 [ 類型 ] 下拉式清單中，選取 [WCF-Custom]，然後按一下 [ 設定]。

  6. 在 [傳輸屬性] 對話方塊的 [ 系 結] 索引標籤上，選取系結延伸模組，然後設定傳輸的其餘設定。

  7. 在 BizTalk Server 管理主控台中，按一下 [確定] 按鈕關閉所有開啟的對話方塊，然後確定不會顯示任何錯誤訊息和錯誤的事件記錄檔。

設定 WCF 繫結項目延伸 machine.config 檔案

  1. 在命令提示字元中，移至 %FrameworkDir%\v4。X.XXXXX\CONFIG 資料夾，然後使用 [記事本] 開啟 machine.config 檔案。

  2. 在 [記事本] 中，如果 machine.config 檔案沒有< system.serverModel > \ < extensions >元素，請在 machine.config 檔案的組態 > 元素內新增這些專案 <，然後在system.serverModel > \ < extensions > 元素內新增 WCF 繫結項目延伸的 <bindingElementExtensions > 元素。 < 例如，若要啟用自訂繫結項目延伸，請卸載Interceptor，在 machine.config 檔案的組態 > 元素內 <新增下列程式碼：

    <system.serviceModel>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/>  
    </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>

    注意

    • 您可以使用命令 gacutil /lr< assembly_name >來尋找要註冊的元件資訊。
    • 請參閱這個專案上的 bindingElementExtensions 。

  3. 在「記事本」中，儲存 machine.config 檔案。

  4. 如果您有多個BizTalk Server執行時間電腦和管理電腦，請在所有電腦上重複此程式的步驟 1 到 3。

    注意

    您必須在 WCF 基礎結構的所有電腦上重複這些步驟，以處理 BizTalk 主機實例和 BizTalk Server 管理主控台的 WCF 擴充點。

使用 BizTalk 管理主控台設定 WCF 繫結項目延伸

  1. 開啟 [BizTalk Server 管理] 。

    注意

    如果BizTalk Server管理主控台已開啟，請重新開機 BizTalk Server 管理主控台。

  2. 如果您使用 WCF-Custom 配接器，請在 BizTalk Server 管理主控台中，依序展開 [平臺設定]、[主機實例]，然後重新開機執行介面卡的 BizTalk 主機實例。

  3. 如果您使用 WCF-CustomIsolated 配接器，請在 IIS 管理主控台中，重新啟動與 WCF 接收位置關聯的應用程式集區。

  4. 如果您想要設定接收位置以使用 WCF 擴充點，請在 BizTalk Server 管理主控台中，依序展開[BizTalk 群組]、< [BizTalk 應用程式 >]、[接收位置]，然後在右窗格中按兩下< [接收位置 >]。

    • 在 [ 接收位置屬性 ] 對話方塊的 [ 類型 ] 下拉式清單中，根據您要使用的 WCF 配接器，選取 [WCF-Custom ] 或 [ WCF-CustomIsolated ]，然後按一下 [ 設定]。

  5. 如果您想要將傳送埠設定為使用 WCF 擴充點，請在 [BizTalk Server 管理主控台] 中，依序展開[BizTalk 群組]、[< BizTalk 應用程式 >]、[傳送埠]，然後在右窗格中按兩下< [傳送埠 >]。

    • 在 [ 傳送埠屬性 ] 對話方塊的 [ 類型 ] 下拉式清單中，選取 [WCF-Custom]，然後按一下 [ 設定]。

  6. 在 [傳輸屬性] 對話方塊的 [ 系 結] 索引標籤的 [ 系結類型 ] 下拉式清單中，選取 [customBinding]。

  7. 在 [傳輸屬性] 對話方塊的 [ 系 結] 索引標籤上，以滑鼠右鍵按一下 [系 結 ] 清單的工作區，然後按一下 [ 新增擴充功能]。

  8. 在 [ 選取繫結項目延伸模組 ] 對話方塊中，選取繫結項目延伸，然後按一下 [ 確定]。

  9. 在 [傳輸屬性] 對話方塊的 [ 系 結] 索引標籤上，根據您在上一個步驟中新增的繫結項目延伸類型，調整 [系結 ] 清單中新增 的繫結項目順序，如下所示：

    • 在 [ 系結 ] 清單中，以滑鼠右鍵按一下繫結項目延伸模組，然後按一下 [ 上移延伸模組 ] 或 [ 下移延伸模組]。 系 結清單中的最低 繫結項目延伸會對應至通道堆疊的底部元件。 系 結清單中的最高 繫結項目會對應至通訊堆疊的最上層元件。

      注意

      如需自訂系結之繫結項目之特定順序的詳細資料，請參閱 自訂 系結。

  10. 在傳輸屬性對話方塊中，設定其餘的傳輸設定。

  11. 在 BizTalk Server 管理主控台中，按一下 [確定] 按鈕關閉所有開啟的對話方塊，然後確定不會顯示任何錯誤訊息和錯誤的事件記錄檔。

設定 WCF 行為延伸模組的 machine.config 檔案

  1. 在命令提示字元中，移至 %FrameworkDir%\v4。X.XXXXX\CONFIG 資料夾，然後使用 [記事本] 開啟 machine.config 檔案。

  2. 在 [記事本] 中，如果 machine.config 檔案沒有< system.serverModel > \ < extensions >元素，請在 machine.config 檔案的組態 > 元素內新增這些專案 <，然後在system.serverModel > \ < extensions > 元素內 <新增< WCF 行為延伸的 behaviorExtensions >元素。 例如，若要啟用自訂行為延伸模組 schemaValidator，請在 machine.config 檔案的組態 > 專案內 <新增下列程式碼：

    <system.serviceModel>  
  <extensions>  
    <behaviorExtensions>  
      <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/>  
    </behaviorExtensions>  
  </extensions>  
</system.serviceModel>

    注意

    • 您可以使用命令 gacutil /lr< assembly_name >來尋找要註冊的元件資訊。
    • 請參閱此元素上的 behaviorExtensions 。

  3. 在「記事本」中，儲存 machine.config 檔案。

  4. 如果您有多個BizTalk Server執行時間電腦和管理電腦，請在所有電腦上重複此程式的步驟 1 到 3。

    注意

    您必須在 WCF 基礎結構的所有電腦上重複這些步驟，以處理 BizTalk 主機實例和 BizTalk Server 管理主控台的 WCF 擴充點。

使用 BizTalk 管理主控台設定 WCF 行為延伸模組

  1. 開啟 [BizTalk Server 管理] 。

    注意

    如果BizTalk Server管理主控台已開啟，請重新開機 BizTalk Server 管理主控台。

  2. 如果您使用 WCF-Custom 配接器，請在 BizTalk Server 管理主控台中，依序展開 [平臺設定]、[主機實例]，然後重新開機執行介面卡的 BizTalk 主機實例。

  3. 如果您使用 WCF-CustomIsolated 配接器，請在 IIS 管理主控台中，重新啟動與 WCF 接收位置關聯的應用程式集區。

  4. 如果您想要將接收位置設定為使用 WCF 擴充點，請在 BizTalk 管理主控台中，依序展開[BizTalk 群組]、[BizTalk 應用程式 > ]、 <[接收位置]，然後在右窗格中按兩下< [接收位置 >]。

    • 在 [ 接收位置屬性 ] 對話方塊的 [ 類型 ] 下拉式清單中，根據您要使用的 WCF 配接器，選取 [WCF-Custom ] 或 [ WCF-CustomIsolated ]，然後按一下 [ 設定]。

  5. 如果您想要設定傳送埠以使用 WCF 擴充點，請在 BizTalk 管理主控台中，依序展開[BizTalk 群組]、[BizTalk 應用程式 > ]、 <[傳送埠] 和右窗格中的 [< 傳送埠 >]。

    • 在 [ 傳送埠屬性 ] 對話方塊的 [ 類型 ] 下拉式清單中，選取 [WCF-Custom]，然後按一下 [ 設定]。

  6. 在 [傳輸屬性] 對話方塊的 [行為]索引標籤上，以滑鼠右鍵按一下[ServiceBehavior] 或 [EndpointBehavior]，視行為延伸模組的類型而定，然後在 [選取行為延伸模組] 對話方塊中，選取行為延伸模組，然後按一下 [確定]。

  7. 在傳輸屬性對話方塊中，設定其餘的傳輸設定。

  8. 在 BizTalk Server 管理主控台中，按一下 [確定] 按鈕關閉所有開啟的對話方塊，然後確定不會顯示任何錯誤訊息和錯誤的事件記錄檔。

使用 SSL 憑證設定 WCF-Custom 接收位置

  • 如果 WCF-Custom 接收位置發生使用 HTTP 核心模式驅動程式 (HTTP.sys) ，例如 HTTPsTransport 繫結項目，則安全通訊端層 (SSL) 通訊，接收位置必須為每個通訊端註冊憑證 (IP 位址/埠組合) 。 請使用 HttpCfg.exe 工具將 SSL 憑證繫結到電腦上的連接埠。 如需詳細資訊，請參閱 如何：使用 SSL 憑證設定埠。