Tidak dapat mendaftarkan Agen Hibrid di Exchange Server

Gejala

Saat Anda menggunakan Hybrid Configuration Wizard (HCW) untuk menyiapkan Microsoft Hybrid Agent, Anda akan melihat kesalahan pendaftaran berikut di HCW untuk Agen Hibrid yang diinstal.

Anda juga menerima entri kesalahan berikut dalam log 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."

Penyebab

Kesalahan terjadi jika URL internal yang digunakan oleh aplikasi Hybrid Agent sudah digunakan dalam organisasi Anda. Lebih spesifik:

Penyebab 1

URL internal yang sama digunakan oleh aplikasi lokal perusahaan yang ada yang menggunakan proksi aplikasi Microsoft Entra.

Penyebab 2

URL internal yang sama digunakan oleh aplikasi Agen Hibrid yatim piatu yang diinstal sebelumnya yang tidak sepenuhnya terdaftar. Aplikasi Agen Hibrid yang yatim dapat disebabkan oleh kegagalan penginstalan atau penghapusan instalasi Agen Hibrid.

Penyelesaian untuk Penyebab 1

Pilih salah satu opsi berikut:

• Tetapkan URL internal yang berbeda ke aplikasi perusahaan yang ada. Ikuti langkah-langkah ini:

  1. Jalankan cmdlet PowerShell berikut untuk menyambungkan ke penyewa Anda:

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

  2. Jalankan perintah PowerShell berikut untuk menetapkan URL internal yang berbeda ke aplikasi perusahaan.

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

     Meskipun perubahan yang dimaksudkan adalah memperbarui URL internal, URL eksternal disertakan sebagai bagian dari pembaruan. Anda dapat menggunakan URL eksternal yang ada atau URL yang diperbarui.

     Untuk informasi selengkapnya, lihat Update-MgBetaApplication dan Menambahkan aplikasi lokal.

• Hapus aplikasi perusahaan yang ada. Ikuti langkah-langkah ini:

  1. Jalankan cmdlet PowerShell berikut untuk menyambungkan ke penyewa Anda:

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

  2. Jalankan cmdlet PowerShell berikut untuk menghapus aplikasi perusahaan.

     Remove-MgApplication -ApplicationId <app ID>
     

     Untuk informasi selengkapnya, lihat Remove-MgApplication.

Penyelesaian untuk Penyebab 2

Hapus aplikasi Hybrid Agent yang diinstal sebelumnya dan yang terlantar. Ikuti langkah-langkah ini:

1. Dapatkan GUID aplikasi dari aplikasi Hybrid Agent sebelumnya. Anda dapat menemukan GUID ini dengan mencari log HCW untuk entri berikut:

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

   Entri mungkin menyerupai contoh berikut:

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

2. Hapus aplikasi Hybrid Agent sebelumnya. Ikuti langkah-langkah ini:

   1. Muatkan modul HybridManagement PowerShell:

      1. Instal modul Microsoft PackageManagement PowerShell.

      2. Instal modul Microsoft Azure PowerShell.

      3. Unduh versi terbaru modul PowerShell Microsoft HybridManagement.psm1 ke server di organisasi Exchange Anda.

      4. Di folder yang berisi modul HybridManagement, jalankan perintah PowerShell berikut sebagai administrator:

         Import-Module .\HybridManagement.psm1
         

   2. Teruskan GUID aplikasi yang Anda temukan di langkah 1 ke cmdlet Remove-HybridApplication :

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

      Atau, jika Anda mengaktifkan MFA, jalankan:

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

      Saat Dimintai kredensial, masukkan kredensial administrator Microsoft 365 atau Office 365 Global Anda.

3. Jalankan ulang HCW dalam mode klasik untuk membatalkan pendaftaran layanan Proksi Aplikasi di ID Microsoft Entra.

4. Buka Program dan Fitur di Panel Kontrol, dan verifikasi bahwa Microsoft Hybrid Service tidak diinstal. Jika ya, jalankan ulang langkah 2 untuk menghapus aplikasi Hybrid Agent.

5. Jalankan ulang HCW dalam mode modern.

   Nota

   Saat Anda diminta untuk memilih topologi hibrid, pilih Topologi Hibrid Modern Exchange.

Jika aplikasi Hybrid Agent tidak berhasil dihapus, ikuti langkah-langkah berikut:

1. Jalankan cmdlet PowerShell berikut untuk menyambungkan ke penyewa Anda:

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

2. Jika Anda tidak mengetahui ID aplikasi, jalankan cmdlet PowerShell berikut untuk mendapatkan ID aplikasi:

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

3. Jalankan cmdlet PowerShell berikut untuk menghapus aplikasi hibrid:

   Remove-MgApplication -ApplicationId <application GUID>
   

Jika Anda masih tidak dapat menghapus aplikasi Agen Hibrid, hubungi Dukungan Microsoft.