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

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

에이전트 설치

Azure 파일 동기화 에이전트 설치에 다시 시작이 필요한지 확인하는 방법

Azure 파일 동기화 에이전트를 설치하려면 다시 시작해야 할 수 있습니다. 예를 들어 Azure 파일 동기화 에이전트 버전 19.1.0.0은 18.2.0.0 이전 버전에서 업데이트하는 경우 서버에서 다시 시작해야 합니다.

자동 업그레이드 기능을 사용하여 에이전트를 업데이트하는 경우 다음 PowerShell 명령을 실행하여 에이전트 자동 업그레이드를 완료하기 위해 다시 시작해야 하는지 확인합니다.

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

속성 값이 RebootNeededTrue면 다시 시작해야 합니다.

에이전트 업데이트가 완료되지 않음

Azure 파일 동기화 에이전트를 업그레이드할 때 다음 증상 중 하나가 발생할 수 있습니다.

• AfsUpdater.exe "업데이트 설치"에 중단됩니다.
• 에이전트 설치가 "모니터링 에이전트 중지"에 중단됩니다.

이 문제는 현재 설치된 Azure 파일 동기화 에이전트 버전이 v16.2보다 이전이고 Logman.exe 프로세스가 종료되지 않는 경우에 발생합니다.

이 문제를 해결하려면 다음 단계를 수행합니다.

1. 작업 관리자를 엽니다.
2. LogMan 프로세스를 마우스 오른쪽 단추로 클릭하고 작업 종료를 선택합니다. 모든 LogMan 프로세스가 중지되고 에이전트 업데이트가 성공적으로 완료될 때까지 이 단계를 반복합니다.

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

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

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)로 에이전트 설치에 실패했습니다.

에이전트 설치가 오류 ERROR_NO_SYSTEM_RESOURCES 및 오류 코드 0x800705AA로 실패합니다.

시스템 리소스가 부족하여 에이전트를 설치하지 못했습니다. 이 문제를 해결하려면 서버에서 메모리를 확보하고 설치를 다시 시도합니다.

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

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

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 파일 동기화 에이전트 설치가 실패합니다.

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

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 도메인 컨트롤러에 동기화 에이전트를 설치하려고 하면 발생합니다.

이 문제를 해결하려면 PDC 역할을 Windows Server 2012 R2 이상을 실행 중인 다른 도메인 컨트롤러로 전송한 다음, 동기화를 설치합니다.

Windows Server 2012 R2의 볼륨에 액세스하는 동안 오류가 발생하여 실패합니다. 매개 변수가 잘못되었습니다.

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

드라이버 문자 :\에 액세스할 수 없습니다.
매개 변수가 올바르지 않습니다.

이 문제를 해결하려면 KB2919355 설치하고 서버를 다시 시작합니다. 이후 업데이트가 이미 설치되어 있기 때문에 이 업데이트를 설치할 수 없는 경우 Windows 업데이트로 이동하여 Windows Server 2012 R2에 대한 최신 업데이트를 설치하고 서버를 다시 시작합니다.

Azure Arc 확장을 통한 에이전트 설치

Windows용 Azure 파일 동기화 에이전트 설치에 대한 자세한 내용은 Azure Arc 지원 Windows 서버에서 Azure 파일 동기화 에이전트 확장 설치 및 관리를 참조하세요.

설치 실패 문제 해결

1. Azure Portal에서 Arc Server 로 이동합니다.
2. 서버의 확장 블레이드로 이동합니다.
3. AzureFileSyncAgentExtension 열 아래에서 세부 정보 보기를 찾아 선택합니다.
4. 확장 배포 실패의 원인에 대한 자세한 내용은 오류 메시지 필드를 검토하세요.

오류 코드 참조 및 수정

서버 등록

서버 등록 오류 문제 해결

서버 등록에 실패하면%LocalAppData% \Temp 아래에 있는 AfsSrvRegistration*.log 파일을 열고 "ErrorMessage"를 검색하여 오류 세부 정보를 가져옵니다.

