Azure 파일 동기화 동기화 상태 및 오류 문제 해결

아티클
04/11/2024

이 문서는 Azure 파일 동기화 배포에서 발생할 수 있는 일반적인 동기화 문제를 해결하고 resolve 데 도움이 되도록 설계되었습니다.

동기화 상태

SMB 또는 포털을 통해 Azure 파일 공유에서 직접 파일을 만든 경우 파일이 동기화 그룹의 서버와 동기화되는 데 얼마나 걸리나요?

Azure Portal 또는 SMB를 사용하여 Azure 파일 공유에 대한 변경 내용은 서버 엔드포인트의 변경 내용처럼 즉시 검색되고 복제되지 않습니다. Azure Files 아직 변경 알림 또는 저널링이 없으므로 파일이 변경되면 동기화 세션을 자동으로 시작할 방법이 없습니다. Windows Server에서 Azure 파일 동기화 Windows USN 저널링을 사용하여 파일이 변경되면 동기화 세션을 자동으로 시작합니다.

Azure 파일 공유에 대한 변경 내용을 검색하려면 Azure 파일 동기화 변경 검색 작업이라는 예약된 작업이 있습니다. 변경 검색 작업은 파일 공유의 모든 파일을 열거한 다음 해당 파일의 동기화 버전과 비교합니다. 변경 검색 작업에서 파일이 변경된 것으로 확인되면 Azure 파일 동기화 동기화 세션을 시작합니다. 변경 검색 작업은 24시간마다 시작됩니다. 변경 검색 작업은 Azure 파일 공유의 모든 파일을 열거하여 작동하므로 변경 검색은 작은 네임스페이스보다 큰 네임스페이스에서 더 오래 걸립니다. 큰 네임스페이스의 경우 변경된 파일을 확인하는 데 24시간마다 한 번 이상 걸릴 수 있습니다.

Azure 파일 공유 Invoke-AzStorageSyncChangeDetection 에서 변경된 파일을 즉시 동기화하기 위해 PowerShell cmdlet을 사용하여 Azure 파일 공유의 변경 내용 검색을 수동으로 시작할 수 있습니다. 이 cmdlet은 일부 유형의 자동화된 프로세스가 Azure 파일 공유를 변경하거나 관리자가 변경한 시나리오(예: 파일 및 디렉터리를 공유로 이동)를 위한 것입니다. 최종 사용자 변경의 경우 IaaS VM에 Azure 파일 동기화 에이전트를 설치하고 최종 사용자가 IaaS VM을 통해 파일 공유에 액세스하도록 하는 것이 좋습니다. 이렇게 하면 cmdlet을 사용할 Invoke-AzStorageSyncChangeDetection 필요 없이 모든 변경 내용이 다른 에이전트와 빠르게 동기화됩니다. 자세한 내용은 Invoke-AzStorageSyncChangeDetection 설명서를 참조하세요.

Windows Server의 볼륨에 대해 USN과 유사한 Azure 파일 공유에 대한 변경 검색을 추가하는 방법을 모색하고 있습니다. Azure 커뮤니티 피드백에서 투표하여 향후 개발을 위해 이 기능의 우선 순위를 지정하는 데 도움이 됩니다.

서버 엔드포인트 상태가 몇 시간 동안 보류 중입니다.

클라우드 엔드포인트를 만들고 데이터가 포함된 Azure 파일 공유를 사용하는 경우 이 문제가 발생할 수 있습니다. 파일이 클라우드와 서버 엔드포인트 간에 동기화되기 전에 Azure 파일 공유의 변경 내용을 검색하는 클라우드 변경 열거형 작업이 완료되어야 합니다. 작업을 완료하는 시간은 Azure 파일 공유의 네임스페이스 크기에 따라 달라집니다. 변경 열거형 작업이 완료되면 서버 엔드포인트 상태가 업데이트됩니다.

클라우드 변경 열거형 작업의 상태 검사 포털에서 클라우드 엔드포인트 속성으로 이동하면 상태 열거형 변경 섹션에 제공됩니다.

포털에서 서버 엔드포인트의 상태를 보려면 스토리지 동기화 서비스의동기화 그룹 섹션으로 이동하여 동기화 그룹을 선택합니다.

정상 상태 영구 동기화 오류 수가 0이면 동기화가 예상대로 작동함을 나타냅니다. 영구 동기화 오류의 개수가 0보다 큰 경우 파일 동기화에 실패하는 이유를 해결하기 위해 동기화되지 않는 특정 파일 또는 폴더가 있는지 어떻게 할까요? 참조하세요. 서버 엔드포인트에 Health 이외의 상태 상태 있는 경우 아래 표의 지침을 따릅니다.

상태 상태	설명	수정
건강	동기화 세션이 성공적으로 완료되거나 진행 중인 동기화 세션이 진행 중입니다(파일이 적용됨).	해당 없음
보류 중	서버 엔드포인트를 만든 후 보류 중인 상태 필요합니다. 서버 엔드포인트에 대한 동기화 원격 분석이 서비스로 전송되면 상태 상태 업데이트됩니다.	상태 상태 몇 시간 동안 변경되지 않는 경우 서버 엔드포인트 상태가 몇 시간 동안 보류 중 상태임을 참조하세요.
오류	동기화 세션이 오류로 실패했습니다.	이 문제를 resolve 포털에서 오류 상태 선택하여 오류 코드 및 수정 단계를 가져옵니다. 수정 단계가 포털에 나열되지 않았거나 문제를 resolve 않는 경우 이 문서의 오류 코드를 검색하여 자세한 지침을 확인하세요.
활동 없음	스토리지 동기화 서비스는 지난 2시간 동안 이 서버 엔드포인트에서 동기화 원격 분석을 받지 못했습니다.	이 문제를 resolve Azure 파일 동기화 동기화 그룹 관리 문제 해결의 단계를 수행합니다.
디스크 부족 모드	서버 엔드포인트가 있는 볼륨은 디스크 공간이 부족합니다.	이 문제를 resolve 볼륨의 디스크 공간을 확보합니다. 낮은 디스크 공간 모드에 대한 자세한 내용은 클라우드 계층화 개요를 참조하세요.
프로비저닝이 취소됨	서버 엔드포인트를 만들지 못했습니다. 동기화는 이 서버 엔드포인트에서 작동하지 않습니다.	이 문제를 resolve 서버 엔드포인트 만들기 및 삭제 오류를 참조하세요.

참고

서버 엔드포인트 상태(상태 및 활동)는 15분마다 새로 고쳐지고 서버에서 서비스로 전송되는 원격 분석 이벤트를 기반으로 합니다.

서버의 원격 분석 로그에서 가장 최근 9102 이벤트를 확인합니다(이벤트 뷰어 애플리케이션 및 서비스 로그\Microsoft\FileSync\Agent\Telemetry로 이동). 이 이벤트는 동기화 세션이 완료되면 기록됩니다. SyncDirection 는 이 세션이 업로드 또는 다운로드인지 여부를 알려줍니다. 가 HResult 0이면 동기화 세션이 성공했습니다. 0 HResult 이 아닌 경우 동기화 중에 오류가 발생했습니다. 일반적인 오류 목록은 아래를 참조하세요. 가 PerItemErrorCount 0보다 크면 일부 파일 또는 폴더가 제대로 동기화되지 않았습니다. 의 가 HResult 0이지만 0 PerItemErrorCount 보다 큰 을 가질 수 있습니다.

다음은 성공적인 업로드의 예입니다. 간단히 하기 위해 각 9102 이벤트에 포함된 값 중 일부만 나열됩니다.

Replica Sync session completed.
SyncDirection: Upload,
HResult: 0, 
SyncFileCount: 2, SyncDirectoryCount: 0,
AppliedFileCount: 2, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0,
TransferredFiles: 2, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

반대로 실패한 업로드는 다음과 같을 수 있습니다.

Replica Sync session completed.
SyncDirection: Upload,
HResult: -2134364065,
SyncFileCount: 0, SyncDirectoryCount: 0, 
AppliedFileCount: 0, AppliedDirCount: 0, AppliedTombstoneCount 0, AppliedSizeBytes: 0.
PerItemErrorCount: 0, 
TransferredFiles: 0, TransferredBytes: 0, FailedToTransferFiles: 0, FailedToTransferBytes: 0.

경우에 따라 동기화 세션이 전체적으로 실패하거나 0 PerItemErrorCount 이 아닌 경우 일부 파일이 성공적으로 동기화되어 계속 진행됩니다. 적용된 필드(AppliedFileCount, , AppliedDirCountAppliedTombstoneCount및 AppliedSizeBytes)를 확인하여 진행률을 확인할 수 있습니다. 이러한 필드는 세션의 성공 정도를 설명합니다. 실패한 행에 여러 동기화 세션이 표시되지만 적용 된 수가 증가하는 경우 지원 티켓을 열기 전에 동기화 시간을 다시 시도해야 합니다.

현재 동기화 세션의 진행률을 모니터링할 어떻게 할까요? 있나요?

포털
서버

동기화 그룹 내에서 서버 엔드포인트 속성으로 이동하여 동기화 상태 섹션을 확인하여 현재 동기화 세션에서 업로드되거나 다운로드된 파일 수를 확인합니다. 이 상태 약 15분 지연됩니다. 동기화 세션이 이 기간 내에 완료될 만큼 작으면 포털에서 보고되지 않을 수 있습니다.

참고

예상 완료가 비어 있으면 동기화 세션의 파일 수 계산이 완료되지 않았습니다.

서버의 원격 분석 로그에서 가장 최근 9302 이벤트를 확인합니다(이벤트 뷰어 애플리케이션 및 서비스 로그\Microsoft\FileSync\Agent\Telemetry로 이동). 이 이벤트는 현재 동기화 세션의 상태를 나타냅니다. TotalItemCount 는 동기화할 파일 수를 표시하고, AppliedItemCount 지금까지 동기화된 파일 수를 표시하며 PerItemErrorCount , 동기화에 실패한 파일 수를 나타냅니다(이 문제를 처리하는 방법은 다음 참조).

Replica Sync Progress. 
ServerEndpointName: <CI>sename</CI>, SyncGroupName: <CI>sgname</CI>, ReplicaName: <CI>rname</CI>, 
SyncDirection: Upload, CorrelationId: {AB4BA07D-5B5C-461D-AAE6-4ED724762B65}. 
AppliedItemCount: 172473, TotalItemCount: 624196. AppliedBytes: 51473711577, 
TotalBytes: 293363829906. 
AreTotalCountsFinal: true. 
PerItemErrorCount: 1006.

