針對 Azure 檔案同步雲端階層處理進行疑難排解

雲端階層處理是 Azure 檔案同步的選用功能，可減少所需的本機儲存空間，同時保留內部部署檔案伺服器的效能。 啟用時，此功能只會儲存本機伺服器上經常存取的 (經常性) 檔案。 不常存取的 (非經常性) 檔案會分割為命名空間 (檔案和資料夾結構) 和檔案內容。

在雲端階層中有以下兩種失敗：

• 檔案無法分層，表示 Azure 檔案同步嘗試將檔案分層至 Azure 檔案但不成功。
• 檔案無法回收，這表示當使用者嘗試存取已分層的檔案時，Azure 檔案同步檔案系統篩選器 (StorageSync.sys) 無法下載資料。

上述任一種失敗會導致兩種主要類型的失敗：

• 雲端儲存體失敗
  • 暫時性儲存體服務可用性問題。 如需詳細資訊，請參閱 Azure 儲存體服務等級協定 (SLA)。
  • 無法存取 Azure 檔案共用。 此失敗通常發生在您刪除的 Azure 檔案共用仍是同步群組中的雲端端點時。
  • 無法存取儲存體帳戶。 當刪除的儲存體帳戶仍有 Azure 檔案共用是同步處理群組中雲端端點時，通常會發生此失敗。
• 伺服器失敗
  • 未載入 Azure 檔案同步檔案系統篩選器 (StorageSync.sys)。 一定要載入 Azure 檔案同步處理檔案系統篩選器，才能回應分層/回收要求。 發生無法載入篩選器的情況可能有幾個原因，但最常見的是系統管理員手動將它卸載。 Azure 檔案同步處理檔案系統篩選器不論何時都必須保持載入，Azure 檔案同步才能正常運作。
  • 遺失、損毀或中斷的重新剖析點。 重新剖析點是檔案上的特殊資料結構，由以下兩部分所組成：

    1. 重新剖析標記。它會向作業系統指示，Azure 檔案同步檔案系統篩選器 (StorageSync.sys) 可能需要對檔案的 IO 採取一些動作。

    2. 重新剖析資料。它會向檔案系統篩選器指示相關聯雲端端點 (Azure 檔案共用) 上檔案的 URI。

       造成重新剖析點損毀的最常見狀況是系統管理員嘗試修改標記或其資料。

  • 網路連線問題。 為了分層或回收檔案，伺服器必須有網際網路連線。

下列各節將說明如何針對雲端階層問題進行疑難排解，以及如何判別雲端儲存體問題或伺服器問題。

如何監視伺服器上的分層活動

若要監視伺服器上的分層活動，請在遙測事件記錄中使用事件識別碼 9003、9016 與 9029 (位於事件檢視器中的 Applications and Services\Microsoft\FileSync\Agent 下)。

• 事件識別碼 9003 會提供伺服器端點的錯誤分布。 例如，總錯誤計數和 ErrorCode。 請注意，每小時每一錯誤碼會記錄一個事件。
• 事件識別碼 9016 會提供磁碟區的建立映像結果。 例如，可用空間百分比為、會話中准刪除的檔案數目，以及無法准刪除的檔案數目。
• 事件識別碼 9029 會提供伺服器端點的虛像化工作階段資訊。 例如，在會話中嘗試的檔案數目、會話中分層的檔案數目，以及已分層的檔案數目。

如何監視伺服器上的回收活動

若要監視伺服器上的重新叫用活動，請在遙測事件記錄中使用事件識別碼 9005、9006、9009 和 9059 (位於事件檢視器中的 Applications and Services\Microsoft\FileSync\Agent 下)。

• 事件識別碼 9005 會提供伺服器端點的回收可靠性。 例如，存取的唯一檔案總數和存取失敗的唯一檔案總數。
• 事件識別碼 9006 會提供伺服器端點的回收錯誤分布。 例如，失敗的要求總數和 ErrorCode。 請注意，每小時每一錯誤碼會記錄一個事件。
• 事件識別碼 9009 會提供伺服器端點的回收工作階段資訊。 例如，DurationSeconds、CountFilesRecallSucceeded 和 CountFilesRecallFailed。
• 事件識別碼 9059 會提供伺服器端點的應用程式回收分布。 例如，ShareId、應用程式名稱和 TotalEgressNetworkBytes。

