共用方式為


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

徵兆

當您使用混合式設定精靈 (HCW) 來設定 Microsoft混合式代理程式時,您會在 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 Entra 應用程式 Proxy 的現有企業內部部署應用程式會使用相同的內部 URL。

原因 2

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

原因 1 的解決方案

選擇下列其中一個選項:

  • 將不同的內部URL指派給現有的企業應用程式。 請遵循下列步驟:

    1. 執行下列 PowerShell Cmdlet 以連線到您的租使用者:

      Import-Module Microsoft.Graph.Beta.Applications
      Connect-Graph -Scopes "Application.ReadWrite.All"
      
    2. 執行下列 PowerShell 命令,將不同的內部 URL 指派給企業應用程式。

      $params = @{
        onPremisesPublishing = @{
          internalUrl = "<internal app URL>"
          externalUrl = "<external app URL>"
        }
      }
      Update-MgBetaApplication -ApplicationId <app ID> -BodyParameter $params
      

      雖然預期的變更是更新內部 URL,但外部 URL 會包含在更新中。 您可以使用現有的外部 URL 或更新的 URL。

      如需詳細資訊,請參閱 Update-MgBetaApplication新增內部部署應用程式

  • 拿掉現有的企業應用程式。 請遵循下列步驟:

    1. 執行下列 PowerShell Cmdlet 以連線到您的租使用者:

      Import-Module Microsoft.Graph.Applications
      Connect-Graph -Scopes "Application.ReadWrite.All"
      
    2. 執行下列 PowerShell Cmdlet 以移除企業應用程式。

      Remove-MgApplication -ApplicationId <app ID>
      

      如需詳細資訊,請參閱 Remove-MgApplication

原因 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 全域管理員認證。

  3. 在傳統模式中重新執行 HCW,以在 Microsoft Entra ID 中取消註冊 Application Proxy 服務。

  4. 移至 [控制面板] 中的 [程式和功能],並確認未安裝Microsoft混合式服務。 如果是,請重新執行步驟 2 以移除混合式代理程式應用程式。

  5. 以新式模式重新執行 HCW。

    注意

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

如果未成功移除混合式代理程式應用程式,請遵循下列步驟:

  1. 執行下列 PowerShell Cmdlet 以連線到您的租使用者:

    Import-Module Microsoft.Graph.Applications
    Import-Module Microsoft.Graph.Beta.Applications
    Connect-Graph -Scopes "Application.ReadWrite.All"
    
  2. 如果您不知道應用程式識別碼,請執行下列 PowerShell Cmdlet 以取得應用程式識別碼:

    Get-MgBetaServicePrincipal | where {$_.Tags -Contains "WindowsAzureActiveDirectoryOnPremApp"}| FL AppId, DisplayName
    
  3. 執行下列 PowerShell Cmdlet 以移除混合式應用程式:

    Remove-MgApplication -ApplicationId <application GUID>
    

如果您仍然無法移除混合式代理程式應用程式,請連絡 Microsoft 支援服務