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

Objawy

W przypadku korzystania z Kreatora konfiguracji hybrydowej (HCW) do skonfigurowania Microsoft Hybrid Agent, zostanie wyświetlony następujący błąd rejestracji w Kreatorze konfiguracji hybrydowej dla zainstalowanego Hybrydowego Agenta.

W dzienniku HCW są również wyświetlane następujące wpisy o błędach:

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. Szczególnie:

Przyczyna 1

Ten sam wewnętrzny adres URL jest używany przez istniejącą aplikację lokalną przedsiębiorstwa korzystającą z serwera proxy aplikacji Firmy 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 niepowodzeniem instalacji lub odinstalowania agenta hybrydowego.

Rozwiązanie dotyczące przyczyny 1

Wybierz jedną z następujących opcji:

• Przypisz inny wewnętrzny adres URL do istniejącej aplikacji dla przedsiębiorstw. Wykonaj te kroki:

  1. Uruchom następujące cmdletów programu PowerShell, aby nawiązać połączenie z dzierżawcą.

     Import-Module Microsoft.Graph.Beta.Applications
     Connect-Graph -Scopes "Application.ReadWrite.All"
     

  2. Uruchom następujące polecenia programu PowerShell, aby przypisać inny wewnętrzny adres URL do aplikacji dla przedsiębiorstw.

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

     Mimo że planowana zmiana polega na zaktualizowaniu wewnętrznego adresu URL, zewnętrzny adres URL jest uwzględniony w ramach aktualizacji. Możesz użyć istniejącego zewnętrznego adresu URL lub zaktualizowanego adresu URL.

     Aby uzyskać więcej informacji, zobacz Update-MgBetaApplication i Add an on-premises application (Dodawanie aplikacji lokalnej).

• Usuń istniejącą aplikację dla przedsiębiorstw. Wykonaj te kroki:

  1. Uruchom następujące cmdletów programu PowerShell, aby nawiązać połączenie z dzierżawcą.

     Import-Module Microsoft.Graph.Applications
     Connect-Graph -Scopes "Application.ReadWrite.All"
     

  2. Uruchom następujące polecenie cmdlet programu PowerShell, aby usunąć aplikację dla przedsiębiorstw.

     Remove-MgApplication -ApplicationId <app ID>
     

     Aby uzyskać więcej informacji, zobacz Remove-MgApplication.

Rozwiązanie w przypadku przyczyny 2

Usuń wcześniej zainstalowaną, oddzieloną aplikację agenta hybrydowego. Wykonaj te kroki:

1. Pobierz identyfikator GUID aplikacji poprzedniej aplikacji agenta hybrydowego. Ten identyfikator GUID można znaleźć, wyszukując dziennik HCW pod kątem następującego wpisu:

   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. Wykonaj te kroki:

   1. Załaduj moduł HybridManagement programu PowerShell:

      1. Zainstaluj moduł Microsoft PackageManagement programu PowerShell.

      2. Zainstaluj moduł Microsoft Azure PowerShell.

      3. Pobierz najnowszą wersję modułu Microsoft HybridManagement.psm1 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)
      

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

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

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

3. Uruchom ponownie HCW w trybie klasycznym, aby wyrejestrować usługę Application Proxy w Microsoft Entra ID.

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

5. Ponownie uruchom HCW w trybie nowoczesnym.

   Uwaga / Notatka

   Po wyświetleniu monitu o wybranie topologii hybrydowej wybierz pozycję Nowoczesna topologia hybrydowa programu Exchange.

Jeśli aplikacja agenta hybrydowego nie została pomyślnie usunięta, wykonaj następujące kroki:

1. Uruchom następujące cmdletów programu PowerShell, aby nawiązać połączenie z dzierżawcą.

   Import-Module Microsoft.Graph.Applications
   Import-Module Microsoft.Graph.Beta.Applications
   Connect-Graph -Scopes "Application.ReadWrite.All"
   

2. Jeśli nie znasz identyfikatora aplikacji, uruchom następujące polecenie cmdlet programu PowerShell, aby uzyskać identyfikator aplikacji:

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

3. Uruchom następujące polecenie cmdlet programu PowerShell, aby usunąć aplikację hybrydową:

   Remove-MgApplication -ApplicationId <application GUID>
   

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