서버가 서로 동기화되어 있는지 어떻게 할까요? 알 수 있나요?

포털
서버

지정된 동기화 그룹의 각 서버에 대해 다음을 확인합니다.

클라우드에 업로드 및 서버에 다운로드에 대한 타임스탬프는 최근 버전입니다.
상태 업로드 및 다운로드 모두에 녹색입니다.
서버 엔드포인트 속성 내의 동기화 상태 섹션에는 동기화할 파일이 거의 없거나 전혀 표시되지 않습니다.
서버 엔드포인트 속성 내의 영구 동기화 오류 및 일시적인 동기화 오류 필드에는 0의 수가 있습니다.

각 서버에 대한 원격 분석 이벤트 로그에서 9102 이벤트로 표시된 완료된 동기화 세션을 확인합니다(이벤트 뷰어 애플리케이션 및 서비스 로그\Microsoft\FileSync\Agent\Telemetry로 이동).

지정된 서버에서 최신 업로드 및 다운로드 세션이 성공적으로 완료되었는지 확인하려고 합니다.

이렇게 하려면 및 가 HResultPerItemErrorCount 업로드 및 다운로드 모두에 대해 0임을 검사(SyncDirection필드는 지정된 세션이 업로드 또는 다운로드 세션인지 여부를 나타낸다). 최근에 완료된 동기화 세션이 표시되지 않으면 현재 동기화 세션이 진행 중일 가능성이 높으며, 대량의 데이터를 추가하거나 수정한 경우 예상되는 것입니다.
서버가 클라우드와 완전히 최신 상태이고 어느 방향으로든 동기화를 변경하지 않으면 빈 동기화 세션이 표시됩니다. 모든 Sync* 필드(SyncFileCount, , SyncTombstoneCount및 )가 0인 업로드 및 SyncSizeBytes다운로드 이벤트로 표시됩니다. 즉, SyncDirCount동기화할 항목이 없습니다. 이러한 빈 동기화 세션은 항상 동기화할 새로운 항목이 있으므로 변동이 많은 서버에서 발생하지 않을 수 있습니다. 동기화 작업이 없는 경우 30분마다 발생해야 합니다.
모든 서버가 클라우드를 사용하여 최신 상태인 경우 최근 업로드 및 다운로드 세션이 빈 동기화 세션임을 의미하며 시스템 전체가 동기화 중임을 합리적으로 확신할 수 있습니다.

Azure 파일 공유에서 직접 변경한 경우 24시간마다 한 번씩 발생하는 변경 열거형이 실행될 때까지 Azure 파일 동기화 이러한 변경 내용을 검색하지 않습니다. 실제로 Azure 파일 공유에서 직접 변경한 내용이 누락된 경우 서버가 클라우드를 최신 상태로 유지한다고 말할 수 있습니다.

동기화되지 않는 특정 파일 또는 폴더가 있는지 확인할 어떻게 할까요? 있나요?

포털 또는 PerItemErrorCount 서버에서 영구 동기화 오류 및 일시적 동기화 오류가 지정된 동기화 세션에 대해 0보다 큰 경우 일부 항목이 동기화되지 않음을 의미합니다. 파일 및 폴더에는 동기화를 방해하는 특성이 있을 수 있습니다. 이러한 특성은 영구적일 수 있으며 동기화를 다시 시작하려면 명시적 작업이 필요합니다(예: 파일 또는 폴더 이름에서 지원되지 않는 문자 제거). 일시적일 수도 있습니다. 즉, 파일 또는 폴더가 자동으로 동기화를 다시 시작합니다. 예를 들어 열려 있는 핸들이 있는 파일은 파일이 닫히면 자동으로 동기화를 다시 시작합니다. Azure 파일 동기화 엔진이 이러한 문제를 감지하면 현재 제대로 동기화되지 않는 항목을 나열하기 위해 구문 분석할 수 있는 오류 로그가 생성됩니다.

참고

동기화 세션이 완료되면 포털에서 영구 동기화 오류 및 일시적인 동기화 오류 수가 업데이트됩니다. 동기화 세션이 진행 중인 경우 나머지 오류를 조사하기 전에 동기화 세션이 완료되고 영구 동기화 오류 및 일시적 동기화 오류 수가 업데이트될 때까지 기다립니다.

동기화에 실패한 파일 및 디렉터리의 이름을 보려면FileSyncErrorsReport.ps1PowerShell 스크립트(Azure 파일 동기화 에이전트의 에이전트 설치 디렉터리에 있음)를 실행하거나 cmdlet을 Debug-StorageSyncServer 사용합니다. ItemPath 필드는 루트 동기화 디렉터리를 기준으로 파일의 위치를 알려줍니다. 수정 단계는 항목별 일반적인 오류 목록을 참조하세요.

cmdlet을 사용하여 Debug-StorageSyncServer 서버에서 동기화하지 못하는 파일을 식별하려면 다음 PowerShell 명령을 실행합니다.

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

참고

FileSyncErrorsReport.ps1 스크립트가 "파일 오류를 찾을 수 없음"을 반환하거나 동기화 그룹에 대한 항목별 오류를 나열하지 않는 경우 원인은 다음과 같습니다.

원인 1: 마지막으로 완료된 동기화 세션에 항목별 오류가 없습니다. "0 파일이 동기화되지 않음"을 표시하도록 포털을 곧 업데이트해야 합니다. 기본적으로 FileSyncErrorsReport.ps1 스크립트는 마지막으로 완료된 동기화 세션에 대한 항목별 오류만 표시합니다. 모든 동기화 세션에 대한 항목별 오류를 보려면 매개 변수를 -ReportAllErrors 사용합니다. 원격 분석 이벤트 로그에서 가장 최근 이벤트 ID 9102 를 확인하여 가 PerItemErrorCount 0인지 확인합니다.
원인 2: ItemResults 너무 많은 항목별 오류로 인해 래핑된 서버의 이벤트 로그와 이 동기화 그룹에 대한 오류가 더 이상 이벤트 로그에 포함되지 않습니다. 이 문제를 방지하려면 이벤트 로그 크기를 늘입니다 ItemResults . 이벤트 로그는 ItemResults 이벤트 뷰어 애플리케이션 및 서비스 로그\Microsoft\FileSync\Agent에서 찾을 수 있습니다.

동기화 오류

파일/디렉터리 동기화 오류당 문제 해결

오류로 인해 파일 또는 디렉터리가 동기화되지 않으면 이벤트가 Microsoft-FileSync-Agent/ItemResults 이벤트 로그에 기록됩니다. 이 섹션에서는 항목별 오류에 대한 일반적인 오류 코드 및 수정 단계를 설명합니다.

참고

파일 또는 디렉터리가 동기화되지 않으면 해당 항목을 동기화하는 Azure 파일 동기화 다시 시도하기까지 최대 30분이 걸릴 수 있습니다. 서버 엔드포인트 위치 내에서 변경 내용이 검색되지 않으면 Azure 파일 동기화 30분마다 동기화 세션을 시작합니다. 동기화 세션을 강제로 적용하려면 스토리지 동기화 에이전트(FileSyncSvc) 서비스를 다시 시작하거나 서버 엔드포인트 위치 내의 파일 또는 디렉터리를 변경합니다.

ItemResults 이벤트 로그에 기록되는 일반적인 항목별 동기화 오류

