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

아티클
11/21/2024

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

동기화 상태

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보다 큰 경우 파일 동기화에 실패한 이유를 해결하기 위해 동기화되지 않는 특정 파일 또는 폴더가 있는지 어떻게 할까요? 참조하세요. 서버 엔드포인트의 상태가 정상이 아닌 상태인 경우 아래 표의 지침을 따르세요.

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

참고 항목

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

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

다음은 성공적인 업로드의 예입니다. 간단하게 설명하기 위해, 각 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.

동기화 세션이 전체적으로 실패하거나 PerItemErrorCount의 값이 0이 아니지만, 여전히 동기화가 계속 진행되고 일부 파일이 성공적으로 동기화되는 경우가 가끔 있습니다. 적용된 필드(AppliedFileCount, AppliedDirCount, AppliedTombstoneCount및 AppliedSizeBytes)를 확인하여 진행률을 확인할 수 있습니다. 이러한 필드는 세션이 얼마나 성공적으로 진행되고 있는지 설명합니다. 여러 동기화 세션이 연속으로 실패하는데 Applied 횟수는 증가하는 경우 지원 티켓을 개설하기 전에 동기화될 때까지 좀 더 기다렸다가 다시 시도해 보세요.

현재 동기화 세션의 진행률을 모니터링 하려면 어떻게 해야 하나요?

포털
서버

동기화 그룹 내에서 서버 엔드포인트 속성으로 이동하고 동기화 상태 섹션을 확인하여 현재 동기화 세션에서 업로드되거나 다운로드된 파일 수를 확인합니다. 이 상태는 약 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 이벤트로 표시되는 완료된 동기화 세션을 확인합니다(이벤트 뷰어에서 Applications and Services Logs\Microsoft\FileSync\Agent\Telemetry로 이동).

특정 서버에서 최신 업로드 및 다운로드 세션이 완료되었는지 확인합니다.

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

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

동기화되지 않는 파일 또는 폴더가 있는지 확인하려면 어떻게 하나요?

포털 또는 서버의 영구 동기화 오류 및 일시적 동기화 오류 수가 지정된 동기화 세션에 대해 0보다 크면 일부 항목이 동기화에 실패 PerItemErrorCount 합니다. 파일 및 폴더에는 동기화를 방해하는 특성이 있을 수 있습니다. 이러한 특징은 영구적일 수 있으며, 파일 또는 폴더 이름에서 지원되지 않는 문자를 제거하는 것처럼 동기화를 다시 시작하기 위한 명시적 조치가 필요합니다. 또한 이러한 특징이 일시적일 수 있습니다. 즉, 파일 또는 폴더가 자동으로 동기화를 다시 시작할 수 있습니다. 예를 들어 핸들이 열려 있는 파일은 파일이 닫히면 자동으로 동기화를 다시 시작합니다. Azure 파일 동기화 엔진이 이러한 문제를 발견하면 오류 로그가 생성되며, 이 오류 로그를 구문 분석하면 현재 올바르게 동기화되지 않는 항목이 나열됩니다.

참고 항목

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

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

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

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

동기화 오류

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

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

참고 항목

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

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

