次の方法で共有

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. タスク マネージャーを開きます。
  2. LogMan プロセスを右クリックし、[タスクの終了] を選択します。 すべての LogMan プロセスが停止し、エージェントの更新が正常に完了するまで、この手順を繰り返します。

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

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

注

コマンド ラインから 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) で失敗しました。

エージェントのインストールがエラー ERROR_NO_SYSTEM_RESOURCESとエラー コード 0x800705AAで失敗する

システム リソースが不足しているため、エージェントのインストールに失敗しました。 この問題を解決するには、サーバー上のメモリを解放し、インストールを再試行します。

エージェントのインストールがエラーで失敗する: ストレージ同期エージェントのセットアップ ウィザードがエラーのため途中で終了しました

エージェントのインストール ログには、次のエラーが記録されます。

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 エージェントに含まれるすべてのスクリプトは署名されます。 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 の最新の更新プログラムをインストールして、サーバーを再起動します。

Azure Arc 拡張機能を使用したエージェントのインストール

Windows 用 Azure File Sync エージェントのインストールの詳細については、Azure Arc 対応 Windows サーバーへの Azure File Sync エージェント拡張機能のインストールと管理に関するページを参照してください。

インストールエラーのトラブルシューティング

  1. Azure portal で Arc Server に移動します。
  2. サーバーの [拡張機能 ] ブレードに移動します。
  3. AzureFileSyncAgentExtensionを見つけて、[状態] 列の [詳細の表示] を選択します。
  4. 拡張機能の展開エラーの原因の詳細については、 エラー メッセージ フィールドを確認します。

Von Bedeutung

失敗した拡張機能をアンインストールしてから、必要な修復手順を実行した後に再インストールする必要があります。 失敗した拡張機能をアンインストールすると、これらの詳細が削除されるため、トラブルシューティングまたは Azure File Sync サポートに問い合わせるためのエラー メッセージの詳細を保存します。

エラー コードリファレンスと修復

エラー メッセージ エラー コード 修復手順
.NET Framework 4.7.2 以降が必要なため、Azure File Sync エージェントをインストールできません。 最新の .NET Framework をインストールしてやり直す 206 .NET Framework 4.7.2 以降をインストールし、コンピューターを再起動します。
Azure File Sync エージェントは既にインストールされています。 追加の操作は不要です。 0 必要なアクションはありません。 拡張機能はインストールされますが、カスタマイズは適用されません。
Azure File Sync エージェントは、サポートされているオペレーティング システムの RTM (Release to Manufacturing) バージョンでのみサポートされます。 51 Azure File Sync エージェントと拡張機能は、WINDOWS Server 2016、2019、2022、および 2025 の RTM バージョンでのみサポートされます。
プロキシ設定エラー。 UseCustomProxy は有効ですが、ProxyAddress が見つからないか無効です。 ProxyAddress はポートなしで指定する必要があり、長さは 255 文字未満にする必要があります。 201 ProxyAddressが指定され、長さが 255 文字を超えないようにします。
プロキシ設定エラー。 UseCustomProxy が有効になっていますが、ProxyPort が見つからないか無効です。 プロキシ ポートは 1 から 65535 までの数値である必要があります 202 UseCustomProxyが有効な場合は、有効なProxyPort (1 から 65535 までの数値) を指定します。
プロキシ設定エラー。 ProxyAuthRequired は有効ですが、ProxyUsername が見つからないか無効です。 ProxyUsername 長さは 3 ~ 255 文字にする必要があります 203 ProxyUsernameを指定し、その長さが 3 ~ 255 文字であることを確認します。
プロキシ設定エラー。 ProxyAuthRequired が有効になっているが、ProxyPassword が見つからないか空である 204 ProxyAuthRequiredが有効になっている場合は、空でないProxyPasswordを指定します。
ストレージ同期ファイルの名前変更操作により、システムの再起動が保留中です。 Azure File Sync エージェントをインストールする前に、サーバーを再起動します。 83 再起動が必要です。 エージェントをもう一度インストールする前に、サーバーを再起動します。
ファイル署名が無効です。 または、ダウンロードした MSI ファイルの署名の検証に失敗しました 86 インストーラー ファイルが破損しているか、改ざんされている可能性があります。 信頼できるソースから MSI ファイルをもう一度ダウンロードします。
証明書チェーンの検証に失敗しました。 86 必要なルート証明書がインストールされていることを確認します。 AKS Edge Essentials オフライン インストールの前提条件を参照してください。

