Azure File Sync エージェントのインストールとサーバー登録のトラブルシューティング

ストレージ同期サービスをデプロイした後、Azure File Sync をデプロイする次の手順として、Azure File Sync エージェントをインストールし、Windows Server をストレージ同期サービスに登録します。 この記事は、これらの手順を実行する際に発生する可能性がある問題のトラブルシューティングと解決を支援することを目的としています。

エージェントのインストール

Azure File Sync エージェントのインストールで再起動が必要かどうかを確認する方法

Azure File Sync エージェントのインストールを完了するには、再起動が必要な場合があります。 たとえば、Azure File Sync エージェント バージョン 19.1.0.0 では、18.2.0.0 より前のバージョンから更新する場合、サーバーで再起動が必要です。

自動アップグレード機能を使用してエージェントが更新された場合は、次の PowerShell コマンドを実行して、エージェントの自動アップグレードを完了するために再起動が必要かどうかを確認します。

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

RebootNeeded プロパティの値がTrue場合は、再起動が必要です。

エージェントの更新が完了しない

Azure File Sync エージェントをアップグレードすると、次のいずれかの現象が発生する可能性があります。

• AfsUpdater.exe は、"更新プログラムのインストール" でハングします。
• エージェントのインストールが "監視エージェントの停止" でハングします。

この問題は、現在インストールされている Azure File Sync エージェントのバージョンが v16.2 より前で、 Logman.exe プロセスのシャットダウンに失敗した場合に発生します。

この問題を解決するには、次の手順を実行します。

1. Task Manager を開きます。
2. LogManプロセスを右クリックし、タスクの実行を選択します。 すべての LogMan プロセスが停止し、エージェントの更新が正常に完了するまで、この手順を繰り返します。

エージェントのインストール エラーをトラブルシューティングする

Azure File Sync エージェントのインストールが失敗した場合は、エージェントのインストール ディレクトリにあるインストール ログ ファイルを見つけます。 Azure File Sync エージェントが C: ボリュームにインストールされている場合、インストール ログ ファイルは C:\Program Files\Azure\StorageSyncAgent\InstallerLog にあります。

Note

コマンド ラインから Azure File Sync エージェントがインストールされ、 /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 File Sync Agent に含まれるすべてのスクリプトは署名済みです。 Azure File Sync エージェントのインストールが失敗するのは、[実行をバイパスする] ポリシー設定を使用してインストーラーでスクリプトが実行されているためです。

この問題を解決するには、サーバーで [スクリプト実行を有効にする] グループ ポリシー設定を一時的に無効にします。 エージェントのインストールが完了したら、このグループ ポリシー設定を再度有効にすることができます。

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 以前の OS バージョンにある Active Directory ドメイン コントローラーに同期エージェントをインストールしようとすると発生します。

この問題を解決するには、Windows Server 2012 R2 以降を実行している別のドメイン コントローラーに PDC ロールを転送してから、同期エージェントをインストールします。

Windows Server 2012 R2 でボリュームにアクセスできず、エラーが表示される:パラメーターが正しくありません

Windows Server 2012 R2 でサーバー エンドポイントを作成した後、ボリュームにアクセスすると次のエラーが発生する:

ドライブ文字:\ にアクセスできません。
パラメーターが正しくありません。

この問題を解決するには、KB2919355 をインストールしてサーバーを再起動します。 後の更新プログラムが既にインストールされているためにこの更新プログラムをインストールできない場合は、 Windows Update に移動し、Windows Server 2012 R2 の最新の更新プログラムをインストールして、サーバーを再起動します。

サーバー登録

サーバー登録エラーのトラブルシューティング

サーバーの登録に失敗した場合は、%LocalAppData%\Temp の下にある AfsSrvRegistration*.log ファイルを開き、"ErrorMessage" を検索してエラーの詳細を取得します。

エラー メッセージに基づいて原因を特定できない場合は、 Debug-StorageSyncServer コマンドレットを使用して、ネットワークの問題またはサーバー証明書が原因でサーバーの登録が失敗したかどうかを診断します。

サーバーで診断を実行するには、次の 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 コマンドレットを使用したサーバーの登録がエラーで失敗する: 致命的なエラー (0x8000FFFF)

Register-AzStorageSyncServer コマンドレットを使用したサーバー登録が失敗し、次のエラーが発生します。

致命的なエラー (0x8000FFFF (E_UNEXPECTED)) 'このリソースに対してシステム割り当てマネージド ID が見つかりませんでした'

この問題は、Azure Files Sync エージェントがバージョン 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 が最初の 5 つの 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 File Sync でのサーバーの登録解除に関する記事に記載されている手順を完了します。

サーバーがストレージ同期サービスの 登録済みサーバー の下に表示されていない場合は、登録を解除するサーバーで、次の PowerShell コマンドを実行します。

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

Note

サーバーがクラスターの一部である場合は、 Reset-StorageSyncServer -CleanClusterRegistration パラメーターを使用して、Azure File Sync クラスター登録の詳細からサーバーを削除します。

サーバーの登録時に多数の "Web サイトが信頼されていない" という応答が表示されます。なぜですか?

このエラーは、サーバーの登録中に Enhanced Internet Explorer Security ポリシーが有効になった場合に発生します。 Enhanced Internet Explorer Security ポリシーを適切に無効にする方法の詳細については、「Azure File Sync で使用する Windows Server の準備」およびAzure File Sync のデプロイ方法に関する記事をご覧ください。

Azure Portal の [登録済みサーバー] にサーバーが表示されない

ストレージ同期サービスの [ 登録されたサーバー にサーバーが表示されない場合:

1. 登録するサーバーにサインインします。
2. エクスプローラー開き、ストレージ同期エージェントのインストール ディレクトリに移動します (既定の場所は C:\Program Files\Azure\StorageSyncAgent)。
3. ServerRegistration.exe実行し、ウィザードを完了して、サーバーをストレージ同期サービスに登録します。

関連項目

• Azure File Sync 同期グループの管理に関するトラブルシューティング
• Azure File Sync 同期エラーのトラブルシューティング
• Azure File Sync のクラウドを使った階層化に関するトラブルシューティング
• Azure File Sync の監視
• Azure Files に関する問題のトラブルシューティング

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティ サポートにお問い合わせください。 Azure フィードバック コミュニティに製品フィードバックを送信することもできます。