如何識別伺服器上回收的檔案

1. 在 事件檢視器 中，移至 Microsoft-FileSync-Agent/RecallResults 事件記錄檔。
2. 已針對所回收的每個檔案記錄事件。 DataTransferHresult如果欄位為 0，則檔案回收成功。 DataTransferHresult如果欄位有錯誤碼，請檢查 [重新叫用錯誤和補救] 區段，以查看是否已列出錯誤碼的補救步驟。

如何針對檔案無法分層的問題進行疑難排解

若要針對無法分層的檔案進行疑難解答，請遵循下列步驟：

1. 在 事件檢視器 中，移至 Microsoft-FileSync-Agent/TieringResults 事件記錄檔。

2. 每個無法分層的檔案都會記錄一個事件。 請參閱＜分層錯誤和補救＞一節，以查看是否有列出該錯誤碼的補救步驟。

   您也可以使用 PowerShell 來檢視記錄至 TieringResults 事件記錄檔的事件：

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

如果錯誤碼的內容不存在，請遵循一般疑難解答步驟：

1. 確認檔案存在於 Azure 檔案共用中。

   注意

   檔案必須同步到 Azure 檔案共用，才能將它分層。

2. 確認伺服器具有因特網連線能力。

3. 確認 Azure 檔案同步 篩選驅動程式 （StorageSync.sys和 StorageSyncGuard.sys） 正在執行：

   • 在提高權限的命令提示字元，執行 fltmc。 確認 列出StorageSync.sys 和 StorageSyncGuard.sys 文件系統篩選驅動程式。

分層錯誤和補救

如何針對無法重新叫用檔案的問題進行疑難排解

若要針對無法重新叫用的檔案進行疑難解答，請遵循下列步驟：

1. 在 事件檢視器 中，移至 Microsoft-FileSync-Agent/RecallResults 事件記錄檔。

2. 已針對所回收的每個檔案記錄事件。 DataTransferHresult如果欄位為 0，則檔案回收成功。 DataTransferHresult如果欄位有錯誤碼，請檢查 [重新叫用錯誤和補救] 區段，以查看是否已列出錯誤碼的補救步驟。

   您也可以使用 PowerShell 來檢視記錄到 RecallResults 事件記錄檔的事件：

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

如果錯誤碼的內容不存在，請遵循一般疑難解答步驟：

1. 確認檔案存在於 Azure 檔案共用中。
2. 確認伺服器具有因特網連線能力。
3. 開啟 [服務 MMC] 嵌入式管理單元，並確認記憶體同步代理程式服務 （FileSyncSvc） 正在執行。
4. 確認 Azure 檔案同步 篩選驅動程式 （StorageSync.sys和 StorageSyncGuard.sys） 正在執行：
   • 在提高權限的命令提示字元，執行 fltmc。 確認 列出StorageSync.sys 和 StorageSyncGuard.sys 文件系統篩選驅動程式。

回收錯誤和補救

伺服器上的階層式檔案無法存取

如果在刪除伺服器端點之前未回收檔案，或從內部部署 （第三方） 備份還原到伺服器端點位置，則伺服器上的階層式檔案將無法存取。

如果無法存取階層式檔案，則會記錄下列錯誤：

• 同步處理檔案時，會在 ItemResults 事件記錄檔中記錄錯誤碼 -2147023890 （0x800703ee - ERROR_FILE_INVALID） 或 -2147942467 （0x80070043 - ERROR_BAD_NET_NAME）。
• 重新叫用檔案時，錯誤碼 -2147023890 （0x800703ee - ERROR_FILE_INVALID） 或 -2134376393 （0x80c80037 - ECS_E_SYNC_SHARE_NOT_FOUND） 會記錄在 RecallResults 事件記錄檔中。

請遵循下列各節中的指示來移除孤立的階層式檔案。

如何取得孤立的分層檔案清單

1. 執行下列 PowerShell 命令以列出孤立的階層式檔案：

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
   $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
   

2. 儲存OrphanTieredFiles.txt輸出檔案，以防檔案在刪除後必須從備份還原。

如何移除孤立的分層檔案

選項 1：刪除孤立的分層檔案

