無法在 Exchange Server 中註冊混合式代理程式

徵狀

當您使用混合式設定精靈 (HCW) 來設定 Microsoft Hybrid Agent時,您會在已安裝混合式代理程式的 HCW 中看到下列註冊錯誤。

HCW 中混合式代理程式註冊錯誤的螢幕擷取畫面。

您也會在 HCW 記錄檔中收到下列錯誤專案:

10333 \[Client=UX, fn=SendAsync, Thread=\<ID\>\] Results=NotFound {"error":
{"code":"Application_NotFound", "message":"Application '\<application GUID\>' not found or
OnPremisesPublishing is not enabled for your tenant."
10333 \[Client=UX, fn=SendAsync, Thread=\<ID\>\] Results=BadRequest {"error":
{"code": "InternalUrl_Duplicate", "message":"Internal url '\<application URL\>' is invalid
since it is already in use."

原因

如果混合式代理程式應用程式使用的內部 URL 已在組織內使用中,就會發生錯誤。 具體來說:

原因 1

使用 Microsoft Azure AD 應用程式 Proxy 的現有企業內部部署應用程式會使用相同的內部 URL

原因 2

先前安裝且未完全註冊的孤立混合式代理程式應用程式會使用相同的內部 URL。 孤立的混合式代理程式應用程式可能是因為混合式代理程式安裝或卸載失敗所造成。

解決方案

視原因而定,請使用適當的解決方法。

原因 1 的解決方式

選擇下列其中一個選項:

原因 2 的解決方式

移除先前安裝的孤立混合式代理程式應用程式。 如果要執行這項操作,請依照下列步驟執行:

  1. 取得先前混合式代理程式應用程式的應用程式 GUID。 您可以搜尋下列專案的 HCW 記錄來尋找此 GUID:

    10386 [Client=UX, Thread=<ID>] Previous Connector Application Name found: <application GUID>

    專案可能類似下列範例:

    10386 [Client=UX, Thread=20] Previous Connector Application Name found: 8fc44b37-bf0d-45bf-8254-d4d033d93a6e

  2. 移除先前的混合式代理程式應用程式。 如果要執行這項操作,請依照下列步驟執行:

    1. 載入 HybridManagement PowerShell 模組

      1. 安裝 Microsoft PackageManagement PowerShell 模組

      2. 安裝Microsoft Azure PowerShell模組

      3. 將最新版的 Microsoft HybridManagement.psm1 PowerShell 模組下載到 Exchange 組織中的伺服器。

      4. 在包含 HybridManagement 模組的資料夾中,以系統管理員身分執行下列 PowerShell 命令:

        Import-Module .\HybridManagement.psm1
        
    2. 將您在步驟 1 中找到的應用程式 GUID 傳遞至 Remove-HybridApplication Cmdlet:

      Remove-HybridApplication -AppId <application GUID> -Credential (Get-Credential)
      

      或者,如果您已啟用 MFA,請執行:

      Remove-HybridApplication -AppId <application GUID> -UserPrincipalName <tenant admin UPN>
      

      當系統提示您輸入認證時,請輸入您的 Microsoft 365 或Office 365全域管理員認證。

繼續設定混合式代理程式。 如果要執行這項操作,請依照下列步驟執行:

  1. 使用 Get-HybridAgent Cmdlet 檢查混合式代理程式的狀態:

    Get-HybridAgent -Credential (Get-Credential)
    

    或者,如果您已啟用 MFA,請執行:

    Get-HybridAgent -UserPrincipalName <tenant admin UPN>
    

    如果系統提示您輸入認證,請輸入您的 Microsoft 365 或Office 365全域管理員認證。

    繼續安裝程式之前,請確定混合式代理程式為作用中狀態。 如果混合式代理程式處於非使用中狀態,請參閱 針對傳統和新式混合式混合式中的混合式移轉端點進行疑難排解判斷混合式代理程式是否已安裝並執行。

  2. 重新執行 HCW 以繼續 混合式代理程式設定

    注意事項

    當系統提示您選擇混合式拓撲時,請選取 [Exchange Modern Hybrid Topology]