Hresult	HRESULT(10진수)	오류 문자열	문제	수정
0x80070043	-2147942467	ERROR_BAD_NET_NAME	서버의 계층화된 파일에 액세스할 수 없습니다. 이 문제는 서버 엔드포인트를 삭제하기 전에 계층화된 파일이 회수되지 않은 경우에 발생합니다.	이 문제를 resolve 서버 엔드포인트를 삭제한 후 계층화된 파일에 액세스할 수 없음을 참조하세요.
0x80c80207	-2134375929	ECS_E_SYNC_CONSTRAINT_CONFLICT	종속 폴더가 아직 동기화되지 않았기 때문에 파일 또는 디렉터리 변경 내용은 아직 동기화할 수 없습니다. 이 항목은 종속 변경 내용이 동기화된 후 동기화됩니다.	일시적인 오류입니다. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0x80C8028A	-2134375798	ECS_E_SYNC_CONSTRAINT_CONFLICT_ON_FAILED_DEPENDEE	종속 폴더가 아직 동기화되지 않았기 때문에 파일 또는 디렉터리 변경 내용은 아직 동기화할 수 없습니다. 이 항목은 종속 변경 내용이 동기화된 후 동기화됩니다.	일시적인 오류입니다. 오류가 지속되면 FileSyncErrorsReport.ps1 PowerShell 스크립트를 사용하여 종속 폴더가 아직 동기화되지 않은 이유를 확인합니다.
0x80c80284	-2134375804	ECS_E_SYNC_CONSTRAINT_CONFLICT_SESSION_FAILED	종속 폴더가 아직 동기화되지 않았고 동기화 세션이 실패했기 때문에 파일 또는 디렉터리 변경을 아직 동기화할 수 없습니다. 이 항목은 종속 변경 내용이 동기화된 후 동기화됩니다.	아무 작업도 필요하지 않습니다. 오류가 지속되면 동기화 세션 실패를 조사합니다.
0x8007007b	-2147024773	ERROR_INVALID_NAME	파일 또는 디렉터리 이름이 잘못되었습니다.	해당 파일 또는 디렉터리의 이름을 바꿉니다. 자세한 내용은 지원되지 않는 문자 처리를 참조하세요.
0x80070459	-2147023783	ERROR_NO_UNICODE_TRANSLATION	파일 또는 디렉터리 이름에는 지원되지 않는 서로게이트 쌍 문자가 있습니다.	해당 파일 또는 디렉터리의 이름을 바꿉니다. 자세한 내용은 지원되지 않는 문자 처리를 참조하세요.
0x80c80255	-2134375851	ECS_E_XSMB_REST_INCOMPATIBILITY	파일 또는 디렉터리 이름이 잘못되었습니다.	해당 파일 또는 디렉터리의 이름을 바꿉니다. 자세한 내용은 지원되지 않는 문자 처리를 참조하세요.
0x80c80018	-2134376424	ECS_E_SYNC_FILE_IN_USE	파일이 사용 중이므로 동기화할 수 없습니다. 파일이 더 이상 사용되지 않을 때 동기화됩니다.	아무 작업도 필요하지 않습니다. Azure 파일 동기화 열려 있는 핸들이 있는 파일을 동기화하기 위해 서버에서 하루에 한 번 임시 VSS 스냅샷 만듭니다.
0x80c8031d	-2134375651	ECS_E_CONCURRENCY_CHECK_FAILED	파일이 변경되었지만 동기화를 통해 변경 내용이 아직 검색되지 않았습니다. 이 변경 내용이 검색되면 동기화가 복구됩니다.	아무 작업도 필요하지 않습니다.
0x80070002	-2147024894	ERROR_FILE_NOT_FOUND	파일이 삭제되었으며 동기화에서 변경 사항을 인식하지 못합니다.	아무 작업도 필요하지 않습니다. 변경 검색에서 파일이 삭제된 것을 감지하면 동기화에서 이 오류의 로깅을 중지합니다.
0x80070003	-2147024893	ERROR_PATH_NOT_FOUND	항목이 대상에서 이미 삭제되었으며 동기화에서 변경 사항을 인식하지 못하므로 파일 또는 디렉터리의 삭제를 동기화할 수 없습니다.	아무 작업도 필요하지 않습니다. 대상에서 변경 검색이 실행되고 동기화에서 항목이 삭제되었음을 감지하면 동기화에서 이 오류 로깅을 중지합니다.
0x80c80205	-2134375931	ECS_E_SYNC_ITEM_SKIP	파일 또는 디렉터리를 건너뛰었지만 다음 동기화 세션 중에 동기화됩니다. 항목을 다운로드할 때 이 오류가 보고되면 파일 또는 디렉터리 이름이 잘못되었습니다.	파일을 업로드할 때 이 오류가 보고되는 경우 아무 작업도 필요하지 않습니다. 파일을 다운로드할 때 오류가 보고되면 해당 파일 또는 디렉터리의 이름을 바꿉니다. 자세한 내용은 지원되지 않는 문자 처리를 참조하세요.
0x800700B7	-2147024713	ERROR_ALREADY_EXISTS	항목이 대상에 이미 있고 동기화에서 변경 사항을 인식하지 못하므로 파일 또는 디렉터리 만들기를 동기화할 수 없습니다.	아무 작업도 필요하지 않습니다. 대상에서 변경 검색이 실행되고 동기화에서 이 새 항목을 인식하면 동기화에서 이 오류 로깅을 중지합니다.
0x80c8603e	-2134351810	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED	Azure 파일 공유 제한에 도달했기 때문에 파일을 동기화할 수 없습니다.	이 문제를 resolve 문제 해결 가이드의 Azure 파일 공유 스토리지 제한 섹션에 도달했습니다.
0x80c83008	-2134364152	ECS_E_CANNOT_CREATE_AZURE_STAGED_FILE	Azure 파일 공유 제한에 도달했기 때문에 파일을 동기화할 수 없습니다.	이 문제를 resolve 문제 해결 가이드의 Azure 파일 공유 스토리지 제한 섹션에 도달했습니다.
0x80c8027C	-2134375812	ECS_E_ACCESS_DENIED_EFS	파일은 지원되지 않는 솔루션(예: NTFS EFS)에 의해 암호화됩니다.	파일의 암호를 해독하고 지원되는 암호화 솔루션을 사용합니다. 지원 솔루션 목록은 계획 가이드의 암호화 섹션을 참조하세요.
0x80c80283	-2160591491	ECS_E_ACCESS_DENIED_DFSRRO	파일은 DFS-R 읽기 전용 복제 폴더에 있습니다.	파일은 DFS-R 읽기 전용 복제 폴더에 있습니다. Azure 파일 동기화 DFS-R 읽기 전용 복제 폴더의 서버 엔드포인트를 지원하지 않습니다. 자세한 내용은 계획 가이드 를 참조하세요.
0x80070005	-2147024891	ERROR_ACCESS_DENIED	파일에 삭제 보류 상태가 있습니다.	아무 작업도 필요하지 않습니다. 열려 있는 모든 파일 핸들이 닫혀 있으면 파일이 삭제됩니다.
0x80c86044	-2134351804	ECS_E_AZURE_AUTHORIZATION_FAILED	스토리지 계정의 방화벽 및 가상 네트워크 설정이 사용하도록 설정되어 있고 서버에 스토리지 계정에 대한 액세스 권한이 없기 때문에 파일을 동기화할 수 없습니다.	배포 가이드의 방화벽 및 가상 네트워크 설정 구성 섹션에 설명된 단계에 따라 서버 IP 주소 또는 가상 네트워크를 추가합니다.
0x8000ffff	-2147418113	E_UNEXPECTED	예기치 않은 오류로 인해 파일을 동기화할 수 없습니다.	며칠 동안 오류가 지속되면 지원 사례를 여세요.
0x80070020	-2147024864	ERROR_SHARING_VIOLATION	파일이 사용 중이므로 동기화할 수 없습니다. 파일이 더 이상 사용되지 않을 때 동기화됩니다.	아무 작업도 필요하지 않습니다.
0x80c80017	-2134376425	ECS_E_SYNC_OPLOCK_BROKEN	동기화 중에 파일이 변경되었으므로 다시 동기화해야 합니다.	아무 작업도 필요하지 않습니다.
0x80070017	-2147024873	ERROR_CRC	CRC 오류로 인해 파일을 동기화할 수 없습니다. 이 오류는 서버 엔드포인트를 삭제하기 전에 계층화된 파일이 회수되지 않았거나 파일이 손상된 경우에 발생할 수 있습니다.	이 문제를 resolve 하려면 분리된 계층화된 파일을 제거하기 위해 서버 엔드포인트를 삭제한 후 서버에서 계층화된 파일에 액세스할 수 없음을 참조하세요. 분리된 계층화된 파일을 제거한 후에도 오류가 계속 발생하면 볼륨에서 chkdsk 를 실행합니다.
0x80c80200	-2134375936	ECS_E_SYNC_CONFLICT_NAME_EXISTS	최대 충돌 파일 수에 도달했기 때문에 파일을 동기화할 수 없습니다. Azure 파일 동기화 파일당 100개의 충돌 파일을 지원합니다. 파일 충돌에 대한 자세한 내용은 Azure 파일 동기화 FAQ를 참조하세요.	이 문제를 resolve 충돌 파일 수를 줄입니다. 충돌 파일 수가 100개 미만이면 파일이 동기화됩니다.
0x80c8027d	-2134375811	ECS_E_DIRECTORY_RENAME_FAILED	디렉터리 내의 파일 또는 폴더에 열려 있는 핸들이 있으므로 디렉터리의 이름을 동기화할 수 없습니다.	아무 작업도 필요하지 않습니다. 디렉터리 내의 열려 있는 모든 파일 핸들을 닫으면 디렉터리의 이름이 동기화됩니다.
0x800700de	-2147024674	ERROR_BAD_FILE_TYPE	서버의 계층화된 파일은 Azure 파일 공유에 더 이상 존재하지 않는 파일 버전을 참조하기 때문에 액세스할 수 없습니다.	이 문제는 계층화된 파일이 Windows Server의 백업에서 복원된 경우에 발생할 수 있습니다. 이 문제를 resolve Azure 파일 공유의 스냅샷 파일을 복원합니다.
0x80C80065	-2134376347	ECS_E_DATA_TRANSFER_BLOCKED	동기화하는 동안 영구 오류를 생성하도록 파일이 식별되었습니다. 따라서 재시도 간격에 도달할 때까지 동기화가 차단됩니다. 파일은 나중에 다시 시도됩니다.	아무 작업도 필요하지 않습니다. 파일은 24시간 후에 다시 시도됩니다. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0x80C80203	-2134375933	ECS_E_SYNC_INVALID_STAGED_FILE	파일 전송 오류입니다. 서비스는 나중에 다시 시도합니다.	아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0x80c8027f	-2134375809	ECS_E_SYNC_CONSTRAINT_CONFLICT_CYCLIC_DEPENDENCY	동기화 세션 시간 제한 오류입니다.	아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0x80070035	-2147024843	ERROR_BAD_NETPATH	네트워크 경로를 찾지 못했습니다.	아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0x80071779	-2147018887	ERROR_FILE_READ_ONLY	지정된 파일은 읽기 전용입니다.	오류가 하루 이상 지속되면 지원 요청을 만듭니다.
0x80070006	-2147024890	ERROR_INVALID_HANDLE	내부 오류가 발생했습니다.	오류가 하루 이상 지속되면 지원 요청을 만듭니다.
0x8007012f	-2147024593	ERROR_DELETE_PENDING	파일이 삭제되는 중이므로 파일을 열 수 없습니다.	아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0x80041007	-2147217401	SYNC_E_ITEM_MUST_EXIST	내부 오류가 발생했습니다.	오류가 하루 이상 지속되면 지원 요청을 만듭니다.
0X80C80293	-2134375789	ECS_E_SYNC_INITIAL_SCAN_COMPLETED	초기 열거가 완료되어 동기화 세션이 실패했습니다. 다음 세션에서는 전체 네임스페이스를 다룹니다.	아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.
0X80C80342	-2134375614	ECS_E_SYNC_CUSTOM_METADATA_VERSION_NOT_SUPPORTED	동기화 데이터베이스에는 지원되는 버전보다 높은 버전이 있는 사용자 지정 메타데이터가 있습니다.	파일 동기화 에이전트를 최신 버전으로 업그레이드하세요. 에이전트를 업그레이드한 후에도 오류가 지속되면 지원 요청을 만듭니다.

지원되지 않는 문자 처리

Azure 파일 동기화 에이전트 v17은 잘못된 서로게이트 쌍을 제외하고 NTFS 파일 시스템에서 지원하는 모든 문자를 지원합니다.

포털 또는 FileSyncErrorsReport.ps1 PowerShell 스크립트에 지원되지 않는 문자로 인해 항목별 동기화 오류(오류 코드 0x8007007b, 0x80c80255 또는 0x80070459)가 표시되는 경우 Azure 파일 동기화 에이전트 v17이 서버에 설치되어 있는지 여부를 검사. 에이전트 v17이 설치되어 있고 잘못된 문자로 인해 파일이 여전히 동기화되지 않는 경우 ScanUnsupportedChars 스크립트를 사용하여 지원되지 않는 문자가 포함된 파일의 이름을 바꿉니다.

일반적인 동기화 오류

이 섹션에서는 오류와 함께 동기화 세션이 실패할 때 발생하는 일반적인 오류 코드 및 수정 단계를 설명합니다.

동기화 세션이 취소되었습니다.

오류	코드
Hresult	0x800704c7
HRESULT(10진수)	-2147023673
오류 문자열	ERROR_CANCELLED
수정 필요	아니오

다시 시작 또는 업데이트되는 서버, VSS 스냅샷 등 다양한 이유로 동기화 세션이 실패할 수 있습니다. 이 오류는 후속 작업이 필요한 것처럼 보이지만 몇 시간 동안 지속되지 않는 한 이 오류를 무시해도 안전합니다.