プロキシを使用している場合は、次のドメインがバイパスされていることを確認します。
login.microsoftonline.com、 management.azure.com、 go.microsoft.com、 download.microsoft.com、 download.windowsupdate.com、 crl.microsoft.com、 oneocsp.microsoft.com、 ocsp.msocsp.com、 www.microsoft.com。

コンピューターを再起動して更新プログラムを適用します。
Azure File Sync エージェントのダウンロードまたは構成に失敗しました。 詳細: 自動更新設定の構成に失敗しました: エージェントのインストール ディレクトリがレジストリに見つかりません。 インストールを確認してください。 214 管理者特権の PowerShell セッションを開き、.NET 4.7.2 以降がインストールされているかどうかを確認します。
$releaseKey = (Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" -ErrorAction SilentlyContinue).Release

$releaseKeyが461808未満の場合、.NET 4.7.2 はインストールされません。 この場合は、 公式の .NET ダウンロード サイトから .NET Framework 4.7.2 以降をダウンロードしてインストールします。

サーバー登録

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

サーバーの登録に失敗した場合は、%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 テナントからのみサブスクリプションを取得するため発生します。

サーバーのサーバー登録テナントの制限を引き上げるには、ServerRegistrationTenantLimitの下に HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync という DWORD 値を 5 より大きい値で作成します。

また、次の PowerShell コマンドを使用してサーバーを登録することで、この問題を回避することもできます。

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

サーバー登録ですべてのリソース グループが一覧表示されない

ServerRegistration.exeを使用してサーバーを登録する場合、[リソース グループ] ドロップダウンを選択すると、一部のリソース グループが見つかりません。

この問題は、ファイル同期エージェント v19.1 で修正された既知の問題が原因で発生します。 この問題を解決するには、最新バージョンのエージェントをインストールします。

サーバー登録には、"System.Net.Http, Version=4.2.0.0, Culture=neutral, PublicKeyToken=.." というメッセージが表示されます。

このエラーは、サーバーに必要な .NET Framework バージョンがない場合に発生します。 Azure File Sync のサーバー登録が正常に機能するには、.NET Framework 4.7.2 以降のバージョンが必要です。

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

  1. .NET Framework 4.7.2 以降のバージョンをダウンロードしてインストールします。
  2. インストール後にサーバーを再起動します。
  3. サーバー登録 UI または PowerShell を使用して、サーバー登録を再試行します。

サーバーの登録がエラーで失敗する: 操作で無効な状態コード 'Unauthorized' が返されました

サーバーの登録中に、次のエラーが発生する可能性があります。

操作が無効な状態コード 'Unauthorized' を返しました

この問題は、Azure File Sync v20 エージェントのバグが原因で発生します。 この問題を回避するには、次の PowerShell コマンドを実行してサーバーを手動で登録します。

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

注

プレースホルダーの値を、サブスクリプション ID、テナント ID、リソース グループ名、ストレージ同期サービス名に置き換えます。

手動登録が完了したら、Azure portal の [登録済みサーバー] に サーバーが 表示されることを確認します。

サーバー登録には、"このサーバーは既に登録されています" というメッセージが表示されます。

サーバーが以前にストレージ同期サービスに登録されている場合は、エラー コード0x80C80064を含むこのメッセージが表示されます。 現在のストレージ同期サービスからサーバーの登録を解除し、新しいストレージ同期サービスに登録するには、「 Azure File Sync を使用してサーバーを登録解除する」の手順を完了します。

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

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

注

サーバーがクラスターの一部である場合、 Reset-StorageSyncServer-CleanClusterRegistration パラメーターはクラスター内のすべてのサーバーの登録を解除します。

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

この問題は、サーバーの登録中 に拡張 Internet Explorer セキュリティ ポリシーが有効になっている場合に発生します。 拡張 Internet Explorer セキュリティ ポリシーを正しく無効にする方法の詳細については、「Azure File Sync で使用する Windows Server の準備」および「Azure File Sync をデプロイする方法」を参照してください。

Azure portal の登録済みサーバーの下にサーバーが表示されない

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

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

関連項目

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

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