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

이 문서는 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 파일 공유의 네임스페이스 크기에 따라 달라집니다. 변경 열거형 작업이 완료되면 서버 엔드포인트 상태를 업데이트해야 합니다.

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

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

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.

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

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보다 크면 일부 항목이 동기화에 실패 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 이벤트 로그에 기록됩니다. 이 섹션에서는 항목별 오류에 대한 일반적인 오류 코드 및 수정 단계를 설명합니다.

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

지원되지 않는 처리 문자

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

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

일반적인 동기화 오류

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

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

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

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

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

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

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

1. Windows 서비스 FileSyncSvc.exe 방화벽에 의해 차단되지 않는지 확인합니다.

2. 포트 443이 Azure 파일 동기화 서비스로 나가는 연결에 대해 열려 있는지 확인합니다. Test-NetConnection cmdlet을 사용하면 됩니다. 아래 자리 표시자의 URL <azure-file-sync-endpoint> 은 Azure 파일 동기화 프록시 및 방화벽 설정 문서에서 찾을 수 있습니다.

   Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
   

3. 프록시 구성이 예상대로 설정되었는지 확인합니다. Get-StorageSyncProxyConfiguration cmdlet으로 할 수 있습니다. Azure 파일 동기화에 대해 프록시를 구성하는 자세한 방법은 Azure 파일 동기화 프록시 및 방화벽 설정에서 찾을 수 있습니다.

   $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
   Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
   Get-StorageSyncProxyConfiguration
   

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

5. 네트워크 연결 문제와 관련하여 추가적인 도움이 필요하면 네트워크 관리자에게 문의하세요.

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

아무 조치도 필요 없습니다. 서버가 다시 시도합니다. 이 오류가 몇 시간 동안 지속되면 지원 요청을 만드세요.

작업이 중단되었으므로 동기화하지 못했습니다.

사용자가 조치할 필요는 없습니다. 이 오류가 몇 시간 동안 지속되면 지원 요청을 만드세요.

작업이 취소되었습니다.

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

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

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

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

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

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

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

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

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

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

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

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

1. 스토리지 계정이 있는지 확인합니다.
2. Azure 파일 공유가 있는지 확인합니다.
3. 스토리지 계정에 방화벽 및 가상 네트워크 설정이 제대로 구성되어 있는지 확인합니다(사용하도록 설정된 경우).
4. Azure 파일 동기화가 스토리지 계정에 액세스할 수 있는지 확인합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Azure 파일 공유 스토리지 한도에 도달하면 이러한 오류와 함께 동기화 세션이 실패하며, Azure 파일 공유에 할당량이 적용되거나 사용량이 Azure 파일 공유의 한도를 초과할 때 발생할 수 있습니다. 자세한 내용은 Azure 파일 공유의 현재 한도를 참조하세요.

1. 스토리지 동기화 서비스 내에서 동기화 그룹으로 이동합니다.

2. 동기화 그룹 내에서 클라우드 엔드포인트를 선택합니다.

3. 열리는 창에서 Azure 파일 공유 이름을 확인합니다. 파일 공유 이름을 선택하여 스토리지 계정에서 파일 공유 설정 페이지를 엽니다.

   

4. 파일 공유를 선택하여 개요 페이지에서 세부 정보를 가져옵니다.

5. 할당량 편집을 선택하여 파일 공유 할당량을 확인합니다. 대체 할당량을 지정하지 않는 한 할당량은 Azure 파일 공유의 최대 크기와 일치합니다.

   

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

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

이 오류는 Azure 파일 공유에 액세스할 수 없을 때 발생합니다. 문제 해결 방법:

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

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

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

이 오류는 Azure 구독이 일시 중단되면 발생합니다. Azure 구독이 복원되면 동기화가 다시 활성화됩니다. 자세한 내용은 내 Azure 구독이 비활성화된 이유 및 다시 활성화하는 방법은 무엇인가요?를 참조하세요.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

이 오류는 조직에서 TLS 종료 프록시를 사용 중이거나 악의적인 엔터티가 서버와 Azure 파일 동기화 서비스 간 트래픽을 가로채는 경우에 발생할 수 있습니다. 이 문제가 발생할 것으로 확신한다면(조직에서 TLS 종료 프록시를 사용하므로) 레지스트리를 재정의하여 인증서 확인을 건너뜁니다.

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

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

2. 등록된 서버에서 동기화 서비스를 다시 시작합니다.

   Restart-Service -Name FileSyncSvc -Force
   

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

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

이 오류는 일반적으로 방화벽, 프록시 또는 게이트웨이가 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은 인증서의 상태를 확인하는 데 사용됩니다. 오류가 며칠 동안 지속되면 지원 요청을 만듭니다.

인증에 문제가 있어 동기화에 실패했습니다.

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

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

이 오류는 인증에 사용되는 인증서가 만료된 경우에 발생합니다.

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

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

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

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

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

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

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

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

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

이 오류는 다음과 같은 이유로 인해 발생할 수 있습니다.