오류 메시지를 기반으로 원인을 식별할 수 없는 경우 cmdlet을 사용하여 Debug-StorageSyncServer 네트워크 문제 또는 서버 인증서로 인해 서버 등록이 실패하는지 진단할 수 있습니다.

서버에서 진단을 실행하려면 다음 PowerShell 명령을 실행합니다.

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

서버에서 네트워크 연결을 테스트하려면 다음 PowerShell 명령을 실행합니다.

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

Register-AzStorageSyncServer cmdlet을 사용한 서버 등록이 실패하며, 오류: 치명적인 오류(0x8000FFFF)

다음 오류와 함께 cmdlet을 Register-AzStorageSyncServer 사용하는 서버 등록이 실패합니다.

치명적인 오류(0x8000FFFF(E_UNEXPECTED)) '이 리소스에 대한 시스템 할당 관리 ID를 찾을 수 없습니다.'

이 문제는 Azure Files Sync 에이전트가 버전 17.x에서 18.x로 업그레이드되고 ServerType 레지스트리 값이 예기치 않은 값으로 설정된 경우에 발생합니다.

이 문제를 해결하려면 관리자 권한 명령 프롬프트에서 다음 명령을 실행하여 레지스트리 값을 삭제 ServerType 합니다.

reg delete HKLM\SOFTWARE\Microsoft\Azure\StorageSync /v ServerType /f  
net stop filesyncsvc  
net start filesyncsvc  

ServerType 레지스트리 값이 삭제되면 서버 등록을 다시 시도합니다.

서버 등록은 모든 Azure 구독을 나열하지 않습니다.

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

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

서버에서 서버 등록 테넌트 제한을 늘리려면 5보다 큰 값으로 아래에 ServerRegistrationTenantLimit 호출 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync 된 DWORD 값을 만듭니다.

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

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

서버 등록이 모든 리소스 그룹을 나열하지는 않음

ServerRegistration.exe사용하여 서버를 등록할 때 리소스 그룹 드롭다운을 선택하면 일부 리소스 그룹이 누락됩니다.

이 문제는 파일 동기화 에이전트 v19.1에서 해결된 알려진 문제로 인해 발생합니다. 이 문제를 해결하려면 최신 버전의 에이전트를 설치합니다.

서버 등록은 "System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=..." 메시지를 표시합니다.

이 오류는 서버에 필요한 .NET Framework 버전이 없는 경우에 발생합니다. Azure 파일 동기화의 서버 등록을 위해서는 .NET Framework 4.7.2 이상 버전이 제대로 작동해야 합니다.

문제를 해결하려면 다음 단계를 수행합니다.

1. .NET Framework 4.7.2 이상 버전을 다운로드하여 설치합니다.
2. 설치 후 서버를 다시 시작합니다.
3. 서버 등록 UI 또는 PowerShell을 사용하여 서버 등록을 다시 시도합니다.

오류로 서버 등록이 실패합니다. 작업에서 잘못된 상태 코드 '권한 없음'을 반환했습니다.

서버 등록 중에 다음 오류가 발생할 수 있습니다.

작업에서 잘못된 상태 코드 '권한 없음'을 반환했습니다.

이 문제는 Azure 파일 동기화 v20 에이전트의 버그로 인해 발생합니다. 이 문제를 해결하려면 다음 PowerShell 명령을 실행하여 서버를 수동으로 등록합니다.

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

수동 등록을 완료한 후 서버가 Azure Portal의 등록된 서버 아래에 표시되는지 확인합니다.

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

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

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

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

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

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

서버가 Azure Portal의 등록된 서버 아래에 나열되지 않음

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

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

참고 항목

• Azure 파일 동기화 동기화 그룹 관리 문제 해결
• Azure 파일 동기화 동기화 오류 문제 해결
• Azure 파일 동기화 클라우드 계층화 문제 해결
• Azure 파일 동기화 모니터링
• Azure Files 문제 해결

도움을 요청하십시오.

질문이 있는 경우 Azure 커뮤니티 지원을 요청할 수 있습니다. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.