Azure 파일 동기화 에이전트 설치 및 서버 등록 문제 해결

  • 아티클

스토리지 동기화 서비스를 배포한 후 Azure 파일 동기화 배포의 다음 단계는 Azure 파일 동기화 에이전트를 설치하고 스토리지 동기화 서비스에 Windows Server를 등록하는 것입니다. 이 문서는 이러한 단계에서 발생할 수 있는 문제를 해결하고 resolve 데 도움이 되도록 설계되었습니다.

에이전트 설치

에이전트 설치 실패 문제 해결

Azure 파일 동기화 에이전트 설치가 실패하면 에이전트 설치 디렉터리에 있는 설치 로그 파일을 찾습니다. Azure 파일 동기화 에이전트가 C: 볼륨에 설치된 경우 설치 로그 파일은 C:\Program Files\Azure\StorageSyncAgent\InstallerLog 아래에 있습니다.

참고

명령줄에서 Azure 파일 동기화 에이전트를 설치하고 스위치를 /l\*v 사용하는 경우 로그 파일은 에이전트 설치가 실행된 경로에 있습니다.

MSI 패키지를 사용하는 에이전트 설치의 로그 파일 이름은 AfsAgentInstall입니다. MSP 패키지(업데이트 패키지)를 사용하는 에이전트 설치의 로그 파일 이름은 AfsUpdater입니다.

에이전트 설치 로그 파일을 찾았으면 파일을 열고 로그 끝에 있는 실패 코드를 검색합니다. "오류 코드 1603" 또는 "샌드박스"를 검색하는 경우 오류 코드를 찾을 수 있어야 합니다.

실패한 에이전트 설치의 코드 조각은 다음과 같습니다.

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

이 예제에서는 오류 코드 -2147287035(ERROR_ACCESS_DENIED)으로 에이전트 설치에 실패했습니다.

오류로 인해 에이전트 설치 실패: 스토리지 동기화 에이전트 설치 마법사가 오류로 인해 조기에 종료됨

에이전트 설치 로그에서 다음 오류가 기록됩니다.

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

이 문제는 그룹 정책을 사용하여 PowerShell 실행 정책을 구성하고 정책 설정이 "서명된 스크립트만 허용"인 경우에 발생합니다. Azure 파일 동기화 에이전트에 포함된 모든 스크립트가 서명됩니다. 설치 관리자가 실행 무시 정책 설정을 사용하여 스크립트 실행을 수행하므로 Azure 파일 동기화 에이전트 설치가 실패합니다.

이 문제를 resolve 서버에서 스크립트 실행 그룹 켜기 정책 설정을 일시적으로 사용하지 않도록 설정합니다. 에이전트 설치가 완료되면 그룹 정책 설정을 다시 사용하도록 설정할 수 있습니다.

Active Directory 도메인 컨트롤러에서 에이전트 설치 실패

에이전트 설치 로그에서 다음 오류가 기록됩니다.

CAQuietExec64:  Error 0x80070001: Command line returned an error.
CAQuietExec64:  Error 0x80070001: CAQuietExec64 Failed
CustomAction InstallHFSRequiredWindowsFeatures returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)
Action ended 8:51:12: InstallExecute. Return value 3.
MSI (s) (EC:B4) [08:51:12:439]: Note: 1: 2265 2:  3: -2147287035

이 문제는 PDC 역할 소유자가 Windows Server 2008 R2 또는 이전 OS 버전에 있는 Active Directory 도메인 컨트롤러에 동기화 에이전트를 설치하려고 하면 발생합니다.

resolve 위해 PDC 역할을 Windows Server 2012 R2 이상을 실행하는 다른 도메인 컨트롤러로 전송한 다음 동기화를 설치합니다.

Windows Server 2012 R2에서 볼륨에 액세스하지 못함 오류: 매개 변수가 잘못되었습니다.

Windows Server 2012 R2에서 서버 엔드포인트를 만든 후 볼륨에 액세스할 때 다음 오류가 발생합니다.

drive letter:\에 액세스할 수 없습니다.
매개 변수가 틀립니다.