파일 동기화 세션은 열려 있는 핸들과 파일을 동기화하기 위해 하루에 한 번 실행되는 볼륨 스냅샷 동기화 세션에 의해 취소되었습니다.

오류	코드
Hresult	0x80c8029c
HRESULT(10진수)	-2134375780
오류 문자열	ECS_E_SYNC_CANCELLED_BY_VSS
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 오류가 하루 이상 지속되면 지원 요청을 만듭니다.

서비스와의 연결을 설정할 수 없습니다.

오류	코드
Hresult	0x80072ee7
HRESULT(10진수)	-2147012889
오류 문자열	WININET_E_NAME_NOT_RESOLVED
수정 필요	예

오류	코드
Hresult	0x80c83081
HRESULT(10진수)	-2134364031
오류 문자열	ECS_E_HTTP_CLIENT_CONNECTION_ERROR
수정 필요	예

오류	코드
Hresult	0x80c8309a
HRESULT(10진수)	-2134364006
오류 문자열	ECS_E_AZURE_STORAGE_REMOTE_NAME_NOT_RESOLVED
수정 필요	예

오류	코드
Hresult	0xc00000c4
HRESULT(10진수)	-1073741628
오류 문자열	UNEXPECTED_NETWORK_ERROR
수정 필요	예

오류	코드
Hresult	0x80072ee2
HRESULT(10진수)	-2147012894
오류 문자열	WININET_E_TIMEOUT
수정 필요	예

이 오류는 서버에서 Azure 파일 동기화 서비스에 액세스할 수 없는 경우에 발생할 수 있습니다. 다음 단계를 수행하여 이 오류를 해결할 수 있습니다.

Windows 서비스 FileSyncSvc.exe 방화벽에 의해 차단되지 않는지 확인합니다.
포트 443이 Azure 파일 동기화 서비스에 대한 나가는 연결에 열려 있는지 확인합니다. cmdlet을 Test-NetConnection 사용하여 이 작업을 수행할 수 있습니다. 아래 자리 표시자의 URL <azure-file-sync-endpoint> 은 Azure 파일 동기화 프록시 및 방화벽 설정 문서에서 찾을 수 있습니다.
```
Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
```
프록시 구성이 예상대로 설정되어 있는지 확인합니다. cmdlet을 Get-StorageSyncProxyConfiguration 사용하여 이 작업을 수행할 수 있습니다. Azure 파일 동기화 프록시 구성 구성에 대한 자세한 내용은 Azure 파일 동기화 프록시 및 방화벽 설정에서 확인할 수 있습니다.
```
$agentPath = "C:\Program Files\Azure\StorageSyncAgent"
Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncProxyConfiguration
```
cmdlet을 Test-StorageSyncNetworkConnectivity 사용하여 서비스 엔드포인트에 대한 네트워크 연결을 검사. 자세한 내용은 서비스 엔드포인트에 대한 네트워크 연결 테스트를 참조하세요.
네트워크 연결 문제 해결에 대한 추가 지원은 네트워크 관리자에게 문의하세요.

참고

Azure 파일 동기화 서비스에 대한 네트워크 연결이 복원되면 동기화가 즉시 다시 시작되지 않을 수 있습니다. 기본적으로 Azure 파일 동기화 서버 엔드포인트 위치 내에서 변경 내용이 검색되지 않으면 30분마다 동기화 세션을 시작합니다. 동기화 세션을 강제로 적용하려면 스토리지 동기화 에이전트(FileSyncSvc) 서비스를 다시 시작하거나 서버 엔드포인트 위치 내의 파일 또는 디렉터리를 변경합니다.

사용자 요청이 서비스에 의해 제한되었습니다.

오류	코드
Hresult	0x80c8004c
HRESULT(10진수)	-2134376372
오류 문자열	ECS_E_USER_REQUEST_THROTTLED
수정 필요	아니오

아무 작업도 필요하지 않습니다. 서버가 다시 시도합니다. 이 오류가 몇 시간 동안 지속되면 지원 요청을 만듭니다.

작업이 중단되어 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83000
HRESULT(10진수)	-2134364160
오류 문자열	ECS_E_OPERATION_ABORTED
수정 필요	아니오

아무 조치도 필요하지 않습니다. 이 오류가 몇 시간 동안 지속되면 지원 요청을 만듭니다.

작업이 취소되었습니다.

오류	코드
Hresult	0x80c8308d
HRESULT(10진수)	-2134364019
오류 문자열	ECS_E_REQUEST_CANCELLED_EXTERNALLY
수정 필요	아니오

오류	코드
Hresult	0x8013153b
HRESULT(10진수)	-2146233029
오류 문자열	COR_E_OPERATIONCANCELED
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

변경 내용 검색이 복원 후 완료될 때까지 동기화가 차단됩니다.

오류	코드
Hresult	0x80c83075
HRESULT(10진수)	-2134364043
오류 문자열	ECS_E_SYNC_BLOCKED_ON_CHANGE_DETECTION_POST_RESTORE
수정 필요	아니오

아무 조치도 필요하지 않습니다. Azure Backup 사용하여 파일 또는 파일 공유(클라우드 엔드포인트)를 복원하면 Azure 파일 공유에서 변경 내용 검색이 완료될 때까지 동기화가 차단됩니다. 복원이 완료되고 기간은 파일 공유의 파일 수에 따라 변경 검색이 즉시 실행됩니다.

동기화 폴더에서 복원의 일부로 시작된 일시 중지로 인해 폴더에서 동기화가 차단됩니다.

오류	코드
Hresult	0x80c83058
HRESULT(10진수)	-2134364072
오류 문자열	ECS_E_SYNC_BLOCKED_ON_RESTORE
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

동기화 데이터베이스가 언로드되어 동기화에 실패했습니다.

오류	코드
Hresult	0x80041295
HRESULT(10진수)	-2147216747
오류 문자열	SYNC_E_METADATA_INVALID_OPERATION
수정 필요	아니오

이 오류는 일반적으로 백업 애플리케이션이 VSS 스냅샷 만들고 동기화 데이터베이스가 언로드될 때 발생합니다. 이 오류가 몇 시간 동안 지속되면 지원 요청을 만듭니다.

동기화는 클라우드 엔드포인트에 지정된 Azure 파일 공유에 액세스할 수 없습니다.

오류	코드
Hresult	0x80c8305f
HRESULT(10진수)	-2134364065
오류 문자열	ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED
수정 필요	예

오류	코드
Hresult	0x80c86053
HRESULT(10진수)	-2134351789
오류 문자열	ECS_E_AZURE_FILE_SHARE_NOT_ACCESSIBLE
수정 필요	예

이 오류는 Azure 파일 동기화 에이전트가 Azure 파일 공유에 액세스할 수 없기 때문에 발생합니다. 이는 Azure 파일 공유 또는 호스트하는 스토리지 계정이 더 이상 존재하지 않기 때문일 수 있습니다. 다음 단계를 수행하여 이 오류를 해결할 수 있습니다.

스토리지 계정이 있는지 확인합니다.
Azure 파일 공유가 있는지 확인합니다.
Azure 파일 동기화 스토리지 계정에 액세스할 수 있는지 확인합니다.
스토리지 계정의 SMB 보안 설정 에서 SMB 3.1.1 프로토콜 버전, NTLM v2 인증 및 AES-128-GCM 암호화를 허용하는지 확인합니다. 스토리지 계정에서 SMB 보안 설정을 검사 SMB 보안 설정을 참조하세요.
스토리지 계정의 방화벽 및 가상 네트워크 설정이 제대로 구성되었는지 확인합니다(사용하도록 설정된 경우).

요청이 이 작업을 수행할 권한이 없기 때문에 동기화에 실패했습니다.

오류	코드
Hresult	0x80c86044
HRESULT(10진수)	-2134351804
오류 문자열	ECS_E_AZURE_AUTHORIZATION_FAILED
수정 필요	예

이 오류는 Azure 파일 동기화 에이전트가 Azure 파일 공유에 액세스할 권한이 없기 때문에 발생합니다. 다음 단계를 수행하여 이 오류를 해결할 수 있습니다.

사용된 스토리지 계정 이름을 확인할 수 없습니다.

오류	코드
Hresult	0x80C83060
HRESULT(10진수)	-2134364064
오류 문자열	ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
수정 필요	예

서버에서 스토리지 DNS 이름을 resolve 수 있는지 확인합니다.

Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443

스토리지 계정이 있는지 확인합니다.
스토리지 계정의 방화벽 및 가상 네트워크 설정이 제대로 구성되었는지 확인합니다(사용하도록 설정된 경우).

참고

스토리지 계정에 액세스하는 동안 알 수 없는 오류가 발생했습니다.

오류	코드
Hresult	0x80c8308a
HRESULT(10진수)	-2134364022
오류 문자열	ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
수정 필요	예

스토리지 계정이 잠겨 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83092
HRESULT(10진수)	-2134364014
오류 문자열	ECS_E_STORAGE_ACCOUNT_LOCKED
수정 필요	예

이 오류는 스토리지 계정에 읽기 전용 리소스 잠금이 있기 때문에 발생합니다. 이 문제를 resolve 스토리지 계정에서 읽기 전용 리소스 잠금을 제거합니다.

동기화 데이터베이스 문제로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x8e5e044e
HRESULT(10진수)	-1906441138
오류 문자열	JET_errWriteConflict
수정 필요	예

이 오류는 Azure 파일 동기화 사용하는 내부 데이터베이스에 문제가 있을 때 발생합니다. 이 문제가 발생하면 지원 요청을 만들고 이 문제를 resolve 데 도움이 되도록 연락을 드립니다.

서버에 설치된 Azure 파일 동기화 에이전트 버전은 지원되지 않습니다.

오류	코드
Hresult	0x80C8306B
HRESULT(10진수)	-2134364053
오류 문자열	ECS_E_AGENT_VERSION_BLOCKED
수정 필요	예

이 오류는 서버에 설치된 Azure 파일 동기화 에이전트 버전이 지원되지 않는 경우에 발생합니다. 이 문제를 resolve 지원되는 에이전트 버전으로 업그레이드합니다.

Azure 파일 공유 스토리지 제한에 도달했습니다.

오류	코드
Hresult	0x80c8603e
HRESULT(10진수)	-2134351810
오류 문자열	ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED
수정 필요	예

오류	코드
Hresult	0x80c80249
HRESULT(10진수)	-2134375863
오류 문자열	ECS_E_NOT_ENOUGH_REMOTE_STORAGE
수정 필요	예

