共用方式為

針對 Azure 檔案同步代理程式安裝和伺服器註冊進行疑難排解

  • 發行項

部署儲存體同步服務之後，部署 Azure 檔案同步的後續步驟是安裝 Azure 檔案同步代理程式，並向儲存體同步服務註冊 Windows Server。 本文旨在協助您針對執行這些步驟期間所遇到的問題進行疑難排解，並解決這些問題。

代理程式安裝

如何檢查 Azure 檔案同步 代理程式安裝是否需要重新啟動

安裝 Azure 檔案同步 代理程式可能需要重新啟動才能完成。 例如，如果從 18.2.0.0 之前的版本更新，Azure 檔案同步 代理程式 19.1.0.0 版需要在伺服器上重新啟動。

如果使用自動升級功能更新代理程式，請執行下列 PowerShell 命令來檢查是否需要重新啟動才能完成代理程式自動升級：

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

如果 屬性的值 RebootNeeded 是 True，則需要重新啟動。

代理程式更新未完成

升級 Azure 檔案同步 代理程式時，可能會遇到下列其中一個徵兆：

  • AfsUpdater.exe「安裝更新」時停止回應。
  • 代理程式安裝會在「停止監視代理程式」時停止回應。

如果目前安裝的 Azure 檔案同步 代理程式版本早於 v16.2，且Logman.exe程式無法關閉，就會發生此問題。

若要解決此問題，請執行下列步驟：

  1. 開啟 [任務管理器]。
  2. 以滑鼠右鍵按兩下 LogMan 程式，然後選取 [ 結束工作]。 重複此步驟，直到所有LogMan進程都停止且代理程式更新順利完成為止。

針對代理程式安裝失敗進行疑難排解

如果 Azure 檔案同步 代理程式安裝失敗，請找出位於代理程式安裝目錄中的安裝記錄檔。 如果 Azure 檔案同步 代理程式安裝在 C： 磁碟區上，安裝記錄檔位於 C：\Program Files\Azure\StorageSyncAgent\InstallerLog 底下。

注意

如果從命令行安裝 Azure 檔案同步 代理程式，並使用 /l\*v 參數，則記錄檔會位於執行代理程式安裝的路徑中。

使用 MSI 套件安裝代理程式的記錄檔名稱是 AfsAgentInstall。 使用 MSP 套件的代理程式安裝記錄檔名稱 （update package） 是 AfsUpdater。

找到代理程式安裝記錄檔之後，請開啟檔案，並在記錄的結尾處搜尋失敗碼。 如果您搜尋「錯誤碼 1603」或「沙箱」，您應該能夠找出錯誤碼。

以下是代理程式安裝失敗的代碼段：

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

在此範例中，代理程式安裝失敗，錯誤碼為 -2147287035 (ERROR_ACCESS_DENIED)。

代理程式安裝失敗，並出現錯誤：儲存體同步代理程式安裝精靈因錯誤而提前結束

代理程式安裝記錄中記錄了下列錯誤：

CAQuietExec64:      + CategoryInfo          : SecurityError: (:) , PSSecurityException  
CAQuietExec64:      + FullyQualifiedErrorId : UnauthorizedAccess  
CAQuietExec64:  Error 0x80070001: Command line returned an error.  
CAQuietExec64:  Error 0x80070001: QuietExec64 Failed  
CAQuietExec64:  Error 0x80070001: Failed in ExecCommon64 method  
CustomAction SetRegPIIAclSettings returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)  
Action ended 12:23:40: InstallExecute. Return value 3.  
MSI (s) (0C:C8) [12:23:40:994]: Note: 1: 2265 2:  3: -2147287035

如果使用群組原則設定了 PowerShell 執行原則，且原則設定為 [只允許簽署的指令碼]，就會發生此問題。Azure 檔案同步代理程式隨附的所有指令碼都已簽署。 Azure 檔案同步代理程式安裝失敗，因為安裝程式使用略過執行原則設定來執行指令碼。

若要解決此問題，請暫時停用伺服器上的開啟指令碼執行群組原則設定。 代理程式安裝完成後，就可以重新啟用群組原則設定。

Active Directory 網域控制站上的代理程式安裝失敗

代理程式安裝記錄中記錄了下列錯誤：

CAQuietExec64:  Error 0x80070001: Command line returned an error.
CAQuietExec64:  Error 0x80070001: CAQuietExec64 Failed
CustomAction InstallHFSRequiredWindowsFeatures returned actual error code 1603 (note this may not be 100% accurate if translation happened inside sandbox)
Action ended 8:51:12: InstallExecute. Return value 3.
MSI (s) (EC:B4) [08:51:12:439]: Note: 1: 2265 2:  3: -2147287035

如果您嘗試在 PDC 角色擁有者位於 Windows Server 2008 R2 或舊版作業系統的 Active Directory 域控制器上安裝同步代理程式，就會發生此問題。

