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

  • 發行項

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

代理程式安裝

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

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

注意事項

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

使用 MSI 套件進行代理程式安裝的記錄檔名稱為 AfsAgentInstall。 使用 MSP 套件 (更新套件) 代理程式安裝的記錄檔名稱為 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 的最新更新，然後重新啟動伺服器。

伺服器註冊

[伺服器註冊] 會顯示此錯誤：「無法註冊伺服器」

如果 Azure 檔案同步 安裝代理程式第 17 版， ServerRegistration.exe 可能無法使用下列錯誤訊息來註冊伺服器：

無法註冊伺服器

在位於 %LocalAppData%\Temp 下的 AfsSrvRegistration*.log 檔案中，會記錄下列錯誤：

ManagementCode：'NoRegisteredProviderFound'

在您的區域中部署服務端修正程式之前，您可以使用下列 PowerShell 命令來註冊伺服器，以解決此問題：

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

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

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

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

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

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

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

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

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

如果伺服器先前已向記憶體同步服務註冊，則會出現此訊息。 若要從目前的記憶體同步服務取消註冊伺服器，然後向新的記憶體同步服務註冊，請完成使用 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 意應見反社群。