Azure 파일 공유 스토리지 제한에 도달하면 이러한 오류 중 하나로 동기화 세션이 실패합니다. 이는 Azure 파일 공유에 할당량이 적용되거나 사용량이 Azure 파일 공유에 대한 제한을 초과하는 경우에 발생할 수 있습니다. 자세한 내용은 Azure 파일 공유에 대한 현재 제한을 참조하세요.

스토리지 동기화 서비스 내의 동기화 그룹으로 이동합니다.
동기화 그룹 내에서 클라우드 엔드포인트를 선택합니다.
열린 창에서 Azure 파일 공유 이름을 확인합니다. 파일 공유 이름을 선택하여 스토리지 계정에서 파일 공유 설정 페이지를 엽니다.
파일 공유를 선택하여 개요 페이지에서 세부 정보를 가져옵니다.
할당량 편집을 선택하여 파일 공유 할당량을 확인합니다. 대체 할당량을 지정하지 않으면 할당량은 Azure 파일 공유의 최대 크기와 일치합니다.

파일 공유가 가득 차면(사용된 용량이 할당량과 같음) 파일 공유의 공간을 확보합니다. 이 문제를 해결하는 한 가지 가능한 방법은 현재 서버 엔드포인트의 각 하위 폴더를 자체 동기화 그룹의 자체 서버 엔드포인트로 만드는 것입니다. 이렇게 하면 각 하위 폴더가 개별 Azure 파일 공유와 동기화됩니다.

Azure 파일 공유를 찾을 수 없습니다.

오류	코드
Hresult	0x80c86030
HRESULT(10진수)	-2134351824
오류 문자열	ECS_E_AZURE_FILE_SHARE_NOT_FOUND
수정 필요	예

이 오류는 Azure 파일 공유에 액세스할 수 없는 경우에 발생합니다. 문제를 해결하려면 다음을 수행합니다.

스토리지 계정이 있는지 확인합니다.
Azure 파일 공유가 있는지 확인합니다.
스토리지 계정의 SMB 보안 설정 에서 SMB 3.1.1 프로토콜 버전, NTLM v2 인증 및 AES-128-GCM 암호화를 허용하는지 확인합니다. 스토리지 계정에서 SMB 보안 설정을 검사 SMB 보안 설정을 참조하세요.

Azure 파일 공유가 삭제된 경우 새 파일 공유를 만든 다음 동기화 그룹을 다시 만들어야 합니다.

이 Azure 구독이 일시 중단되는 동안 동기화가 일시 중지됩니다.

오류	코드
Hresult	0x80C83076
HRESULT(10진수)	-2134364042
오류 문자열	ECS_E_SYNC_BLOCKED_ON_SUSPENDED_SUBSCRIPTION
수정 필요	예

이 오류는 Azure 구독이 일시 중단될 때 발생합니다. Azure 구독이 복원되면 동기화를 다시 사용할 수 있습니다. 자세한 내용은 Azure 구독을 사용하지 않도록 설정한 이유와 다시 활성화하는 방법을 참조하세요 .

스토리지 계정에 방화벽 또는 가상 네트워크가 구성되어 있습니다.

오류	코드
Hresult	0x80c8033e
HRESULT(10진수)	-2134375618
오류 문자열	ECS_E_SERVER_BLOCKED_BY_NETWORK_ACL
수정 필요	예

이 오류는 스토리지 계정 방화벽 또는 스토리지 계정이 가상 네트워크에 속하기 때문에 Azure 파일 공유에 액세스할 수 없는 경우에 발생합니다. 스토리지 계정의 방화벽 및 가상 네트워크 설정이 제대로 구성되었는지 확인합니다. 자세한 내용은 방화벽 및 가상 네트워크 설정 구성을 참조하세요.

동기화 데이터베이스 문제로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c80219
HRESULT(10진수)	-2134375911
오류 문자열	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT
수정 필요	아니오

오류	코드
Hresult	0x80c83044
HRESULT(10진수)	-2134364092
오류 문자열	ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT_SERVICEUNAVAILABLE
수정 필요	아니오

이러한 오류는 일반적으로 자체적으로 resolve 다음과 같은 경우 발생할 수 있습니다.

동기화 그룹의 서버에서 많은 수의 파일이 변경됩니다.
개별 파일 및 디렉터리에 대한 많은 오류입니다.

이 오류가 몇 시간 이상 지속되는 경우 지원 요청을 만들고 이 문제를 resolve 수 있도록 연락을 드립니다.

동기화 데이터베이스에 스토리지 사용 중 IO 오류가 발생했습니다.

오류	코드
Hresult	0x80c8021f
HRESULT(10진수)	-2134375905
오류 문자열	ECS_E_SYNC_METADATA_IO_BUSY
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

동기화 데이터베이스에 IO 시간 제한이 발생했습니다.

오류	코드
Hresult	0x80c8021e
HRESULT(10진수)	-2134375906
오류 문자열	ECS_E_SYNC_METADATA_IO_TIMEOUT
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

동기화 데이터베이스에 IO 오류가 발생했습니다.

오류	코드
Hresult	0x80c80220
HRESULT(10진수)	-2134375904
오류 문자열	ECS_E_SYNC_METADATA_IO_ERROR
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

데이터가 손상되어 읽을 수 없어 동기화에 실패했습니다.

오류	코드
Hresult	0x80071128
HRESULT(10진수)	-2147020504
오류 문자열	ERROR_INVALID_REPARSE_DATA
수정 필요	예

이 오류는 서버 엔드포인트가 있는 NTFS 볼륨에 파일 시스템 손상이 있는 경우에 발생할 수 있습니다. 이 오류를 resolve 볼륨에서 chkdsk를 실행합니다.

서버가 보안 연결을 설정하지 못했습니다. 클라우드 서비스에서 예기치 않은 인증서를 받았습니다.

오류	코드
Hresult	0x800b0109
HRESULT(10진수)	-2146762487
오류 문자열	CERT_E_UNTRUSTEDROOT
수정 필요	예

이 오류는 organization TLS 종료 프록시를 사용하거나 악의적인 엔터티가 서버와 Azure 파일 동기화 서비스 간의 트래픽을 가로채는 경우에 발생할 수 있습니다. organization TLS 종료 프록시를 사용하고 있기 때문에 예상되는 경우 레지스트리 재정의를 사용하여 인증서 확인을 건너뜁니다.

SkipVerifyingPinnedRootCertificate 레지스트리 값을 만듭니다.

New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1

등록된 서버에서 동기화 서비스를 다시 시작합니다.
```
Restart-Service -Name FileSyncSvc -Force
```

이 레지스트리 값을 설정하면 Azure 파일 동기화 에이전트는 서버와 클라우드 서비스 간에 데이터를 전송할 때 로컬로 신뢰할 수 있는 TLS/SSL 인증서를 수락합니다.

서버가 Azure 파일 동기화 서비스의 응답을 디코딩할 수 없어 동기화에 실패했습니다.

오류	코드
Hresult	0x80072f8f
HRESULT(10진수)	-2147012721
오류 문자열	WININET_E_DECODING_FAILED
수정 필요	예

이 오류는 일반적으로 방화벽, 프록시 또는 게이트웨이가 PKI URL에 대한 액세스를 차단하거나 PKI 서버가 다운된 경우에 발생합니다.

이 문제를 resolve 서버에서 다음 URL에 액세스할 수 있는지 확인합니다.

https://www.microsoft.com/pki/mscorp/cps
http://crl.microsoft.com/pki/mscorp/crl/
http://mscrl.microsoft.com/pki/mscorp/crl/
http://ocsp.msocsp.com
http://ocsp.digicert.com/
http://crl3.digicert.com/

Azure 파일 동기화 에이전트가 설치되면 PKI URL을 사용하여 Azure 파일 동기화 서비스 및 Azure 파일 공유와 통신하는 데 필요한 중간 인증서를 다운로드합니다. OCSP URL은 인증서의 상태 검사 데 사용됩니다. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

인증 문제로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c80300
HRESULT(10진수)	-2134375680
오류 문자열	ECS_E_SERVER_CREDENTIAL_NEEDED
수정 필요	예

이 오류는 일반적으로 서버 시간이 잘못되었기 때문에 발생합니다. 서버가 가상 머신에서 실행 중인 경우 호스트의 시간이 올바른지 확인합니다.

인증서 만료로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83078
HRESULT(10진수)	-2134364040
오류 문자열	ECS_E_AUTH_SRV_CERT_EXPIRED
수정 필요	예

이 오류는 인증에 사용되는 인증서가 만료되었기 때문에 발생합니다.

인증서가 만료되었음을 확인하려면 다음 단계를 수행합니다.

인증서 MMC 스냅인을 열고 컴퓨터 계정을 선택한 다음 인증서(로컬 컴퓨터)\Personal\Certificates로 이동합니다.
클라이언트 인증 인증서가 만료되었는지 확인합니다.

클라이언트 인증 인증서가 만료된 경우 서버에서 다음 PowerShell 명령을 실행합니다.

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

인증 인증서를 찾을 수 없어 동기화에 실패했습니다.

오류	코드
Hresult	0x80c80228
HRESULT(10진수)	-2134375896
오류 문자열	ECS_E_AUTH_SRV_CERT_NOT_FOUND
수정 필요	예

이 오류는 인증에 사용되는 인증서를 찾을 수 없기 때문에 발생합니다.

이 문제를 resolve 서버에서 다음 PowerShell 명령을 실행합니다.

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

인증 ID를 찾을 수 없어 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83079
HRESULT(10진수)	-2134364039
오류 문자열	ECS_E_AUTH_IDENTITY_NOT_FOUND
수정 필요	예

이 오류는 서버 엔드포인트 삭제에 실패하고 엔드포인트가 부분적으로 삭제된 상태이므로 발생합니다. 이 문제를 resolve 서버 엔드포인트 삭제를 다시 시도합니다.

서버 엔드포인트가 있는 볼륨은 디스크 공간이 부족합니다.

오류	코드
Hresult	0x8e5e0211
HRESULT(10진수)	-1906441711
오류 문자열	JET_errLogDiskFull
수정 필요	예

오류	코드
Hresult	0x80c8031a
HRESULT(10진수)	-2134375654
오류 문자열	ECS_E_NOT_ENOUGH_LOCAL_STORAGE
수정 필요	예

