Nie można zarejestrować agenta hybrydowego w programie Exchange Server

• Dotyczy:

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

Symptomy

Podczas konfigurowania agenta hybrydowego firmy Microsoft za pomocą kreatora konfiguracji hybrydowej (HCW) w systemie HCW zostanie wyświetlony następujący błąd rejestracji zainstalowanego agenta hybrydowego.

W dzienniku HCW są również dostępne następujące wpisy błędów:

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."

Przyczyna

Błędy występują, jeśli wewnętrzny adres URL używany przez aplikację agenta hybrydowego jest już używany w organizacji. Konkretnie:

Przyczyna 1

Ten sam wewnętrzny adres URL jest używany przez istniejącą aplikację lokalną przedsiębiorstwa korzystającą z serwera proxy aplikacji Microsoft Entra.

Przyczyna 2

Ten sam wewnętrzny adres URL jest używany przez wcześniej zainstalowaną, oddzieloną aplikację agenta hybrydowego, która nie jest w pełni zarejestrowana. Oddzielona aplikacja agenta hybrydowego może być spowodowana nieudaną instalacją lub odinstalowaniem agenta hybrydowego.

Rozwiązanie

W zależności od przyczyny użyj odpowiedniego rozwiązania.

Rozwiązanie przyczyny 1

Wybierz jedną z następujących opcji:

• Przypisz inny wewnętrzny adres URL do istniejącej aplikacji dla przedsiębiorstw. Aby uzyskać więcej informacji, zobacz Dodawanie aplikacji lokalnej i Set-AzureADApplicationProxyApplication.

• Usuń istniejącą aplikację dla przedsiębiorstw. Aby uzyskać więcej informacji, zobacz Remove-AzureADApplicationProxyApplication.

Uwaga

Moduły azure AD i MSOnline programu PowerShell są przestarzałe od 30 marca 2024 r. Aby dowiedzieć się więcej, przeczytaj aktualizację wycofania. Po tej dacie obsługa tych modułów jest ograniczona do pomocy w migracji do zestawu Microsoft Graph PowerShell SDK i poprawek zabezpieczeń. Przestarzałe moduły będą nadal działać do 30 marca 2025 r.

Zalecamy migrację do programu Microsoft Graph PowerShell w celu interakcji z identyfikatorem Entra firmy Microsoft (dawniej Azure AD). Aby uzyskać typowe pytania dotyczące migracji, zapoznaj się z często zadawanymi pytaniami dotyczącymi migracji. Nuta: W wersjach 1.0.x usługi MSOnline mogą wystąpić zakłócenia po 30 czerwca 2024 r.

Rozwiązanie przyczyny 2

Usuń wcześniej zainstalowaną, oddzieloną aplikację agenta hybrydowego. Aby to zrobić, wykonaj następujące kroki.

1. Pobierz identyfikator GUID aplikacji poprzedniej aplikacji agenta hybrydowego. Ten identyfikator GUID można znaleźć, wyszukując następujący wpis w dzienniku HCW:

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

   Wpis może przypominać następujący przykład:

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

2. Usuń poprzednią aplikację agenta hybrydowego. Aby to zrobić, wykonaj następujące kroki.

   1. Załaduj moduł HybridManagement programu PowerShell:

      1. Zainstaluj moduł Microsoft PackageManagement PowerShell.

      2. Zainstaluj moduł Microsoft Azure PowerShell.

      3. Pobierz najnowszą wersję modułu Microsoft HybridManagement.psm1 programu PowerShell na serwer w organizacji programu Exchange.

      4. W folderze zawierającym moduł HybridManagement uruchom następujące polecenie programu PowerShell jako administrator:

         Import-Module .\HybridManagement.psm1
         

   2. Przekaż identyfikator GUID aplikacji znaleziony w kroku 1 do polecenia cmdlet Remove-HybridApplication :

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

      Jeśli masz włączoną usługę MFA, uruchom polecenie:

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

      Po wyświetleniu monitu o podanie poświadczeń wprowadź poświadczenia administratora globalnego usługi Microsoft 365 lub Office 365.

3. Uruchom ponownie HCW w trybie klasycznym, aby wyrejestrować usługę serwera proxy aplikacji w identyfikatorze Microsoft Entra.

4. Przejdź do obszaru Programy i funkcje w Panelu sterowania, aby sprawdzić, czy usługa hybrydowa firmy Microsoft nie jest zainstalowana. Jeśli tak jest, uruchom ponownie krok 2, aby usunąć aplikację agenta hybrydowego.

5. Uruchom ponownie HCW w trybie nowoczesnym.

   Uwaga

   Po wyświetleniu monitu o wybranie topologii hybrydowej wybierz pozycję Exchange Modern Hybrid Topology.

Jeśli aplikacja agenta hybrydowego nie została pomyślnie usunięta, użyj jednej z następujących opcji:

• Uruchom następujące polecenie Remove-AzureADApplicationProxyApplication :

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

• Uruchom następujące polecenie, aby uzyskać identyfikator GUID aplikacji, a następnie uruchom Remove-AzureADApplicationProxyApplication polecenie , aby usunąć aplikację:

  Get-AzureADServicePrincipal | where {$_.Tags -Contains "WindowsAzureActiveDirectoryOnPremApp"} | fl AppId, DisplayName
  

Jeśli nadal nie możesz usunąć aplikacji agenta hybrydowego, skontaktuj się z pomocą techniczną firmy Microsoft.