다음을 통해 공유


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

동일한 내부 URL은 Microsoft Entra 애플리케이션 프록시를 사용하는 기존 엔터프라이즈 온-프레미스 앱에서 사용됩니다.

원인 2

완전히 등록되지 않은 이전에 설치된 분리된 하이브리드 에이전트 애플리케이션에서 동일한 내부 URL을 사용합니다. 분리된 하이브리드 에이전트 애플리케이션은 하이브리드 에이전트 설치 또는 제거 실패로 인해 발생할 수 있습니다.

해결 방법

원인에 따라 적절한 해결을 사용합니다.

원인 1에 대한 해결 방법

다음 옵션 중 하나를 선택합니다.

참고

Azure AD 및 MSOnline PowerShell 모듈은 2024년 3월 30일부터 더 이상 사용되지 않습니다. 자세한 내용은 사용 중단 업데이트를 참조하세요. 이 날짜 이후에는 이러한 모듈에 대한 지원이 Microsoft Graph PowerShell SDK 및 보안 수정에 대한 마이그레이션 지원으로 제한됩니다. 사용되지 않는 모듈은 2025년 3월 30일까지 계속 작동합니다.

Microsoft Graph PowerShell로 마이그레이션하여 Microsoft Entra ID(이전의 Azure AD)와 상호 작용하는 것이 좋습니다. 일반적인 마이그레이션 질문은 마이그레이션 FAQ를 참조하세요. 메모: MSOnline 버전 1.0.x는 2024년 6월 30일 이후에 중단이 발생할 수 있습니다.

원인 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에서 애플리케이션 프록시 서비스를 등록 취소합니다.

  4. 제어판 의 프로그램 및 기능 으로 이동하여 Microsoft 하이브리드 서비스가설치되어 있지 않은지 확인합니다. 이 경우 2단계를 다시 실행하여 하이브리드 에이전트 애플리케이션을 제거합니다.

  5. 최신 모드에서 HCW를 다시 실행합니다.

    참고

    하이브리드 토폴로지를 선택하라는 메시지가 표시되면 Exchange 최신 하이브리드 토폴로지를 선택합니다.

하이브리드 에이전트 애플리케이션이 성공적으로 제거되지 않은 경우 다음 옵션 중 하나를 사용합니다.

  • 다음 Remove-AzureADApplicationProxyApplication 명령을 실행합니다.

    Remove-AzureADApplicationProxyApplication -ObjectId <application GUID> -RemoveADApplication $true
    
  • 다음 명령을 실행하여 애플리케이션 GUID를 가져와서 명령을 실행 Remove-AzureADApplicationProxyApplication 하여 애플리케이션을 제거합니다.

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

하이브리드 에이전트 애플리케이션을 제거할 수 없는 경우 Microsoft 지원에 문의하세요.