볼륨에 디스크 공간이 부족하거나 디스크 할당량 한도에 도달했기 때문에 이러한 오류 중 하나로 인해 동기화 세션이 실패합니다. 이 오류는 일반적으로 서버 엔드포인트 외부의 파일이 볼륨의 공간을 사용하고 있기 때문에 발생합니다. 서버에서 사용 가능한 디스크 공간을 확인합니다. 서버 엔드포인트를 추가하거나, 파일을 다른 볼륨으로 이동하거나, 서버 엔드포인트가 있는 볼륨의 크기를 늘려 볼륨의 공간을 확보할 수 있습니다. 파일 서버 Resource Manager 또는 NTFS 할당량을 사용하여 볼륨에 디스크 할당량이 구성된 경우 할당량 한도를 늘입니다.

서버 엔드포인트에 대해 클라우드 계층화를 사용하도록 설정한 경우 디스크 공간이 부족하지 않도록 파일이 Azure 파일 공유와 동기화되는지 확인합니다.

서비스는 아직 이 서버 엔드포인트와 동기화할 준비가 되지 않았습니다.

오류	코드
Hresult	0x80c8300f
HRESULT(10진수)	-2134364145
오류 문자열	ECS_E_REPLICA_NOT_READY
수정 필요	아니오

이 오류는 클라우드 엔드포인트가 Azure 파일 공유에 이미 존재하는 콘텐츠로 만들어졌기 때문에 발생합니다. Azure 파일 동기화 서버 엔드포인트가 초기 동기화를 진행하도록 허용하기 전에 모든 콘텐츠에 대해 Azure 파일 공유를 검사해야 합니다. Azure 파일 공유에서 변경 검색이 완료되면 동기화가 시작됩니다. 변경 검색을 완료하는 데 24시간 이상 걸릴 수 있으며 Azure 파일 공유의 파일 및 디렉터리 수에 비례합니다. 클라우드 계층화가 구성된 경우 동기화가 완료된 후 파일이 계층화됩니다.

많은 개별 파일의 문제로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c8023b
HRESULT(10진수)	-2134375877
오류 문자열	ECS_E_SYNC_METADATA_KNOWLEDGE_SOFT_LIMIT_REACHED
수정 필요	예

오류	코드
Hresult	0x80c8021c
HRESULT(10진수)	-2134375908
오류 문자열	ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED
수정 필요	예

오류	코드
Hresult	0x80c80253
HRESULT(10진수)	-2134375853
오류 문자열	ECS_E_TOO_MANY_PER_ITEM_ERRORS
수정 필요	예

항목별 오류와 동기화하지 못하는 파일이 많은 경우 이러한 오류 중 하나로 동기화 세션이 실패합니다. 어떻게 할까요? 설명된 단계를 수행하여 동기화되지 않는 특정 파일 또는 폴더가 있는지 확인합니다. 섹션에서 항목별 오류를 resolve. 동기화 오류 ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED 지원 사례를 여세요.

참고

Azure 파일 동기화 열려 있는 핸들이 있는 파일을 동기화하기 위해 서버에서 하루에 한 번 임시 VSS 스냅샷 만듭니다.

서버 엔드포인트 경로 문제로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c80019
HRESULT(10진수)	-2134376423
오류 문자열	ECS_E_SYNC_INVALID_PATH
수정 필요	예

경로가 존재하고 로컬 NTFS 볼륨에 있으며 재분석 지점 또는 기존 서버 엔드포인트가 아닌지 확인합니다.

필터 드라이버 버전이 에이전트 버전과 호환되지 않아 동기화에 실패했습니다.

오류	코드
Hresult	0x80C80277
HRESULT(10진수)	-2134375817
오류 문자열	ECS_E_INCOMPATIBLE_FILTER_VERSION
수정 필요	예

이 오류는 로드된 클라우드 계층화 필터 드라이버(StorageSync.sys) 버전이 스토리지 동기화 에이전트(FileSyncSvc) 서비스와 호환되지 않기 때문에 발생합니다. Azure 파일 동기화 에이전트가 업그레이드된 경우 서버를 다시 시작하여 설치를 완료합니다. 오류가 계속 발생하면 에이전트를 제거하고 서버를 다시 시작하고 Azure 파일 동기화 에이전트를 다시 설치합니다.

현재 서비스를 사용할 수 없습니다.

오류	코드
Hresult	0x80c8004b
HRESULT(10진수)	-2134376373
오류 문자열	ECS_E_SERVICE_UNAVAILABLE
수정 필요	아니오

이 오류는 Azure 파일 동기화 서비스를 사용할 수 없으므로 발생합니다. 이 오류는 Azure 파일 동기화 서비스를 다시 사용할 수 있을 때 자동으로 resolve.

참고

예외로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80131500
HRESULT(10진수)	-2146233088
오류 문자열	COR_E_EXCEPTION
수정 필요	아니오

이 오류는 예외로 인해 동기화가 실패했기 때문에 발생합니다. 몇 시간 동안 오류가 지속되면 지원 요청을 만드세요.

스토리지 계정이 다른 지역으로 장애 조치(failover)되었기 때문에 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83073
HRESULT(10진수)	-2134364045
오류 문자열	ECS_E_STORAGE_ACCOUNT_FAILED_OVER
수정 필요	예

이 오류는 스토리지 계정이 다른 지역으로 장애 조치(failover)되었기 때문에 발생합니다. Azure 파일 동기화 스토리지 계정 장애 조치(failover) 기능을 지원하지 않습니다. Azure 파일 동기화 클라우드 엔드포인트로 사용되는 Azure 파일 공유를 포함하는 스토리지 계정은 장애 조치(failover)되어서는 안 됩니다. 이렇게 하면 동기화가 중지되고 새로 계층화된 파일의 경우 예기치 않은 데이터 손실이 발생할 수 있습니다. 이 문제를 resolve 스토리지 계정을 주 지역으로 이동합니다.

동기화 데이터베이스의 일시적인 문제로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c8020e
HRESULT(10진수)	-2134375922
오류 문자열	ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
수정 필요	아니오

이 오류는 동기화 데이터베이스의 내부 문제로 인해 발생합니다. 이 오류는 동기화를 다시 시도하면 자동으로 resolve. 이 오류가 연장된 기간 동안 계속되면 지원 요청을 만들고 이 문제를 resolve 데 도움이 되도록 연락을 드립니다.

Microsoft Entra 테넌트 변경으로 인해 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83088
HRESULT(10진수)	-2134364024
오류 문자열	ECS_E_INVALID_AAD_TENANT
수정 필요	예

최신 Azure 파일 동기화 에이전트 버전이 설치되어 있는지 확인하고 Microsoft.StorageSync 애플리케이션에 스토리지 계정에 대한 액세스 권한을 부여합니다(Azure 파일 동기화 스토리지 계정에 대한 액세스 권한이 있는지 확인 참조).

방화벽 및 가상 네트워크 예외가 구성되지 않아 동기화에 실패했습니다.

오류	코드
Hresult	0x80c83096
HRESULT(10진수)	-2134364010
오류 문자열	ECS_E_MGMT_STORAGEACLSBYPASSNOTSET
수정 필요	예

이 오류는 스토리지 계정에서 방화벽 및 가상 네트워크 설정을 사용하도록 설정하고 "신뢰할 수 있는 Microsoft 서비스가 이 스토리지 계정에 액세스하도록 허용" 예외가 확인되지 않은 경우에 발생합니다. 이 문제를 resolve 배포 가이드의 방화벽 및 가상 네트워크 설정 구성 섹션에 설명된 단계를 수행합니다.

스토리지 계정의 보안 설정 또는 서버의 NTFS 권한으로 인해 액세스가 거부되어 동기화에 실패했습니다.

오류	코드
Hresult	0x80070005
HRESULT(10진수)	-2147024891
오류 문자열	ERROR_ACCESS_DENIED
수정 필요	예

이 오류는 Azure 파일 동기화 보안 설정으로 인해 스토리지 계정에 액세스할 수 없거나 NT AUTHORITY\SYSTEM 계정에 서버 엔드포인트가 있는 볼륨의 시스템 볼륨 정보 폴더에 대한 권한이 없는 경우에 발생할 수 있습니다. 개별 파일이 ERROR_ACCESS_DENIED 동기화되지 않는 경우 파일/디렉터리 동기화 오류당 문제 해결 섹션에 설명된 단계를 수행합니다.

스토리지 계정의 SMB 보안 설정 에서 SMB 3.1.1 프로토콜 버전, NTLM v2 인증 및 AES-128-GCM 암호화를 허용하는지 확인합니다. 스토리지 계정에서 SMB 보안 설정을 검사 SMB 보안 설정을 참조하세요.
스토리지 계정의 방화벽 및 가상 네트워크 설정이 제대로 구성되었는지 확인합니다(사용하도록 설정된 경우).
다음 단계를 수행하여 NT AUTHORITY\SYSTEM 계정에 서버 엔드포인트가 있는 볼륨의 시스템 볼륨 정보 폴더에 대한 권한이 있는지 확인합니다.
1. Psexec 도구를 다운로드합니다.
2. 관리자 권한 명령 프롬프트에서 다음 명령을 실행하여 시스템 계정을 PsExec.exe -i -s -d cmd사용하여 명령 프롬프트를 시작합니다.
3. 시스템 계정으로 실행되는 명령 프롬프트에서 다음 명령을 실행하여 NT AUTHORITY\SYSTEM 계정에 시스템 볼륨 정보 폴더 cacls "drive letter:\system volume information" /T /C에 대한 액세스 권한이 없는지 확인합니다.
4. NT AUTHORITY\SYSTEM 계정에 시스템 볼륨 정보 폴더에 대한 액세스 권한이 없는 경우 명령을 cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F"실행합니다.
  
  액세스가 거부된 상태에서 d단계가 실패하는 경우 다음 명령을 실행하여 시스템 볼륨 정보 폴더의 소유권을 가져온 다음 d단계를 반복합니다.
  
  takeown /A /R /F "drive letter:\System Volume Information"

Azure 파일 공유가 삭제되고 다시 만들어지므로 동기화에 실패했습니다.

오류	코드
Hresult	0x80c8027e
HRESULT(10진수)	-2134375810
오류 문자열	ECS_E_SYNC_REPLICA_ROOT_CHANGED
수정 필요	예

이 오류는 Azure 파일 동기화 동일한 동기화 그룹에서 Azure 파일 공유 삭제 및 다시 만들기를 지원하지 않기 때문에 발생합니다.

이 문제를 resolve 다음 단계를 수행하여 동기화 그룹을 삭제하고 다시 만듭니다.

동기화 그룹의 모든 서버 엔드포인트를 삭제합니다.
클라우드 엔드포인트를 삭제합니다.
동기화 그룹을 삭제합니다.
서버 엔드포인트에서 클라우드 계층화를 사용하도록 설정한 경우 서버 엔드포인트 섹션을 삭제한 후 계층화된 파일에 설명된 단계를 수행하여 서버에서 분리된 계층 화된 파일을 삭제합니다.
동기화 그룹을 다시 만듭니다.