HRESULT	HRESULT(10진)	오류 문자열	문제	수정
0x80070043	-2147942467	ERROR_BAD_NET_NAME	서버에서 계층화된 파일에 액세스할 수 없습니다. 이 문제는 서버 엔드포인트를 삭제하기 전에 계층화된 파일이 회수되지 않은 경우에 발생합니다.	이 문제를 해결하려면 서버에서 계층화된 파일에 액세스할 수 없음을 참조하세요.
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 파일 공유 제한에 도달하여 파일을 동기화할 수 없습니다.	이 문제를 해결하려면 문제 해결 가이드의 Azure 파일 공유 스토리지 용량 한도에 도달했습니다 섹션을 참조하세요.
0x80c83008	-2134364152	ECS_E_CANNOT_CREATE_AZURE_STAGED_FILE	Azure 파일 공유 제한에 도달하여 파일을 동기화할 수 없습니다.	이 문제를 해결하려면 문제 해결 가이드의 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 오류로 인해 파일을 동기화할 수 없습니다. 이 오류는 서버 엔드포인트를 삭제하기 전에 계층화된 파일이 회수되지 않았거나 파일이 손상된 경우에 발생할 수 있습니다.	이 문제를 해결하려면 분리된 계층화된 파일을 제거하려면 서버에서 계층화된 파일에 액세스할 수 없음을 참조하세요. 분리된 계층화된 파일을 제거한 후에도 오류가 계속 발생하면 볼륨에서 chkdsk를 실행합니다.
0x800703ee	-2147023890	ERROR_FILE_INVALID	파일이 더 이상 유효하지 않으므로 동기화할 수 없습니다. 이 오류는 일반적으로 파일이 계층화되고 분리된 경우에 발생합니다.	파일이 계층화된 경우 분리된 계층화된 파일을 제거하려면 서버에서 계층화된 파일에 액세스할 수 없음을 참조하세요.
0x80070570	-2147023504	ERROR_FILE_CORRUPT	파일 또는 디렉터리가 손상되어 읽을 수 없습니다.	볼륨에서 chkdsk를 실행합니다.
0x80c80200	-2134375936	ECS_E_SYNC_CONFLICT_NAME_EXISTS	충돌 파일이 최대 수에 도달했기 때문에 파일을 동기화할 수 없습니다. Azure 파일 동기화는 파일당 100개의 충돌 파일을 지원합니다. 파일 충돌에 대해 자세히 알아보려면 Azure 파일 동기화 FAQ를 참조하세요.	이 문제를 해결하려면 충돌 파일 수를 줄입니다. 충돌 파일 수가 100 미만이면 파일이 동기화됩니다.
0x80c8027d	-2134375811	ECS_E_DIRECTORY_RENAME_FAILED	디렉터리 내의 파일 또는 폴더에 열린 핸들이 있으므로 디렉터리 이름 변경을 동기화할 수 없습니다.	작업이 필요하지 않습니다. 디렉터리 내의 열려 있는 파일 핸들이 모두 닫히면 디렉터리 이름 변경이 동기화됩니다.
0x800700de	-2147024674	ERROR_BAD_FILE_TYPE	서버의 계층화된 파일은 Azure 파일 공유에 더 이상 존재하지 않는 파일 버전을 참조하므로 액세스할 수 없습니다.	이 문제는 계층화된 파일이 Windows Server의 백업에서 복원된 경우에 발생할 수 있습니다. 문제를 해결하려면 Azure 파일 공유의 스냅샷에서 파일을 복원합니다.
0x80C80065	-2134376347	ECS_E_DATA_TRANSFER_BLOCKED	동기화하는 동안 영구 오류를 생성하기 위해 파일이 식별되었습니다. 따라서 재시도 간격에 도달할 때까지 동기화가 차단됩니다. 나중에 파일을 다시 시도합니다.	작업이 필요하지 않습니다. 24시간 후에 파일을 다시 시도합니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.
0x80C80203	-2134375933	ECS_E_SYNC_INVALID_STAGED_FILE	파일 전송 오류입니다. 서비스는 나중에 다시 시도합니다.	작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.
0x80c8027f	-2134375809	ECS_E_SYNC_CONSTRAINT_CONFLICT_CYCLIC_DEPENDENCY	동기화 세션 시간 초과 오류입니다.	작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.
0x80070035	-2147024843	ERROR_BAD_NETPATH	네트워크 경로를 찾을 수 없습니다.	작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.
0x80071779	-2147018887	ERROR_FILE_READ_ONLY	지정된 파일이 읽기 전용입니다.	이 오류가 2일 이상 지속되면 지원 요청을 하세요.
0x80070006	-2147024890	ERROR_INVALID_HANDLE	내부 오류가 발생함.	이 오류가 2일 이상 지속되면 지원 요청을 하세요.
0x8007012f	-2147024593	ERROR_DELETE_PENDING	파일을 삭제하는 중이므로 파일을 열 수 없습니다.	작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.
0x80041007	-2147217401	SYNC_E_ITEM_MUST_EXIST	내부 오류가 발생함.	이 오류가 2일 이상 지속되면 지원 요청을 하세요.
0X80C80293	-2134375789	ECS_E_SYNC_INITIAL_SCAN_COMPLETED	초기 열거가 완료되어 동기화 세션이 실패했습니다. 다음 세션에서는 전체 네임스페이스를 다룹니다.	작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.
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
재구성 필요	아니요

작업이 필요하지 않습니다. Azure 파일 동기화 사용 중인 파일을 동기화하기 위해 서버에서 하루에 한 번 실행되는 예약된 작업(VssSyncScheduledTask)이 있습니다. 이 예약된 작업이 시작되면 현재 업로드 동기화 세션을 취소하고(0x80c8029c 오류 코드로 인해) VSS 스냅샷을 만들고 VSS 스냅샷을 활용하여 새 업로드 동기화 세션을 시작합니다.

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