• Azure 파일 동기화 서버에 새 서버 인증서가 생성되고 이전 인증서는 여전히 캐시됩니다. 이 오류는 서버 캐시가 새로 고쳐지면 몇 시간 내에 해결됩니다.
• 서버 엔드포인트 삭제에 실패하여 엔드포인트가 부분적으로 삭제된 상태로 남습니다. 이 문제를 해결하려면 서버 엔드포인트를 다시 삭제합니다.

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

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

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

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

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

많은 개별 파일에 문제가 있어 동기화에 실패했습니다.

항목별 오류와 동기화하는 데 실패한 파일이 많은 경우 동기화 세션이 해당 오류 중 하나 때문에 실패합니다. 항목별 오류를 해결하려면 동기화되지 않는 특정 파일이나 폴더가 있는지 확인하는 방법 섹션에 설명된 단계를 수행합니다. 동기화 오류 ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED가 있으면 지원 사례를 엽니다.

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

경로가 존재하는지, 로컬 NTFS 볼륨에 있는지, 그리고 재분석 지점이나 기존 서버 엔드포인트가 아닌지 확인하세요.

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

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

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

이 오류는 Azure 파일 동기화 서비스를 사용할 수 없기 때문에 발생합니다. 이 오류는 Azure 파일 동기화 서비스를 다시 사용할 수 있는 경우 자동으로 해결됩니다.

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

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

스토리지 계정이 다른 지역으로 장애 조치(failover)되었으므로 동기화하지 못했습니다.

스토리지 계정이 다른 지역으로 장애 조치(failover)된 경우에 이 오류가 발생합니다. Azure 파일 동기화 스토리지 계정 장애 조치(failover) 기능을 지원하지 않습니다. Azure 파일 동기화에서 클라우드 엔드포인트로 사용되는 Azure 파일 공유를 포함하는 스토리지 계정은 장애 조치(failover)하지 않아야 합니다. 이러한 계정을 장애 조치(failover)하면 동기화가 더 이상 진행되지 않고, 새로 계층화된 파일의 경우 예기치 않은 데이터 손실이 발생할 수도 있습니다. 이 문제를 해결하려면 스토리지 계정을 주 지역으로 이동합니다.

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

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

Microsoft Entra 테넌트 변경으로 인해 동기화 실패

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

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

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

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

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

1. 스토리지 계정의 SMB 보안 설정이 SMB 3.1.1 프로토콜 버전, NTLM v2 인증 및 AES-128-GCM 암호화를 허용하는지 확인합니다. 스토리지 계정의 SMB 보안 설정을 확인하려면 SMB 보안 설정을 참조하세요.

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

3. 다음 단계를 수행하여 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 파일 공유가 삭제되고 다시 만들어졌으므로 동기화하지 못했습니다.

이 오류는 Azure File Sync가 동일한 동기화 그룹에서 Azure 파일 공유를 삭제하고 다시 만드는 작업을 지원하지 않기 때문에 발생합니다.

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

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

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

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

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

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

동기화 세션 시간 초과 오류.

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

작업 시간 초과.

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

시간 초과 오류.

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

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

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

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

1. 서버 엔드포인트 제거에 설명된 단계를 수행하여 동기화 그룹에서 서버 엔드포인트를 제거합니다.
2. 서버 엔드포인트 추가에 설명된 단계를 수행하여 동기화 그룹에 서버 엔드포인트를 만듭니다.

서버 경로가 비어 있으므로 서버 엔드포인트를 프로비전하지 못했습니다.

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

• 이 서버 엔드포인트는 초기 동기화 모드 서버 권한을 사용하여 프로비저닝되었습니다.
• 로컬 서버 경로가 비어 있거나 동기화 가능한 것으로 인식되는 항목이 없습니다.

이 프로비저닝 오류는 Azure 파일 공유에서 사용할 수도 있는 모든 콘텐츠를 삭제하지 못하도록 차단합니다. 서버 권한 업로드는 이미 시드된 클라우드 위치를 서버 위치의 업데이트로 보완하는 특수 모드입니다. 이 마이그레이션 가이드를 검토하여 이 모드가 어떤 시나리오를 위해 개발되었는지 알아보세요.

1. 서버 엔드포인트 제거에 설명된 단계를 수행하여 동기화 그룹에서 서버 엔드포인트를 제거합니다.
2. 서버 엔드포인트 추가에 설명된 단계를 수행하여 동기화 그룹에 서버 엔드포인트를 만듭니다.

스토리지 계정을 소유한 구독이 사용하지 않도록 설정되었습니다.

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

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

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

동기화 세션 오류.

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

동기화 세션 오류.

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

내부 오류가 발생함.

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

내부 오류가 발생함.

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

내부 오류가 발생함.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

일반적인 문제 해결 단계

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

# 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 파일 공유가 있는지 확인합니다.

$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 파일 동기화가 스토리지 계정에 액세스할 수 있는지 확인합니다.

$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 파일 동기화 클라우드 계층화 문제 해결
• Azure 파일 동기화 모니터링
• Azure Files 문제 해결

도움을 요청하십시오.

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