동기화에서 복제본(replica) 이전 상태로 복원된 것을 감지했습니다.

오류	코드
Hresult	0x80c80254
HRESULT(10진수)	-2134375852
오류 문자열	ECS_E_SYNC_REPLICA_BACK_IN_TIME
수정 필요	아니오

아무 조치도 필요하지 않습니다. 이 오류는 동기화에서 복제본(replica) 이전 상태로 복원된 것을 감지했기 때문에 발생합니다. 이제 동기화는 조정 모드로 전환됩니다. 여기서 Azure 파일 공유의 내용과 서버 엔드포인트의 데이터를 병합하여 동기화 관계를 다시 만듭니다. 조정 모드가 트리거되면 네임스페이스 크기에 따라 프로세스가 매우 오래 걸릴 수 있습니다. 조정이 완료될 때까지 정기적인 동기화가 수행되지 않으며 Azure 파일 공유와 서버 엔드포인트 간에 다른 파일(마지막으로 수정된 시간 또는 크기)이 있으면 파일 충돌이 발생합니다.

HTTP 요청이 리디렉션되었기 때문에 동기화에 실패했습니다.

오류	코드
Hresult	0x80190133
HRESULT(10진수)	-2145844941
오류 문자열	HTTP_E_STATUS_REDIRECT_KEEP_VERB
수정 필요	예

이 오류는 Azure 파일 동기화 HTTP 리디렉션(3xx 상태 코드)을 지원하지 않기 때문에 발생합니다. 이 문제를 resolve 프록시 서버 또는 네트워크 디바이스에서 HTTP 리디렉션을 사용하지 않도록 설정합니다.

동기화 세션 시간 제한 오류입니다.

오류	코드
Hresult	0x80c8304a
HRESULT(10진수)	-2134364086
오류 문자열	ECS_E_WORK_FRAMEWORK_TIMEOUT
수정 필요	아니오

오류	코드
Hresult	0x80c83049
HRESULT(10진수)	-2134364087
오류 문자열	ECS_E_WORK_FRAMEWORK_RESULT_NOT_FOUND
수정 필요	아니오

오류	코드
Hresult	0x80c83093
HRESULT(10진수)	-2134364013
오류 문자열	ECS_E_WORK_RESULT_EXPIRED
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

작업 시간 초과.

오류	코드
Hresult	0x80131505
HRESULT(10진수)	-2146233083
오류 문자열	COR_E_TIMEOUT
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

시간 초과 오류입니다.

오류	코드
Hresult	0x80c8600d
HRESULT(10진수)	-2134351859
오류 문자열	ECS_E_AZURE_OPERATION_TIME_OUT
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

서버 엔드포인트 경로를 서버에서 찾을 수 없으므로 동기화에 실패했습니다.

오류	코드
Hresult	0x80c8027a
HRESULT(10진수)	-2134375814
오류 문자열	ECS_E_SYNC_ROOT_DIRECTORY_NOT_FOUND
수정 필요	예

이 오류는 서버 엔드포인트 경로로 사용되는 디렉터리의 이름을 바꾸거나 삭제한 경우에 발생합니다. 디렉터리의 이름이 바뀐 경우 디렉터리의 이름을 원래 이름으로 바꾸고 스토리지 동기화 에이전트 서비스(FileSyncSvc)를 다시 시작합니다.

디렉터리가 삭제된 경우 다음 단계를 수행하여 기존 서버 엔드포인트를 제거하고 새 경로를 사용하여 새 서버 엔드포인트를 만듭니다.

서버 엔드포인트 제거에 설명된 단계에 따라 동기화 그룹에서 서버 엔드포인트를 제거합니다.
서버 엔드포인트 추가에 설명된 단계에 따라 동기화 그룹에서 새 서버 엔드포인트를 만듭니다.

빈 서버 경로로 인해 서버 엔드포인트 프로비저닝에 실패했습니다.

오류	코드
Hresult	0x80C80299
HRESULT(10진수)	-2134375783
오류 문자열	ECS_E_SYNC_AUTHORITATIVE_UPLOAD_EMPTY_SET
수정 필요	예

다음 조건이 충족되면 이 오류 코드로 서버 엔드포인트 프로비저닝이 실패합니다.

이 서버 엔드포인트는 초기 동기화 모드인 서버 권한으로 프로비전되었습니다.
로컬 서버 경로가 비어 있거나 동기화할 수 있는 것으로 인식되는 항목이 없습니다.

이 프로비저닝 오류는 Azure 파일 공유에서 사용할 수 있는 모든 콘텐츠를 삭제하지 않도록 보호합니다. 서버 신뢰할 수 있는 업로드는 서버 위치의 업데이트와 함께 이미 시드된 클라우드 위치를 따라 잡기 위한 특수 모드입니다. 이 마이그레이션 가이드 를 검토하여 이 모드가 빌드된 시나리오를 이해합니다.

서버 엔드포인트 제거에 설명된 단계에 따라 동기화 그룹에서 서버 엔드포인트를 제거합니다.
서버 엔드포인트 추가에 설명된 단계에 따라 동기화 그룹에서 새 서버 엔드포인트를 만듭니다.

스토리지 계정을 소유하는 구독을 사용할 수 없습니다.

오류	코드
Hresult	0x80c83087
HRESULT(10진수)	-2134364025
오류 문자열	ECS_E_STORAGE_ACCOUNT_SUBSCRIPTION_DISABLED
수정 필요	예

검사 스토리지 계정이 있는 구독이 사용하도록 설정되어 있는지 확인하세요.

지정된 네트워크 이름을 더 이상 사용할 수 없습니다.

오류	코드
Hresult	0x80070040
HRESULT(10진수)	-2147024832
오류 문자열	ERROR_NETNAME_DELETED
수정 필요	예

cmdlet을 Test-StorageSyncNetworkConnectivity 사용하여 서비스 엔드포인트에 대한 네트워크 연결을 검사. 자세한 내용은 서비스 엔드포인트에 대한 네트워크 연결 테스트를 참조하세요.

동기화 세션 오류입니다.

오류	코드
Hresult	0x80c8300d
HRESULT(10진수)	-2134364147
오류 문자열	ECS_E_CANNOT_CREATE_ACTIVE_SESSION_PLACEHOLDER_BLOB
수정 필요	아니오

오류	코드
Hresult	0x80c8300e
HRESULT(10진수)	-2134364146
오류 문자열	ECS_E_CANNOT_UPDATE_REPLICA_WATERMARK
수정 필요	아니오

오류	코드
Hresult	0x80c8024a
HRESULT(10진수)	-2134375862
오류 문자열	ECS_E_SYNC_DEFERRAL_QUEUE_RESTART_SESSION
수정 필요	아니오

오류	코드
Hresult	0x80c83098
HRESULT(10진수)	-2134364008
오류 문자열	ECS_E_STORAGE_ACCOUNT_MGMT_OPERATION_THROTTLED
수정 필요	아니오

오류	코드
Hresult	0x80c83082
HRESULT(10진수)	-2134364030
오류 문자열	ECS_E_ASYNC_WORK_ACTION_UNABLE_TO_RETRY
수정 필요	아니오

오류	코드
Hresult	0x80c83006
HRESULT(10진수)	-2134364154
오류 문자열	ECS_E_ECS_BATCH_ERROR
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

동기화 세션 오류입니다.

오류	코드
Hresult	0x80c830a1
HRESULT(10진수)	-2134363999
오류 문자열	ECS_TOO_MANY_ETAGVERIFICATION_FAILURES
수정 필요	어쩌면

오류	코드
Hresult	0x80c8023c
HRESULT(10진수)	-2134375876
오류 문자열	ECS_E_SYNC_CLOUD_METADATA_CORRUPT
수정 필요	어쩌면

오류	코드
Hresult
HRESULT(10진수)
오류 문자열
수정 필요	어쩌면

오류가 하루 이상 지속되면 지원 요청을 만듭니다.

내부 오류가 발생했습니다.

오류	코드
Hresult	0x80070057
HRESULT(10진수)	-2147024809
오류 문자열	ERROR_INVALID_PARAMETER
수정 필요	아니오

오류	코드
Hresult	0x80c80302
HRESULT(10진수)	-2134375678
오류 문자열	ECS_E_UNKNOWN_HTTP_SERVER_ERROR
수정 필요	아니오

오류	코드
Hresult	0x8004100c
HRESULT(10진수)	-2147217396
오류 문자열	SYNC_E_DESERIALIZATION
수정 필요	아니오

오류	코드
Hresult	0x80c8022d
HRESULT(10진수)	-2134375891
오류 문자열	ECS_E_SYNC_METADATA_UNCOMMITTED_TX_LIMIT_REACHED
수정 필요	아니오

오류	코드
Hresult	0x80c83097
HRESULT(10진수)	-2134364009
오류 문자열	ECS_E_QUEUE_CLIENT_EXCEPTION
수정 필요	아니오

오류	코드
Hresult	0x80c80245
HRESULT(10진수)	-2134375867
오류 문자열	ECS_E_EPOCH_CHANGE_DETECTED
수정 필요	아니오

오류	코드
Hresult	0x80072ef3
HRESULT(10진수)	-2147012877
오류 문자열	WININET_E_INCORRECT_HANDLE_STATE
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

내부 오류가 발생했습니다.

오류	코드
Hresult	0x80131509
HRESULT(10진수)	-2146233079
오류 문자열	COR_E_INVALIDOPERATION
수정 필요	어쩌면

오류	코드
Hresult	0x80070718
HRESULT(10진수)	-2147023080
오류 문자열	ERROR_NOT_ENOUGH_QUOTA
수정 필요	어쩌면

오류	코드
Hresult	0x80131622
HRESULT(10진수)	-2146232798
오류 문자열	COR_E_OBJECTDISPOSED
수정 필요	어쩌면

오류	코드
Hresult	0x80004002
HRESULT(10진수)	-2147467262
오류 문자열	E_NOINTERFACE
수정 필요	어쩌면

오류	코드
Hresult	0x800700a1
HRESULT(10진수)	-2147024735
오류 문자열	ERROR_BAD_PATHNAME
수정 필요	어쩌면

오류	코드
Hresult	0x8007054f
HRESULT(10진수)	-2147023537
오류 문자열	ERROR_INTERNAL_ERROR
수정 필요	어쩌면

오류	코드
Hresult	0x80131501
HRESULT(10진수)	-2146233087
오류 문자열	COR_E_SYSTEM
수정 필요	어쩌면