若要解決此問題，請將 PDC 角色轉移到另一個執行 Windows Server 2012 R2 或更新版本的網域控制站，然後安裝同步代理程式。

存取 Windows Server 2012 R2 上的磁碟區失敗，錯誤：參數不正確

在 Windows Server 2012 R2 上建立伺服器端點之後，會於存取磁碟區時發生下列錯誤：

磁碟機代號:\ 無法存取。
參數不正確。

若要解決此問題，請安裝 KB2919355 並重新啟動伺服器。 如果因為已安裝更新而無法安裝此更新，請移至 Windows Update，安裝 Windows Server 2012 R2 的最新更新，然後重新啟動伺服器。

伺服器註冊

針對伺服器註冊失敗進行疑難解答

如果伺服器註冊失敗，請開啟位於 %LocalAppData%\Temp 底下的 AfsSrvRegistration*.log 檔案，並搜尋 “ErrorMessage” 以取得錯誤詳細數據。

如果您無法根據錯誤訊息來識別原因，請使用 Debug-StorageSyncServer Cmdlet 來協助診斷伺服器註冊是否因為網路問題或伺服器證書而失敗。

若要在伺服器上執行診斷，請執行下列 PowerShell 命令：

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

若要測試伺服器上的網路連線能力，請執行下列 PowerShell 命令：

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

使用 Register-AzStorageSyncServer Cmdlet 的伺服器註冊失敗，並出現錯誤：重大失敗（0x8000FFFF）

使用 Register-AzStorageSyncServer Cmdlet 的伺服器註冊失敗，並出現下列錯誤：

重大失敗 （0x8000FFFF （E_UNEXPECTED）） 「找不到此資源系統指派的受控識別」

當 Azure 檔案儲存體 同步代理程式從 17.x 版升級至 18.x 版，並將ServerType登錄值設定為非預期的值時，就會發生此問題。

若要解決此問題，請從提升權限的命令提示字元執行下列命令，以刪除 ServerType 登錄值：

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

刪除登錄 ServerType 值之後，請重試伺服器註冊。

伺服器註冊未列出所有 Azure 訂用帳戶

使用 ServerRegistration.exe 註冊伺服器時，當您選取 [Azure 訂用帳戶 ] 下拉式清單時，缺少訂用帳戶。

發生此問題的原因是 ServerRegistration.exe 只會從前五個Microsoft Entra 租使用者擷取訂用帳戶。

若要增加伺服器上的伺服器註冊租使用者限制，請建立名為 的 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync DWORD 值，其值ServerRegistrationTenantLimit大於 5。

您也可以使用下列 PowerShell 命令註冊伺服器，以解決此問題：

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

伺服器註冊不會列出所有資源群組

使用 ServerRegistration.exe註冊伺服器時，當您選取 [資源群組] 下拉式清單時，缺少某些資源群組。

此問題是因為已在 檔案同步 Agent v19.1 中修正的已知問題所造成。 若要解決此問題，請安裝最新版本的代理程式。

伺服器註冊顯示下列訊息：「此伺服器已註冊。」

顯示 [伺服器註冊] 對話框的螢幕快照，其中包含 「伺服器已註冊」錯誤訊息。

如果先前已向儲存體同步服務註冊該伺服器，就會出現此訊息。 若要向目前的儲存體同步服務取消註冊伺服器，再向新的儲存體同步服務註冊，請完成向 Azure 檔案同步取消註冊伺服器中所述的步驟。

如果伺服器未列在記憶體同步服務的 [已註冊的伺服器] 底下 ，請在您要取消註冊的伺服器上 執行下列 PowerShell 命令：

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

注意

如果伺服器是叢集的一部分，請使用 Reset-StorageSyncServer -CleanClusterRegistration 參數從叢集註冊詳細數據中移除伺服器 Azure 檔案同步。

我在註冊伺服器時收到多個「網站不受信任」回應。原因為何？

如果在伺服器註冊期間啟用了增強的 Internet Explorer 安全性原則，便會發生此問題。 若想進一步了解如何正確停用增強的 Internet Explorer 安全性原則，請參閱準備 Windows Server 以搭配 Azure 檔案同步使用和如何部署 Azure 檔案同步。

伺服器未列在 Azure 入口網站中已註冊的伺服器下

如果伺服器未列在記憶體同步服務的已註冊伺服器底下：

  1. 登入您要註冊的伺服器。
  2. 開啟 檔案總管，然後移至記憶體同步代理程式安裝目錄（預設位置為 C：\Program Files\Azure\StorageSyncAgent）。
  3. 執行 ServerRegistration.exe，並完成精靈以向記憶體同步服務註冊伺服器。

另請參閱

與我們連絡，以取得說明

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