오류	코드
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 파일 동기화 서비스로 나가는 연결에 대해 열려 있는지 확인합니다. Test-NetConnection cmdlet을 사용하면 됩니다. 아래 자리 표시자의 URL <azure-file-sync-endpoint> 은 Azure 파일 동기화 프록시 및 방화벽 설정 문서에서 찾을 수 있습니다.
```
Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
```
프록시 구성이 예상대로 설정되었는지 확인합니다. Get-StorageSyncProxyConfiguration cmdlet으로 할 수 있습니다. Azure 파일 동기화에 대해 프록시를 구성하는 자세한 방법은 Azure 파일 동기화 프록시 및 방화벽 설정에서 찾을 수 있습니다.
```
$agentPath = "C:\Program Files\Azure\StorageSyncAgent"
Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncProxyConfiguration
```
Test-StorageSyncNetworkConnectivity cmdlet을 사용하여 서비스 엔드포인트에 대한 네트워크 연결을 확인합니다. 자세한 내용은 서비스 엔드포인트에 대한 네트워크 연결 테스트를 참조하세요.
네트워크 연결 문제와 관련하여 추가적인 도움이 필요하면 네트워크 관리자에게 문의하세요.

참고 항목

Azure File Sync 서비스에 대한 네트워크 연결이 복원되더라도 동기화가 즉시 재개되지 않을 수 있습니다. 서버 엔드포인트 위치 내에서 변경 내용이 검색되지 않는 경우 기본적으로 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
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

변경 검색이 복원 후 작업을 완료할 때까지 동기화가 차단됩니다

오류	코드
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
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

동기화 데이터베이스가 언로드되었으므로 동기화하지 못했습니다.

오류	코드
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 File Sync 에이전트가 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 File Sync 에이전트가 Azure 파일 공유에 액세스할 수 있는 권한이 없기 때문에 발생합니다. 다음 단계를 진행하여 이 오류를 해결할 수 있습니다.

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

오류	코드
HRESULT	0x80C83060
HRESULT(10진)	-2134364064
오류 문자열	ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
재구성 필요	예

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

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
재구성 필요	예

스토리지 계정에 읽기 전용 리소스 잠금이 있는 경우에 이 오류가 발생합니다. 이 문제를 해결하려면 스토리지 계정의 읽기 전용 리소스 잠금을 제거합니다.

동기화 데이터베이스에 문제가 있어 동기화에 실패했습니다.

오류	코드
HRESULT	0x8e5e044e
HRESULT(10진)	-1906441138
오류 문자열	JET_errWriteConflict
재구성 필요	예

이 오류는 Azure 파일 동기화에서 사용하는 내부 데이터베이스에 문제가 있을 때 발생합니다. 이 문제가 발생할 경우 지원 요청을 만드시면 이 문제를 해결할 수 있도록 연락을 드리겠습니다.

서버에 설치된 Azure File Sync 에이전트 버전이 지원되지 않습니다.

오류	코드
HRESULT	0x80C8306B
HRESULT(10진)	-2134364053
오류 문자열	ECS_E_AGENT_VERSION_BLOCKED
재구성 필요	예

서버에 설치된 Azure File Sync 에이전트 버전이 지원되지 않으면 이 오류가 발생합니다. 이 문제를 해결하려면 지원되는 에이전트 버전으로 업그레이드합니다.

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
재구성 필요	아니요

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

동기화 그룹의 서버에서 다수의 파일이 변경되었습니다.
개별 파일 및 디렉터리에 수많은 오류가 있습니다.

이 문제가 여러 시간 동안 지속되는 경우 지원 요청을 만드시면 이 문제를 해결할 수 있도록 연락을 드리겠습니다.

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

오류	코드
HRESULT	0x80c8021f
HRESULT(10진)	-2134375905
오류 문자열	ECS_E_SYNC_METADATA_IO_BUSY
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

동기화 데이터베이스에 IO 시간 초과가 발생했습니다.

오류	코드
HRESULT	0x80c8021e
HRESULT(10진)	-2134375906
오류 문자열	ECS_E_SYNC_METADATA_IO_TIMEOUT
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

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

오류	코드
HRESULT	0x80c80220
HRESULT(10진)	-2134375904
오류 문자열	ECS_E_SYNC_METADATA_IO_ERROR
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

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