오류	코드
Hresult	0x80131620
HRESULT(10진수)	-2146232800
오류 문자열	COR_E_IO
수정 필요	어쩌면

오류	코드
Hresult	0x80070026
HRESULT(10진수)	-2147024858
오류 문자열	COR_E_ENDOFSTREAM
수정 필요	어쩌면

오류	코드
Hresult	0x80070554
HRESULT(10진수)	-2147023532
오류 문자열	ERROR_NO_SUCH_PACKAGE
수정 필요	어쩌면

오류	코드
Hresult	0x80131537
HRESULT(10진수)	-2146233033
오류 문자열	COR_E_FORMAT
수정 필요	어쩌면

오류	코드
Hresult	0x8007001f
HRESULT(10진수)	-2147024865
오류 문자열	ERROR_GEN_FAILURE
수정 필요	어쩌면

오류가 하루 이상 지속되면 지원 요청을 만듭니다.

내부 오류가 발생했습니다.

오류	코드
Hresult	0x80004003
HRESULT(10진수)	-2147467261
오류 문자열	E_POINTER
수정 필요	예

최신 파일 동기화 에이전트 버전으로 업그레이드하세요. 에이전트를 업그레이드한 후에도 오류가 지속되면 지원 요청을 만듭니다.

인증 실패로 인해 작업이 실패했습니다.

오류	코드
Hresult	0x8007052e
HRESULT(10진수)	-2147023570
오류 문자열	ERROR_LOGON_FAILURE
수정 필요	어쩌면

오류	코드
Hresult	0x8007051f
HRESULT(10진수)	-2147023585
오류 문자열	ERROR_NO_LOGON_SERVERS
수정 필요	어쩌면

오류가 하루 이상 지속되면 지원 요청을 만듭니다.

지정된 Azure 계정을 사용할 수 없습니다.

오류	코드
Hresult	0x80c86003
HRESULT(10진수)	-2134351869
오류 문자열	ECS_E_AZURE_ACCOUNT_IS_DISABLED
수정 필요	예

검사 스토리지 계정이 있는 구독이 사용하도록 설정되어 있는지 확인하세요.

스토리지 계정 키 기반 인증이 차단되었습니다.

오류	코드
Hresult	0x80c8307c
HRESULT(10진수)	-2134364036
오류 문자열	ECS_E_STORAGE_ACCOUNT_KEY_BASED_AUTHENTICATION_BLOCKED
수정 필요	예

스토리지 계정에서 "스토리지 계정 키 액세스 허용"을 사용하도록 설정합니다. 자세히 알아보기.

동기화는 서버의 데이터베이스를 업데이트해야 합니다.

오류	코드
Hresult	0x80c8003f
HRESULT(10진수)	-2134376385
오류 문자열	ECS_E_SYNC_EPOCH_MISMATCH
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

볼륨이 오프라인 상태입니다. 제거되었거나, 준비되지 않았거나, 연결되지 않았습니다.

오류	코드
Hresult	0x80c87104
HRESULT(10진수)	-2134347516
오류 문자열	ECS_E_VOLUME_OFFLINE
수정 필요	예

서버 엔드포인트가 있는 볼륨이 서버에 연결되어 있는지 확인하세요.

프라이빗 엔드포인트 구성 액세스가 차단되었습니다.

오류	코드
Hresult	0x80c83099
HRESULT(10진수)	-2134364007
오류 문자열	ECS_E_PRIVATE_ENDPOINT_ACCESS_BLOCKED
수정 필요	예

프라이빗 엔드포인트 구성을 확인하고 파일 동기화 서비스에 대한 액세스를 허용합니다. 자세히 알아보기.

동기화는 파일을 업로드하기 전에 서버 및 Azure 파일 공유 데이터를 조정해야 합니다.

오류	코드
Hresult	0x80c80248
HRESULT(10진수)	-2134375864
오류 문자열	ECS_E_REPLICA_RECONCILIATION_NEEDED
수정 필요	아니오

아무 작업도 필요하지 않습니다. 이 오류는 자동으로 resolve. 며칠 동안 오류가 지속되면 지원 요청을 만듭니다.

둘 이상의 사용자 이름을 사용하여 동일한 사용자가 서버 또는 공유 리소스에 여러 번 연결할 수 없습니다.

오류	코드
Hresult	0x800704c3
HRESULT(10진수)	-2147023677
오류 문자열	ERROR_SESSION_CREDENTIAL_CONFLICT
수정 필요	예

서버 또는 공유 리소스에 대한 이전 연결을 모두 끊고 다시 시도하십시오.

서버의 SSL 인증서가 잘못되었거나 만료되었습니다.

오류	코드
Hresult	0x80c80050
HRESULT(10진수)	-2134376368
오류 문자열	ECS_E_SERVER_INVALID_OR_EXPIRED_CERTIFICATE
수정 필요	예

서버에서 다음 PowerShell 명령을 실행하여 인증서를 다시 설정합니다.

Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>

고급 문제 해결 단계

스토리지 계정이 있는지 확인합니다.

포털
PowerShell

스토리지 동기화 서비스 내의 동기화 그룹으로 이동합니다.
동기화 그룹 내에서 클라우드 엔드포인트를 선택합니다.
열린 창에서 Azure 파일 공유 이름을 확인합니다.
파일 공유 이름을 선택하여 스토리지 계정에서 파일 공유 설정 페이지를 엽니다. 이 링크를 열지 못하면 참조된 스토리지 계정이 제거됩니다.

# Variables for you to populate based on your configuration
$region = "<Az_Region>"
$resourceGroup = "<RG_Name>"
$syncService = "<storage-sync-service>"
$syncGroup = "<sync-group>"

# Log into the Azure account
Connect-AzAccount

# Check to ensure Azure File Sync is available in the selected Azure
# region.
$regions = [System.String[]]@()
Get-AzLocation | ForEach-Object { 
    if ($_.Providers -contains "Microsoft.StorageSync") { 
        $regions += $_.Location 
    } 
}

if ($regions -notcontains $region) {
    throw [System.Exception]::new("Azure File Sync is either not available in the " + `
        " selected Azure Region or the region is mistyped.")
}

# Check to ensure resource group exists
$resourceGroups = [System.String[]]@()
Get-AzResourceGroup | ForEach-Object { 
    $resourceGroups += $_.ResourceGroupName 
}

if ($resourceGroups -notcontains $resourceGroup) {
    throw [System.Exception]::new("The provided resource group $resourceGroup does not exist.")
}

# Check to make sure the provided Storage Sync Service
# exists.
$syncServices = [System.String[]]@()

Get-AzStorageSyncService -ResourceGroupName $resourceGroup | ForEach-Object {
    $syncServices += $_.StorageSyncServiceName
}

if ($syncServices -notcontains $syncService) {
    throw [System.Exception]::new("The provided Storage Sync Service $syncService does not exist.")
}

# Check to make sure the provided Sync Group exists
$syncGroups = [System.String[]]@()

Get-AzStorageSyncGroup -ResourceGroupName $resourceGroup -StorageSyncServiceName $syncService | ForEach-Object {
    $syncGroups += $_.SyncGroupName
}

if ($syncGroups -notcontains $syncGroup) {
    throw [System.Exception]::new("The provided sync group $syncGroup does not exist.")
}

# Get reference to cloud endpoint
$cloudEndpoint = Get-AzStorageSyncCloudEndpoint `
    -ResourceGroupName $resourceGroup `
    -StorageSyncServiceName $syncService `
    -SyncGroupName $syncGroup

# Get reference to storage account
$storageAccount = Get-AzStorageAccount | Where-Object { 
    $_.Id -eq $cloudEndpoint.StorageAccountResourceId
}

if ($storageAccount -eq $null) {
    throw [System.Exception]::new("The storage account referenced in the cloud endpoint does not exist.")
}

Azure 파일 공유가 있는지 확인합니다.

포털
PowerShell

왼쪽 목차에서 개요를 선택하여 기본 스토리지 계정 페이지로 돌아갑니다.
파일을 선택하여 파일 공유 목록을 봅니다.
클라우드 엔드포인트에서 참조하는 파일 공유가 파일 공유 목록에 표시되는지 확인합니다(위의 1단계에서 설명했어야 합니다).

$fileShare = Get-AzStorageShare -Context $storageAccount.Context | Where-Object {
    $_.Name -eq $cloudEndpoint.AzureFileShareName -and
    $_.IsSnapshot -eq $false
}

if ($fileShare -eq $null) {
    throw [System.Exception]::new("The Azure file share referenced by the cloud endpoint does not exist")
}

Azure 파일 동기화 스토리지 계정에 액세스할 수 있는지 확인합니다.

포털
PowerShell

왼쪽 탐색 영역에서 액세스 제어(IAM) 를 선택합니다.
역할 할당 탭을 선택하여 스토리지 계정에 액세스할 수 있는 사용자 및 애플리케이션(서비스 주체)을 나열합니다.
읽기 권한자 및 데이터 액세스 역할이 있는 목록에 Microsoft.StorageSync 또는 하이브리드 파일 동기화 서비스(이전 애플리케이션 이름)가 표시되는지 확인합니다.

Microsoft.StorageSync 또는 Hybrid 파일 동기화 Service가 목록에 표시되지 않으면 다음 단계를 수행합니다.
- 추가를 선택합니다.
- 역할 필드에서 읽기 권한자 및 데이터 액세스를 선택합니다.
- 선택 필드에 Microsoft.StorageSync를 입력하고 역할을 선택한 다음 저장을 선택합니다.

$role = Get-AzRoleAssignment -Scope $storageAccount.Id | Where-Object { $_.DisplayName -eq "Microsoft.StorageSync" }

if ($role -eq $null) {
    throw [System.Exception]::new("The storage account does not have the Azure File Sync " + `
                "service principal authorized to access the data within the " + ` 
                "referenced Azure file share.")
}

참고 항목

도움을 요청하십시오.

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

Azure 파일 동기화 동기화 상태 및 오류 문제 해결

동기화 상태

동기화 상태를 모니터링할 어떻게 할까요? 있나요?

현재 동기화 세션의 진행률을 모니터링할 어떻게 할까요? 있나요?

서버가 서로 동기화되어 있는지 어떻게 할까요? 알 수 있나요?

동기화되지 않는 특정 파일 또는 폴더가 있는지 확인할 어떻게 할까요? 있나요?

동기화 오류

파일/디렉터리 동기화 오류당 문제 해결

지원되지 않는 문자 처리

일반적인 동기화 오류

고급 문제 해결 단계

참고 항목

도움을 요청하십시오.

피드백

피드백

추가 리소스