此選項會刪除 Windows Server 上孤立的分層檔案，但若有因 30 天後的重新建立作業或連線到不同的同步群組而存在的伺服器端點，則必須移除該端點。 如果在重新建立伺服器端點之前更新 Windows Server 或 Azure 檔案共用上的檔案，就會發生檔案衝突。

1. 備份 Azure 檔案共用和伺服器端點位置。

2. 請遵循移除伺服器端點中所述的步驟操作，將同步群組中的伺服器端點移除 (如有)。

   警告

   如果使用 Remove-StorageSyncOrphanedTieredFiles Cmdlet 之前未移除伺服器端點，則在伺服器上刪除孤立的分層檔案時，會一併刪除 Azure 檔案共用中的完整檔案。

3. 執行下列 PowerShell 命令以列出孤立的階層式檔案：

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
   $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
   

4. 儲存OrphanTieredFiles.txt輸出檔案，以防檔案在刪除後必須從備份還原。

5. 執行下列 PowerShell 命令以刪除孤立的階層式檔案：

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFilesRemoved = Remove-StorageSyncOrphanedTieredFiles -Path <folder path containing orphaned tiered files> -Verbose
   $orphanFilesRemoved.OrphanedTieredFiles > DeletedOrphanFiles.txt
   

   注意

   • 在伺服器上修改的分層檔案若未同步至 Azure 檔案共用，將會遭到刪除。
   • 可存取 (非孤立) 的分層檔案不會遭到刪除。
   • 非階層式檔案仍會保留在伺服器上。

6. 非強制：如果您在步驟 3 中刪除了伺服器端點，請重新建立。

選項 2：掛接 Azure 檔案共用，並將伺服器上的孤立檔案複製到本機

此選項無需移除伺服器端點，但需要有足夠的磁碟空間才能將完整檔案複製到本機。

1. 在具有孤立階層式檔案的 Windows Server 上，掛接 Azure 檔案共用。

2. 執行下列 PowerShell 命令以列出孤立的階層式檔案：

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   $orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
   $orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
   

3. 使用OrphanTieredFiles.txt輸出檔案來識別伺服器上的孤立階層式檔案。

4. 將完整檔案從 Azure 檔案共用複製到 Windows Server，以覆寫孤立的階層式檔案。

如何針對在伺服器上意外回收的檔案進行疑難排解

防毒程式、備份及其他讀取大量檔案的應用程式，除非採用離線屬性並略過讀取這些檔案的內容，否則將會導致非預期的重新叫用。 略過支援此選項之產品的離線檔案，有助於在執行防毒掃描、備份等作業時，避免發生非預期的重新叫用。

請洽詢您的軟體廠商，了解如何設定其解決方案以略過讀取離線檔案。

非預期的重新叫用也可能發生在其他案例中，例如當您在 檔案總管 中瀏覽雲端階層式檔案時。 如果資料夾包含可執行檔，則可能會在 Windows Server 2016 上發生上述問題。 Windows Server 2019 和更新版本的檔案總管已改善，以更妥善處理離線檔案。

Azure 檔案同步的程序排除項目

如果您想要將防毒軟體或其他應用程式設定為不掃描 Azure 檔案同步所存取的檔案，請設定下列程序排除項目：

• C：\Program Files\Azure\StorageSyncAgent\AfsAutoUpdater.exe
• C：\Program Files\Azure\StorageSyncAgent\FileSyncSvc.exe
• C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentLauncher.exe
• C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentHost.exe
• C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentManager.exe
• C：\Program Files\Azure\StorageSyncAgent\MAAgent\MonAgentCore.exe
• C：\Program Files\Azure\StorageSyncAgent\MAAgent\Extensions\XSyncMonitoringExtension\AzureStorageSyncMonitor.exe

Azure 檔案同步需要 TLS 1.2

您可藉由查看登錄設定 (機器翻譯) 來檢視伺服器上的 TLS 設定。

如果您使用 Proxy，請參閱 Proxy 的檔，並確定其已設定為使用 TLS 1.2。

另請參閱

• 針對 Azure 檔案同步代理程式安裝和伺服器註冊進行疑難排解
• 針對 Azure 檔案同步同步群組管理進行疑難排解
• 針對 Azure 檔案同步同步錯誤進行疑難排解
• 監視 Azure 檔案同步
• 針對 Azure 檔案進行疑難排解

與我們連絡，以取得說明

如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。 您也可以向 Azure 意見反應社群提交產品意見反應。