이 문제를 resolve KB2919355 설치하고 서버를 다시 시작합니다. 이후 업데이트가 이미 설치되어 있기 때문에 이 업데이트가 설치되지 않는 경우 Windows 업데이트 이동하여 Windows Server 2012 R2에 대한 최신 업데이트를 설치하고 서버를 다시 시작합니다.

서버 등록

서버 등록은 "서버를 등록하지 못했습니다"라는 오류를 표시합니다.

Azure 파일 동기화 에이전트 버전 17이 설치된 경우 ServerRegistration.exe 다음 오류 메시지와 함께 서버를 등록하지 못할 수 있습니다.

서버를 등록하지 못했습니다.

%LocalAppData%\Temp 아래에 있는 AfsSrvRegistration*.log 파일에서 다음 오류가 기록됩니다.

ManagementCode: 'NoRegisteredProviderFound'

해당 지역에 서비스 쪽 수정 사항이 배포될 때까지 다음 PowerShell 명령을 사용하여 서버를 등록하여 이 문제를 해결할 수 있습니다.

Connect-AzAccount -Subscription "<guid>" -Tenant "<guid>"
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"

서버 등록이 모든 Azure 구독을 나열하지 않음

ServerRegistration.exe를 사용하여 서버를 등록할 때 Azure 구독 드롭다운을 선택하면 구독이 누락됩니다.

이 문제는ServerRegistration.exe처음 5개 Microsoft Entra 테넌트에서만 구독을 검색하기 때문에 발생합니다.

서버에서 서버 등록 테넌트 제한을 늘리려면 값이 5보다 큰 under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync 라는 ServerRegistrationTenantLimit DWORD 값을 만듭니다.

다음 PowerShell 명령을 사용하여 서버를 등록하여 이 문제를 해결할 수도 있습니다.

Connect-AzAccount -Subscription "<guid>" -Tenant "<guid>"
Register-AzStorageSyncServer -ResourceGroupName "<your-resource-group-name>" -StorageSyncServiceName "<your-storage-sync-service-name>"

서버 등록에는 "이 서버가 이미 등록되어 있습니다"라는 메시지가 표시됩니다.

'서버가 이미 등록됨' 오류 메시지가 있는 서버 등록 대화 상자를 보여 주는 스크린샷.

이 메시지는 서버가 이전에 스토리지 동기화 서비스에 등록된 경우에 나타납니다. 현재 스토리지 동기화 서비스에서 서버를 등록 취소한 다음 새 스토리지 동기화 서비스에 등록하려면 Azure 파일 동기화 사용하여 서버 등록 취소에 설명된 단계를 완료합니다.

서버가 스토리지 동기화 서비스의 등록된 서버 아래에 나열되지 않은 경우 등록을 취소하려는 서버에서 다음 PowerShell 명령을 실행합니다.

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Reset-StorageSyncServer

참고

서버가 클러스터의 일부인 경우 매개 변수를 Reset-StorageSyncServer-CleanClusterRegistration 사용하여 Azure 파일 동기화 클러스터 등록 세부 정보에서 서버를 제거합니다.

서버를 등록할 때 수많은 "신뢰할 수 없는 웹 사이트" 응답이 표시됩니다. 왜?

이 문제는 서버 등록 중에 향상된 인터넷 Explorer 보안 정책을 사용할 때 발생합니다. 향상된 인터넷 Explorer 보안 정책을 올바르게 사용하지 않도록 설정하는 방법에 대한 자세한 내용은 Azure 파일 동기화 사용할 Windows Server 준비 및 Azure 파일 동기화배포하는 방법을 참조하세요.

서버는 Azure Portal 등록된 서버 아래에 나열되지 않습니다.

스토리지 동기화 서비스에 대해 등록된 서버 아래에 서버 가 나열되지 않은 경우:

  1. 등록하려는 서버에 로그인합니다.
  2. 파일 탐색기 연 다음 스토리지 동기화 에이전트 설치 디렉터리로 이동합니다(기본 위치는 C:\Program Files\Azure\StorageSyncAgent).
  3. ServerRegistration.exe를 실행하고 마법사를 완료하여 스토리지 동기화 서비스에 서버를 등록합니다.

참고 항목

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.