오류	코드
HRESULT	0x80071128
HRESULT(10진)	-2147020504
오류 문자열	ERROR_INVALID_REPARSE_DATA
재구성 필요	Yes

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

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

오류	코드
HRESULT	0x800b0109
HRESULT(10진)	-2146762487
오류 문자열	CERT_E_UNTRUSTEDROOT
재구성 필요	예

이 오류는 조직에서 TLS 종료 프록시를 사용 중이거나 악의적인 엔터티가 서버와 Azure 파일 동기화 서비스 간 트래픽을 가로채는 경우에 발생할 수 있습니다. 이 문제가 발생할 것으로 확신한다면(조직에서 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
재구성 필요	Yes

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

이 문제를 해결하려면 서버가 다음 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 스냅인을 열고 컴퓨터 계정을 선택한 다음 인증서(로컬 컴퓨터)\개인\인증서로 이동합니다.
클라이언트 인증 인증서가 만료되었는지 확인합니다.

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

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

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

오류	코드
HRESULT	0x80c80228
HRESULT(10진)	-2134375896
오류 문자열	ECS_E_AUTH_SRV_CERT_NOT_FOUND
재구성 필요	예

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

이 문제를 해결하려면 서버에서 다음 PowerShell 명령을 실행합니다.

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

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

오류	코드
HRESULT	0x80c83079
HRESULT(10진)	-2134364039
오류 문자열	ECS_E_AUTH_IDENTITY_NOT_FOUND
재구성 필요	Yes

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

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

오류	코드
HRESULT	0x8e5e0211
HRESULT(10진)	-1906441711
오류 문자열	JET_errLogDiskFull
재구성 필요	예

오류	코드
HRESULT	0x80c8031a
HRESULT(10진)	-2134375654
오류 문자열	ECS_E_NOT_ENOUGH_LOCAL_STORAGE
재구성 필요	예

볼륨의 디스크 공간이 부족하거나 디스크 할당량 한도에 도달했기 때문에 이러한 오류 중 하나와 함께 동기화 세션이 실패합니다. 이 오류는 일반적으로 서버 엔드포인트 외부의 파일이 볼륨의 공간을 모두 사용할 때 발생합니다. 서버에서 사용 가능한 디스크 공간을 확인합니다. 서버 엔드포인트를 추가하거나, 파일을 다른 볼륨으로 이동하거나, 서버 엔드포인트가 있는 볼륨의 크기를 늘려서 볼륨의 공간을 확보할 수 있습니다. 파일 서버 리소스 관리자 또는 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
재구성 필요	예

항목별 오류와 동기화하는 데 실패한 파일이 많은 경우 동기화 세션이 해당 오류 중 하나 때문에 실패합니다. 항목별 오류를 해결하려면 동기화되지 않는 특정 파일이나 폴더가 있는지 확인하는 방법 섹션에 설명된 단계를 수행합니다. 동기화 오류 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 파일 동기화 서비스를 다시 사용할 수 있는 경우 자동으로 해결됩니다.

참고 항목

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

오류	코드
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)하지 않아야 합니다. 이러한 계정을 장애 조치(failover)하면 동기화가 더 이상 진행되지 않고, 새로 계층화된 파일의 경우 예기치 않은 데이터 손실이 발생할 수도 있습니다. 이 문제를 해결하려면 스토리지 계정을 주 지역으로 이동합니다.

동기화 데이터베이스에 일시적인 문제가 있어 동기화에 실패했습니다.

오류	코드
HRESULT	0x80c8020e
HRESULT(10진)	-2134375922
오류 문자열	ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
재구성 필요	아니요

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

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 서비스가 이 스토리지 계정에 액세스하도록 허용” 예외가 선택되어 있지 않은 경우에 발생합니다. 이 문제를 해결하려면 배포 가이드의 방화벽 및 가상 네트워크 설정 구성 섹션에 설명된 단계를 수행합니다.

스토리지 계정의 보안 설정 또는 서버의 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 File Sync가 동일한 동기화 그룹에서 Azure 파일 공유를 삭제하고 다시 만드는 작업을 지원하지 않기 때문에 발생합니다.

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

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

동기화에서 복제본이 이전 상태로 복원되었음을 검색했습니다.

오류	코드
HRESULT	0x80c80254
HRESULT(10진)	-2134375852
오류 문자열	ECS_E_SYNC_REPLICA_BACK_IN_TIME
재구성 필요	아니요

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

HTTP 요청이 리디렉션되었으므로 동기화하지 못했습니다.

