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

發行項
04/09/2024
適用於:

Exchange Online, Exchange Server 2019, Exchange Server 2016, Exchange Server 2013

徵狀

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

原因 2

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

解決方案

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

原因 1 的解決方式

選擇下列其中一個選項：

將不同的內部URL指派給現有的企業應用程式。如需詳細資訊，請參閱新增內部部署應用程式和 Set-AzureADApplicationProxyApplication。
拿掉現有的企業應用程式。如需詳細資訊，請參閱 Remove-AzureADApplicationProxyApplication。

注意事項

自 2024 年 3 月 30 日起，Azure AD 和 MSOnline PowerShell 模組已被取代。若要深入瞭解，請閱讀淘汰更新。在此日期之後，這些模組的支援僅限於 Microsoft Graph PowerShell SDK 的移轉協助和安全性修正。已淘汰的模組會繼續運作到 2025 年 3 月 30 日。

建議您移轉至 Microsoft Graph PowerShell，以與 Microsoft Entra ID (先前的 Azure AD) 互動。如需常見的移轉問題，請參閱移轉常見問題。 注意： 1.0.x 版的 MSOnline 可能會在 2024 年 6 月 30 日之後中斷。

原因 2 的解決方式

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

取得先前混合式代理程式應用程式的應用程式 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
拿掉先前的混合式代理程式應用程式。如果要執行這項操作，請依照下列步驟執行：
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 全域管理員認證。
在傳統模式中重新執行 HCW，以在 Microsoft Entra ID 中取消註冊應用程式 Proxy 服務。
移至 [控制台中的程式和功能]，確認未安裝Microsoft Hybrid Service。如果是，請重新執行步驟 2 以移除混合式代理程式應用程式。
以新式模式重新執行 HCW。

注意事項

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

如果未成功移除混合式代理程式應用程式，請使用下列其中一個選項：

執行下列 Remove-AzureADApplicationProxyApplication 命令：

Remove-AzureADApplicationProxyApplication -ObjectId <application GUID> -RemoveADApplication $true

執行下列命令以取得應用程式 GUID，然後執行 Remove-AzureADApplicationProxyApplication 命令以移除應用程式：
```
Get-AzureADServicePrincipal | where {$_.Tags -Contains "WindowsAzureActiveDirectoryOnPremApp"} | fl AppId, DisplayName
```

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