오류	코드
HRESULT	0x80190133
HRESULT(10진)	-2145844941
오류 문자열	HTTP_E_STATUS_REDIRECT_KEEP_VERB
재구성 필요	예

이 오류는 Azure File Sync가 HTTP 리디렉션(3xx 상태 코드)을 지원하지 않기 때문에 발생합니다. 이 문제를 해결하려면 프록시 서버 또는 네트워크 디바이스에서 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
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

작업 시간 초과.

오류	코드
HRESULT	0x80131505
HRESULT(10진)	-2146233083
오류 문자열	COR_E_TIMEOUT
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

시간 초과 오류.

오류	코드
HRESULT	0x80c8600d
HRESULT(10진)	-2134351859
오류 문자열	ECS_E_AZURE_OPERATION_TIME_OUT
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

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

오류	코드
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
재구성 필요	예

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

동기화 세션 오류.

오류	코드
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
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

동기화 세션 오류.

오류	코드
HRESULT	0x80c830a1
HRESULT(10진)	-2134363999
오류 문자열	ECS_TOO_MANY_ETAGVERIFICATION_FAILURES
재구성 필요	가능할 수도 있음

오류	코드
HRESULT	0x80c8023c
HRESULT(10진)	-2134375876
오류 문자열	ECS_E_SYNC_CLOUD_METADATA_CORRUPT
재구성 필요	가능할 수도 있음

오류	코드
HRESULT
HRESULT(10진)
오류 문자열
재구성 필요	가능할 수도 있음

이 오류가 2일 이상 지속되면 지원 요청을 하세요.

내부 오류가 발생함.

오류	코드
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
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

내부 오류가 발생함.

오류	코드
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
재구성 필요	가능할 수도 있음

이 오류가 2일 이상 지속되면 지원 요청을 하세요.

내부 오류가 발생함.

오류	코드
HRESULT	0x80004003
HRESULT(10진)	-2147467261
오류 문자열	E_POINTER
재구성 필요	예

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

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

오류	코드
HRESULT	0x8007052e
HRESULT(10진)	-2147023570
오류 문자열	ERROR_LOGON_FAILURE
재구성 필요	가능할 수도 있음

오류	코드
HRESULT	0x8007051f
HRESULT(10진)	-2147023585
오류 문자열	ERROR_NO_LOGON_SERVERS
재구성 필요	가능할 수도 있음

이 오류가 2일 이상 지속되면 지원 요청을 하세요.

지정한 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
재구성 필요	Yes

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

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

오류	코드
HRESULT	0x80c8003f
HRESULT(10진)	-2134376385
오류 문자열	ECS_E_SYNC_EPOCH_MISMATCH
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

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

오류	코드
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
재구성 필요	아니요

작업이 필요하지 않습니다. 이 오류는 자동으로 해결됩니다. 이 오류가 며칠 동안 지속되면 지원 요청을 하세요.

여러 사용자 이름을 사용하는 동일한 사용자의 서버 또는 공유 리소스에 대한 여러 연결은 허용되지 않습니다.

오류	코드
HRESULT	0x800704c3
HRESULT(10진)	-2147023677
오류 문자열	ERROR_SESSION_CREDENTIAL_CONFLICT
재구성 필요	예

서버 또는 공유 리소스에 대한 모든 이전 연결을 끊고 다시 시도합니다.

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

오류	코드
HRESULT	0x80c80050
HRESULT(10진)	-2134376368
오류 문자열	ECS_E_SERVER_INVALID_OR_EXPIRED_CERTIFICATE
재구성 필요	Yes

서버에서 다음 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 또는 하이브리드 파일 동기화 서비스가 목록에 나타나지 않으면 다음 단계를 수행합니다.
- 추가를 선택합니다.
- 역할 필드에서 읽기 권한자 및 데이터 액세스를 선택합니다.
- 선택 필드에 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 파일 동기화에서 동기화 상태 및 오류 문제 해결

동기화 상태

동기화 상태를 모니터링하려면 어떻게 해야 하나요?

현재 동기화 세션의 진행률을 모니터링 하려면 어떻게 해야 하나요?

서버가 서로 동기화되었는지 확인하는 방법이 있나요?

동기화되지 않는 파일 또는 폴더가 있는지 확인하려면 어떻게 하나요?

동기화 오류

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

지원되지 않는 처리 문자

일반적인 동기화 오류

일반적인 문제 해결 단계

참고 항목

도움을 요청하십시오.

피드백

추가 리소스