Azure File Sync のトラブルシューティング

Azure File Sync を使用すると、オンプレミスのファイル サーバーの柔軟性、パフォーマンス、互換性を維持したまま Azure Files で組織のファイル共有を一元化できます。 Azure File Sync により、ご利用の Windows Server が Azure ファイル共有の高速キャッシュに変わります。 SMB、NFS、FTPS など、Windows Server 上で利用できるあらゆるプロトコルを使用して、データにローカルにアクセスできます。 キャッシュは、世界中にいくつでも必要に応じて設置することができます。

この記事は、Azure File Sync のデプロイで発生する可能性がある問題のトラブルシューティングと解決を支援することを目的としています。 問題をさらに調査する必要がある場合に、システムから重要なログを収集する方法についても説明します。 ご質問に対する回答がここで見つからない場合は、次のチャネルでお問い合わせください (上から順に)。

  • Azure Files に関する Microsoft Q&A 質問ページ
  • Microsoft サポート。 新しいサポート要求を作成するには、Azure Portal の [ヘルプ] タブで、 [ヘルプとサポート] ボタンを選択し、 [新しいサポート要求] を選択します。

サーバーで Azure File Sync に関する問題 (同期、クラウド階層化など)が発生しています。 サーバー エンドポイントを削除して再作成する必要がありますか。

いいえ。サーバー エンドポイントの削除は、サーバーの再起動とは異なります。 サーバー エンドポイントを削除して再作成する操作が、同期、クラウドの階層化などの Azure File Sync の側面に関する問題を解決するために適した解決策になることはほぼありません。サーバー エンドポイントの削除は、破壊的な操作です。 階層化されたファイルがサーバー エンドポイントの名前空間の外部に存在する場合、データが失われる可能性があります。 詳細については、「階層化されたファイルがサーバー エンドポイント名前空間の外部に存在するのはなぜですか」を参照してください。 または、サーバーエンド ポイント名前空間内に存在する階層化されたファイルのファイルにアクセスできなくなる可能性があります。 このような問題は、サーバー エンドポイントを再作成しても解決しません。 クラウドの階層化を有効にしていない場合でも、階層化されたファイルがサーバー エンドポイントの名前空間内に存在する可能性があります。 そのため、特定のフォルダーで Azure File Sync の使用を停止したい場合や、Microsoft エンジニアから明示的に指示された場合を除き、サーバー エンドポイントを削除しないことをお勧めします。 サーバー エンドポイントの削除の詳細については、「サーバー エンドポイントを削除する」を参照してください。

エージェントのインストールとサーバー登録

エージェントのインストール エラーをトラブルシューティングする
管理者特権でのコマンド プロンプトで Azure File Sync エージェントのインストールに失敗した場合は、次のコマンドを実行してエージェントのインストール時のログ記録を有効にします。

StorageSyncAgent.msi /l*v AFSInstaller.log

installer.log をレビューして、インストールが失敗した原因を特定します。

次のエラーでエージェントのインストールが失敗する: エラーが発生したため、ストレージ同期エージェントのセットアップ ウィザードが完了しませんでした

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

CAQuietExec64:  + CategoryInfo          : SecurityError: (:) , PSSecurityException
CAQuietExec64:  + FullyQualifiedErrorId : UnauthorizedAccess
CAQuietExec64:  Error 0x80070001: Command line returned an error.

この問題は、PowerShell の実行ポリシーがグループ ポリシーを使用して構成され、ポリシー設定が [署名済みスクリプトのみを許可する] である場合に発生します。 Azure File Sync エージェントに含まれるすべてのスクリプトが署名されます。 Azure File Sync エージェントのインストールが失敗するのは、[実行をバイパスする] ポリシー設定を使用してインストーラーでスクリプトが実行されているためです。

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

Active Directory ドメイン コントローラーにエージェントをインストールできない
同期エージェントを Active Directory ドメイン コントローラーにインストールしようとしたが、PDC ロール所有者が Windows Server 2008 R2 (またはそれより前のバージョン) に存在する場合は、同期エージェントのインストールが失敗するという問題が発生することがあります。

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

Windows Server 2012 R2 でボリュームにアクセスできず、エラーが表示される:パラメーターが正しくありません
Windows Server 2012 R2 でサーバー エンドポイントを作成した後、ボリュームにアクセスすると次のエラーが発生する:

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

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

サーバー登録で一部の Azure サブスクリプションが一覧に表示されない
ServerRegistration.exe を使用してサーバーを登録している場合、[Azure サブスクリプション] ドロップダウンをクリックしたとき、サブスクリプションが表示されません。

この問題は、ServerRegistration.exe が最初の 5 つの Azure AD テナントからのみサブスクリプションを取得するために発生します。

サーバーのサーバー登録テナントの制限を増やすには、HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync の下に 5 より大きい値を持つ ServerRegistrationTenantLimit という名前の DWORD 値を作成します。

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

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

[サーバー登録] に"前提条件が見つからない" というメッセージが表示される
このメッセージは、Az または AzureRM PowerShell モジュールが PowerShell 5.1 にインストールされていない場合に表示されます。

注意

ServerRegistration.exe では、PowerShell 6.x はサポートされていません。 サーバーを登録するには、PowerShell 6.x で AzStorageSyncServer コマンドレットを使用できます。

PowerShell 5.1 に Az または AzureRM モジュールをインストールするには、次の手順を実行します。

  1. 管理者特権のプロンプトで「powershell」と入力して、Enter キーを押します。
  2. 次のドキュメントに従って、最新の Az または AzureRM モジュールをインストールします。
  3. ServerRegistration.exe を実行し、ストレージ同期サービスにサーバーを登録するウィザードを完了します。

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

"server is already registered" (このサーバーは既に登録されています) エラー メッセージが表示された [サーバーの登録] ダイアログのスクリーンショット

このメッセージは、以前にサーバーがストレージ同期サービスに登録されていた場合に表示されます。 現在のストレージ同期サービスからサーバーを登録解除し、新しいストレージ同期サービスに登録するには、Azure File Sync でのサーバーの登録解除に関する記事に記載されている手順を完了します。

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

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

注意

サーバーがクラスターの一部である場合は、省略可能な Reset-StorageSyncServer -CleanClusterRegistration パラメーターを使用して、クラスターの登録を削除することもできます。

サーバーの登録時に多数の "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 を実行し、ストレージ同期サービスにサーバーを登録するウィザードを完了します。

同期グループ管理

クラウド エンドポイントの作成エラー

クラウド エンドポイントの作成が "The specified Azure FileShare is already in use by a different CloudEndpoint (指定された Azure ファイル共有は別の CloudEndpoint で既に使用されています)" というエラーで失敗する
このエラーは、Azure ファイル共有が別のクラウド エンドポイントによって既に使用されている場合に発生します。

このメッセージが表示されたときに、Azure ファイル共有が現在クラウド エンドポイントで使用されていない場合は、次の手順を完了して、Azure ファイル共有上の Azure File Sync メタデータをクリアします。

警告

現在クラウド エンドポイントによって使用されている Azure ファイル共有上のメタデータを削除すると、Azure File Sync の操作は失敗します。 その後、別の同期グループでこのファイル共有を同期に使用すると、古い同期グループ内のファイルのデータ損失がほぼ確実になります。

  1. Azure ポータルで、Azure ファイル共有に移動します。
  2. Azure ファイル共有を右クリックし、 [メタデータの編集] を選択します。
  3. [SyncService] を右クリックし、 [削除] を選択します。

クラウド エンドポイントの作成が "AuthorizationFailed" というエラーで失敗する
このエラーは、ユーザー アカウントがクラウド エンドポイントを作成するための十分な権限を持っていない場合に発生します。

クラウド エンドポイントを作成するには、次の Microsoft 承認アクセス許可を持つユーザー アカウントが必要です。

  • Read:ロール定義の取得
  • 書き込み:カスタムのロール定義の作成または更新
  • Read:Get role assignment
  • 書き込み:ロール割り当ての作成

次の組み込みロールには、必要な Microsoft 承認アクセス許可が付与されています。

  • 所有者
  • User Access Administrator

現在のユーザー アカウントのロールに必要なアクセス許可が付与されているかどうかを確認するには:

  1. Azure portal で、 [リソース グループ] を選択します。
  2. ストレージ アカウントのあるリソース グループを選択し、 [アクセス制御 (IAM)] を選択します。
  3. [ロールの割り当て] タブを選択します。
  4. ユーザー アカウントに割り当てる [ロール] (所有者や共同作成者など) を選択します。
  5. [リソース プロバイダー] 一覧で、 [Microsoft 承認] を選択します。
    • [ロールの割り当て] のアクセス許可が [読み取り][書き込み] になっている必要があります。
    • [ロール定義] のアクセス許可が [読み取り][書き込み] になっている必要があります。

サーバー エンドポイントの作成と削除のエラー

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2134375898 または 0x80c80226) というエラーで失敗する
このエラーは、サーバー エンドポイントのパスがシステム ボリューム上にあり、クラウドを使った階層化が有効な場合に発生します。 システム ボリュームでは、クラウドの階層化はサポートされていません。 システム ボリュームにサーバー エンドポイントを作成するには、サーバー エンドポイントを作成するときにクラウドの階層化を無効にします。

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2147024894 または 0x80070002) というエラーで失敗する
このエラーは、指定したサーバー エンドポイントのパスが有効でない場合に発生します。 指定したサーバー エンドポイントのパスがローカルに接続された NTFS ボリュームであることを確認します。 Azure File Sync は、サーバー エンドポイント パスとして、マップされたドライブをサポートしていないことに注意してください。

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2134375640 or 0x80c80328)
このエラーは、指定したサーバー エンドポイント パスが NTFS ボリュームでない場合に発生します。 指定したサーバー エンドポイントのパスがローカルに接続された NTFS ボリュームであることを確認します。 Azure File Sync は、サーバー エンドポイント パスとして、マップされたドライブをサポートしていないことに注意してください。

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2134347507 または 0x80c8710d) というエラーで失敗する
このエラーは、Azure File Sync が、圧縮されたシステム ボリューム情報フォルダーがあるボリューム上でサーバー エンドポイントをサポートしていないことが原因で発生します。 この問題を解決するには、システム ボリューム情報フォルダーを圧縮解除します。 システム ボリューム情報フォルダーがボリュームにある唯一の圧縮フォルダーである場合は、次の手順を実行します。

  1. PsExec ツールをダウンロードします。
  2. 管理者特権でのコマンド プロンプトから次のコマンドを実行して、システム アカウントで実行されるコマンド プロンプトを起動します。PsExec.exe -i -s -d cmd
  3. システム アカウントで実行されているコマンド プロンプトから、次のコマンドを入力し、Enter キーを押します。
    cd /d "drive letter:\System Volume Information"
    compact /u /s

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2134376345 または 0x80C80067) というエラーで失敗する
このエラーは、サーバーあたりのサーバー エンドポイント数の制限に達した場合に発生します。 Azure File Sync は、現在、サーバーあたり最大で 30 のサーバー エンドポイントをサポートしています。 詳細については、「Azure File Sync のスケール ターゲット」をご覧ください。

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2134376427 または 0x80c80015) というエラーで失敗する
このエラーは、指定したサーバー エンドポイント パスが別のサーバー エンドポイントによって既に同期されている場合に発生します。 Azure File Sync では、同じディレクトリまたはボリュームを複数のサーバー エンドポイントで同期することはサポートされていません。

サーバー エンドポイントの作成が "MgmtServerJobFailed" (エラー コード: -2160590967 または 0x80c80077) というエラーで失敗する
このエラーは、サーバー エンドポイントのパスに孤立した階層化ファイルが含まれている場合に発生します。 サーバー エンドポイントが最近削除された場合は、孤立した階層化ファイルのクリーンアップが完了するまで待ちます。 孤立した階層化ファイルのクリーンアップが開始されると、イベント ID 6662 がテレメトリ イベント ログに記録されます。 孤立した階層化ファイルのクリーンアップが完了し、パスを使用してサーバー エンドポイントを再度作成できるようになったら、イベント ID 6661 が記録されます。 階層化されたファイルのクリーンアップが完了した後にサーバー エンドポイントの作成が失敗する場合、またはイベント ログがロールオーバーしたためにテレメトリ イベント ログにイベント ID 6661 が見つからない場合は、「サーバー エンドポイントを削除した後、サーバー上で階層化されたファイルにアクセスできない」セクションの手順を実行して、孤立した階層化ファイルを削除します。

サーバー エンドポイントの削除が "MgmtServerJobExpired" (エラー コード: -2134347757 または 0x80c87013) というエラーで失敗する
このエラーは、サーバーがオフラインの場合、またはネットワークに接続されていない場合に発生します。 サーバーを使用できなくなったら、ポータルでサーバーの登録を解除します。これで、サーバー エンドポイントが削除されます。 サーバー エンドポイントを削除するには、Azure File Sync 使用したサーバーの登録解除に関するセクションで説明されている手順を実行します。

サーバー エンドポイントの正常性

[サーバー エンドポイントのプロパティ] ページが開かない、またはクラウドの階層化ポリシーを更新できない
この問題は、サーバー エンドポイントでの管理操作が失敗する場合に発生することがあります。 Azure Portal で [サーバー エンドポイントのプロパティ] ページが開かない場合は、サーバーから PowerShell コマンドでサーバー エンドポイント を更新すると、この問題が解決する場合があります。

# Get the server endpoint id based on the server endpoint DisplayName property
Get-AzStorageSyncServerEndpoint `
    -ResourceGroupName myrgname `
    -StorageSyncServiceName storagesvcname `
    -SyncGroupName mysyncgroup | `
Tee-Object -Variable serverEndpoint

# Update the free space percent policy for the server endpoint
Set-AzStorageSyncServerEndpoint `
    -InputObject $serverEndpoint
    -CloudTiering `
    -VolumeFreeSpacePercent 60

サーバー エンドポイントの正常性状態が "アクティビティなし" または "保留中" で、登録済みサーバー ブレードのサーバーの状態が "オフラインのようです" になっている

この問題は、ストレージ同期モニター プロセス (AzureStorageSyncMonitor.exe) が実行されていない場合、またはサーバーが Azure File Sync サービスにアクセスできない場合に発生する可能性があります。

ポータルに "オフラインのようです" と表示されているサーバーで、(イベント ビューアーの Applications and Services\Microsoft\FileSync\Agent にある) テレメトリ イベント ログのイベント ID 9301 を確認し、そのサーバーが Azure File Sync サービスにアクセスできない理由を特定します。

  • GetNextJob の完了状態が 0 であると記録されている場合、サーバーは Azure File Sync サービスと通信できます。

    • サーバーでタスク マネージャーを開き、ストレージ同期モニター (AzureStorageSyncMonitor.exe) プロセスが実行されていることを確認します。 プロセスが実行されていない場合は、最初にサーバーの再起動を試みます。 サーバーを再起動しても問題が解決しない場合は、Azure File Sync エージェントのバージョンを最新のものにアップグレードします。
  • GetNextJob completed with status: -2134347756 がログに記録されている場合、サーバーはファイアウォール、プロキシ、または TLS 暗号スイートの順序の構成が原因で Azure File Sync サービスと通信できません。

    • サーバーがファイアウォールの背後にある場合は、送信ポート 443 が許可されていることを確認します。 ファイアウォールで特定のドメインへのトラフィックが制限されている場合は、ファイアウォールのドキュメントに記載されているドメインにアクセスできることを確認します。

    • サーバーがプロキシの背後にある場合は、プロキシのドキュメントに記載されている手順に従って、コンピューター全体またはアプリ固有のプロキシ設定を構成します。

    • このサービス エンドポイントへのネットワーク接続を確認するには、Test-StorageSyncNetworkConnectivity コマンドレットを使用します。 詳細については、サービス エンドポイントへのネットワーク接続のテストに関するページを参照してください。

    • TLS 暗号スイートの順序がサーバーで構成されている場合は、グループ ポリシーまたは TLS コマンドレットを使用して、暗号スイートを追加できます。

      現在、Azure File Sync では TLS 1.2 プロトコル用の次の暗号スイートがサポートされています。

      • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
      • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
      • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
      • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
  • GetNextJob の完了状態が -2134347764 であると記録されている場合、サーバーは証明書の有効期限切れまたは削除が原因で Azure File Sync サービスと通信できません。

    • サーバーで次の PowerShell コマンドを実行して、認証に使用される証明書をリセットしてください。
    Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>
    

サーバー エンドポイントの正常性状態が "アクティビティなし" で、登録済みサーバー ブレードのサーバーの状態が "オンライン" になっている

サーバー エンドポイントの正常性状態 [アクティビティなし] とは、過去 2 時間にわたってサーバー エンドポイントで同期アクティビティが記録されていないことを意味します。

サーバー上の現在の同期アクティビティを確認するには、「現在の同期セッションの進行状況を監視するにはどうすればよいですか。」を参照してください。

バグまたはシステム リソースの不足によって、サーバー エンドポイントで数時間、同期アクティビティを記録できていない場合があります。 最新の Azure File Sync エージェント バージョンがインストールされていることを確認してください。 問題が解決しない場合は、サポート リクエストを開いてください。

注意

[登録済みサーバー] ブレードで、サーバーの状態が "オフラインのようです" になっている場合は、「サーバー エンドポイントの正常性状態が "アクティビティなし" または "保留中" で、登録済みサーバー ブレードのサーバーの状態が "オフラインのようです" になっている」セクションに記載されている手順を行ってください。

同期

SMB またはポータルを使用して Azure ファイル共有内にファイルを直接作成した場合、ファイルが同期グループ内のサーバーと同期されるまでどのくらい時間がかかりますか?

Azure Portal または SMB を使用して Azure ファイル共有に加えられた変更は、サーバー エンドポイントに対する変更とは異なり、検出とレプリケーションが即座に行われることはありません。 Azure Files にはまだ変更通知/ジャーナルがないため、ファイルが変更されたときに自動的に同期セッションを開始する方法はありません。 Windows Server では、Azure File Sync は Windows USN ジャーナルを使用して、ファイルが変更されたときに同期セッションを自動的に開始します。

Azure ファイル共有に対する変更を検出するために、Azure File Sync には、変更検出ジョブ と呼ばれるスケジュールされたジョブがあります。 変更検出ジョブは、ファイル共有内のすべてのファイルを列挙した後、ファイルの同期バージョンと比較します。 変更検出ジョブによってファイルが変更されていると判断された場合に、Azure File Sync は同期セッションを開始します。 変更検出ジョブは 24 時間ごとに実行されます。 変更検出ジョブは Azure ファイル共有内のすべてのファイルを列挙することで機能するため、変更の検出は、大きな名前空間のほうが小さな名前空間よりも時間がかかります。 大規模な名前空間の場合、変更されたファイルを判断するのに 24 時間ごとに 1 回より長くなる場合があります。

Azure ファイル共有で変更されたファイルを直ちに同期したければ、Invoke-AzStorageSyncChangeDetection PowerShell コマンドレットを使用すると、Azure ファイル共有における変更の検出を手動で開始できます。 このコマンドレットは、なんらかの自動プロセスによって Azure ファイル共有に変更が加えられたり、管理者によって (ファイルやディレクトリを共有に移動するなどの) 変更が実行されたりするシナリオを意図したものです。 エンド ユーザーの変更に関しては、Azure File Sync エージェントを IaaS VM にインストールし、エンド ユーザーに IaaS VM 経由でファイル共有にアクセスしてもらうことをお勧めします。 そのようにすることで、すべての変更がすぐに他のエージェントと同期され、Invoke-AzStorageSyncChangeDetection コマンドレットを使う必要はありません。 詳細については、Invoke-AzStorageSyncChangeDetection のドキュメントを参照してください。

注意

Invoke-AzStorageSyncChangeDetection PowerShell コマンドレットは、最大 10,000 個の項目のみを検出できます。 その他の制限事項については、Invoke-AzStorageSyncChangeDetection のドキュメントを参照してください。

注意

REST を使用して Azure ファイル共有に加えられた変更は、SMB の最終更新時刻を更新するものではなく、同期による変更とは見なされません。

Windows Server 上のボリュームに対する USN のような変更検出を Azure ファイル共有に追加するための調査を行っています。

サーバー エンドポイントの正常性が数時間にわたって保留状態になる
この問題は、クラウド エンドポイントを作成してデータが格納されている Azure ファイル共有を使用した場合に発生することが予期されます。 クラウドとサーバー エンドポイント間でファイルを同期する前に、Azure ファイル共有の変更をスキャンする変更列挙ジョブが完了している必要があります。 このジョブの完了にかかる時間は、Azure ファイル共有内の名前空間のサイズに依存します。 変更列挙ジョブが完了したら、サーバー エンドポイントの正常性を更新する必要があります。

同期の正常性を監視するにはどうすればよいですか。

各同期グループ内で、個別のサーバー エンドポイントをドリルダウンして、最後に完了した同期セッションの状態を確認できます。 [正常性] 列が緑色で、[Files Not Syncing](同期していないファイル数) の値が 0 の場合は、同期が予期したとおりに動作していることを示します。 そうでない場合は、下に示す一般的な同期エラーの一覧と、同期していないファイルの処理方法を参照してください。

Azure portal のスクリーンショット

現在の同期セッションの進行状況を監視するにはどうすればよいですか。

同期グループ内で、問題のサーバー エンドポイントに移動して [同期アクティビティ] セクションを調べ、現在の同期セッション内のアップロード済みファイルとダウンロード済みファイルの数を確認します。 この状態は約 5 分遅れて表示されるため、この時間内に完了するほど小規模な同期セッションの場合は、ポータルでレポートされない可能性があることに注意してください。

自分のサーバーが互いに同期されているかどうかを確認するにはどうすればよいですか。

特定の同期グループ内の各サーバーについて、以下を確認します。

  • アップロードとダウンロードの両方で、[最後に試行された同期] のタイムスタンプが最新であること。
  • アップロードとダウンロードの両方で、状態が緑色であること。
  • [同期アクティビティ] フィールドに表示された残りの同期ファイル数が非常に少ないか、0 であること。
  • アップロードとダウンロードの両方で、[Files Not Syncing](同期していないファイル数) フィールドが 0 であること。

同期していない特定のファイルやフォルダーがあるかどうかを確認するにはどうすればよいですか。

特定の同期セッションに対して、サーバーの PerItemErrorCount またはポータルの [Files Not Syncing](同期していないファイル数) の数が 0 より大きい場合は、何らかの項目の同期が失敗していることを意味します。ファイルやフォルダーに、同期を妨げる特性がある可能性があります。 これらの特性は、永続的で、同期を再開するためには明示的なアクション (たとえば、ファイル名やフォルダー名からサポートされていない文字を削除するなど) が必要な場合があります。 また、特性は一時的であり、ファイルやフォルダーの同期が自動的に再開される場合もあります。たとえば、開くハンドルを含むファイルは、ファイルが閉じられたときに自動的に同期を再開します。 Azure File Sync エンジンがそのような問題を検出すると、エラー ログが生成されます。これを解析して、現在正しく同期していない項目を一覧表示できます。

これらのエラーを確認するには、FileSyncErrorsReport.ps1 PowerShell スクリプト (Azure File Sync エージェントのエージェント インストール ディレクトリ内にあります) を実行して、開くハンドルやサポートされていない文字などの問題によって同期が失敗したファイルを識別します。 ItemPath フィールドは、ルート同期ディレクトリを基準としたファイルの相対的な場所を示します。 修復の手順については、下に示す一般的な同期エラーの一覧を参照してください。

注意

FileSyncErrorsReport.ps1 スクリプトから "ファイル エラーは見つかりませんでした" が返された場合、または同期グループの項目ごとのエラーが一覧表示されない場合は、次のいずれかの原因が考えられます。

  • 原因 1:最後に完了した同期セッションに項目単位のエラーがありませんでした。 同期していないファイルが 0 個であることを示すために、ポータルをすぐに更新する必要があります。 既定では、FileSyncErrorsReport.ps1 スクリプトは、最後に完了した同期セッションの項目ごとのエラーのみを表示します。 すべての同期セッションの項目ごとのエラーを表示するには、-ReportAllErrors パラメーターを使用します。

    • テレメトリ イベント ログの最新のイベント ID 9102 を調べ、PerItemErrorCount が 0 であることを確認します。
  • 原因 2:項目ごとのエラーが多すぎるため、サーバー上の ItemResults イベント ログが折り返されました。イベント ログには、この同期グループのエラーはもう含まれていません。

    • この問題を回避するには、ItemResults イベント ログのサイズを増やします。 ItemResults イベント ログは、イベント ビューアーの "Applications and Services Logs\Microsoft\FileSync\Agent" にあります。

ファイル/ディレクトリ単位の同期エラーのトラブルシューティング

ItemResults log - 項目単位の同期エラー

HRESULT HRESULT (10 進値) エラー文字列 問題 Remediation
0x80070043 -2147942467 ERROR_BAD_NET_NAME サーバー上の階層化されたファイルにアクセスできません。 この問題は、サーバー エンドポイントを削除する前に、階層化されたファイルが取り消されなかった場合に発生します。 この問題を解決する方法は、「サーバー エンドポイントを削除した後、サーバー上で階層化されたファイルにアクセスできない」を参照してください。
0x80c80207 -2134375929 ECS_E_SYNC_CONSTRAINT_CONFLICT 依存フォルダーがまだ同期されていないため、ファイルまたはディレクトリの変更を同期できません。 この項目は、依存する変更が同期された後に同期されます。 必要なアクションはありません。 エラーが数日間継続する場合は、PowerShell の FileSyncErrorsReport.ps1 スクリプトを使用して、依存フォルダーがなぜまだ同期されないかを確認します。
0x80C8028A -2134375798 ECS_E_SYNC_CONSTRAINT_CONFLICT_ON_FAILED_DEPENDEE 依存フォルダーがまだ同期されていないため、ファイルまたはディレクトリの変更を同期できません。 この項目は、依存する変更が同期された後に同期されます。 必要なアクションはありません。 エラーが数日間継続する場合は、PowerShell の FileSyncErrorsReport.ps1 スクリプトを使用して、依存フォルダーがなぜまだ同期されないかを確認します。
0x80c80284 -2134375804 ECS_E_SYNC_CONSTRAINT_CONFLICT_SESSION_FAILED 依存フォルダーがまだ同期されておらず、同期セッションが失敗したため、ファイルまたはディレクトリの変更を同期できません。 この項目は、依存する変更が同期された後に同期されます。 必要なアクションはありません。 エラーが引き続き発生する場合は、同期セッションの失敗を調査します。
0x8007007b -2147024773 ERROR_INVALID_NAME ファイルまたはディレクトリの名前が無効です。 問題のファイルまたはディレクトリの名前を変更します。 詳しくは、「サポートされていない文字の処理」をご覧ください。
0x80c80255 -2134375851 ECS_E_XSMB_REST_INCOMPATIBILITY ファイルまたはディレクトリの名前が無効です。 問題のファイルまたはディレクトリの名前を変更します。 詳しくは、「サポートされていない文字の処理」をご覧ください。
0x80c80018 -2134376424 ECS_E_SYNC_FILE_IN_USE ファイルは使用中のため、同期できません。 ファイルは使用されなくなると同期されます。 必要なアクションはありません。 Azure File Sync は、1 日 1 回サーバー上で一時 VSS スナップショットを作成して、開くハンドルを含むファイルを同期します。
0x80c8031d -2134375651 ECS_E_CONCURRENCY_CHECK_FAILED ファイルが変更されましたが、まだ同期によって変更が検出されていません。この変更が検出された後に同期が復旧します。 必要なアクションはありません。
0x80070002 -2147024894 ERROR_FILE_NOT_FOUND ファイルが削除されており、同期で変更が認識されません。 必要なアクションはありません。 変更の検出によってファイルが削除されたことが検出されると、同期によってこのエラーのログ記録が停止されます。
0x80070003 -2147942403 ERROR_PATH_NOT_FOUND 同期先で項目が既に削除されているのに同期で変更が認識されないため、ファイルまたはディレクトリの削除を同期できません。 必要なアクションはありません。 同期先で変更の検出が実行されて、削除済みの項目が同期で検出されると、同期によってこのエラーのログ記録が停止されます。
0x80c80205 -2134375931 ECS_E_SYNC_ITEM_SKIP ファイルまたはディレクトリがスキップされましたが、次の同期セッション中に同期されます。 項目のダウンロード時にこのエラーがレポートされる場合は、ファイルまたはディレクトリの名前が高確率で無効になっています。 ファイルのアップロード時にこのエラーがレポートされる場合は、必要なアクションはありません。 ファイルのダウンロード時にこのエラーがレポートされる場合は、問題のファイルまたはディレクトリの名前を変更します。 詳しくは、「サポートされていない文字の処理」をご覧ください。
0x800700B7 -2147024713 ERROR_ALREADY_EXISTS 同期先で項目が既に存在しているのに同期で変更が認識されないため、ファイルまたはディレクトリの作成を同期できません。 必要なアクションはありません。 同期先で変更の検出が実行されて、この新しい項目が同期で認識されると、同期によってこのエラーのログ記録が停止されます。
0x80c8603e -2134351810 ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED Azure ファイル共有の制限に達したため、ファイルを同期できません。 この問題を解決するには、トラブルシューティング ガイドの「Azure のファイル共有ストレージの上限に到達しました」をご覧ください。
0x80c83008 -2134364152 ECS_E_CANNOT_CREATE_AZURE_STAGED_FILE Azure ファイル共有の制限に達したため、ファイルを同期できません。 この問題を解決するには、トラブルシューティング ガイドの「Azure のファイル共有ストレージの上限に到達しました」をご覧ください。
0x80c8027C -2134375812 ECS_E_ACCESS_DENIED_EFS ファイルは、サポートされていないソリューション (NTFS EFS など) によって暗号化されています。 ファイルの暗号化を解除し、サポートされている暗号化ソリューションを使用します。 サポートされているソリューションの一覧については、計画ガイドの「暗号化」セクションをご覧ください。
0x80c80283 -2160591491 ECS_E_ACCESS_DENIED_DFSRRO ファイルは、DFS-R 読み取り専用レプリケーション フォルダーにあります。 ファイルは、DFS-R 読み取り専用レプリケーション フォルダーにあります。 Azure Files Sync は DFS-R 読み取り専用レプリケーション フォルダーにおけるサーバー エンドポイントをサポートしません。 詳細については、計画ガイドを参照してください。
0x80070005 -2147024891 ERROR_ACCESS_DENIED ファイルは削除保留中の状態です。 必要なアクションはありません。 開いているファイルのすべてのハンドルが閉じられると、ファイルは削除されます。
0x80c86044 -2134351804 ECS_E_AZURE_AUTHORIZATION_FAILED ストレージ アカウントでファイアウォールと仮想ネットワークの設定が有効になっていて、サーバーにそのストレージ アカウントへのアクセス権がないため、ファイルを同期できません。 デプロイ ガイドの「ファイアウォールと仮想ネットワークの設定を構成する」セクションに記載されている手順に従い、サーバー IP アドレスまたは仮想ネットワークを追加します。
0x80c80243 -2134375869 ECS_E_SECURITY_DESCRIPTOR_SIZE_TOO_LARGE セキュリティ記述子のサイズが 64 KiB の制限を超えているため、ファイルを同期できません。 この問題を解決するには、ファイルのアクセス制御エントリ (ACE) を削除して、セキュリティ記述子のサイズを減らします。
0x8000ffff -2147418113 E_UNEXPECTED 予期しないエラーが発生したため、ファイルを同期できません。 エラーが数日間継続して発生する場合は、サポート ケースを開いてください。
0x80070020 -2147024864 ERROR_SHARING_VIOLATION ファイルは使用中のため、同期できません。 ファイルは使用されなくなると同期されます。 必要なアクションはありません。
0x80c80017 -2134376425 ECS_E_SYNC_OPLOCK_BROKEN 同期中にファイルが変更されたため、再度同期する必要があります。 必要なアクションはありません。
0x80070017 -2147024873 ERROR_CRC CRC エラーが発生したため、ファイルを同期できません。 このエラーは、サーバー エンドポイントを削除する前に、階層化されたファイルがリコールされなかったか、ファイルが壊れている場合に発生することがあります。 この問題を解決する方法は、「サーバー エンドポイントを削除した後、サーバー上で階層化されたファイルにアクセスできない」を参照し、孤立状態の階層化されたファイルを削除してください。 孤立状態にあった階層化されたファイルを削除した後もエラーが解消されない場合は、ボリューム上で chkdsk を実行します。
0x80c80200 -2134375936 ECS_E_SYNC_CONFLICT_NAME_EXISTS 競合ファイルの最大数に達したため、ファイルを同期できません。 Azure File Sync は、1 つのファイルにつき 100 個の競合ファイルをサポートします。 ファイル競合の詳細については、Azure File Sync のよく寄せられる質問 (FAQ) を参照してください。 この問題を解決するには、競合ファイルの数を減らします。 競合ファイルの数が 100 個未満になると、ファイルは同期されます。
0x80c8027d -2134375811 ECS_E_DIRECTORY_RENAME_FAILED ディレクトリ内のファイルまたはフォルダーに、開いているハンドルが含まれているため、ディレクトリの名前変更を同期できません。 必要なアクションはありません。 ディレクトリの名前変更は、ディレクトリ内で開いているすべてのファイル ハンドルが閉じられた後に同期されます。
0x800700de -2147024674 ERROR_BAD_FILE_TYPE Azure ファイル共有にもはや存在しないファイルのバージョンを参照しているため、サーバー上の階層化されたファイルにアクセスできません。 この問題は、階層化されたファイルが Windows Server のバックアップから復元された場合に発生する可能性があります。 この問題を解決するには、Azure ファイル共有にあるスナップショットからファイルを復元します。

サポートされていない文字の処理

FileSyncErrorsReport.ps1 PowerShell スクリプトで、サポートされていない文字が原因で項目単位の同期エラー (エラー コード 0x8007007b または 0x80c80255) が示されている場合は、該当するファイル名から問題のある文字を削除するか、ファイル名を変更する必要があります。 これらの文字の大部分には標準のビジュアル エンコードがないため、PowerShell はこれらの文字を疑問符または空の四角形として出力します。

注意

評価ツールを使用して、サポートされていない文字を識別できます。 データセットに無効な文字が含まれている複数のファイルがある場合は、ScanUnsupportedChars スクリプトを使用して、サポートされていない文字を含むファイルの名前を変更します。

下の表に、Azure File Sync でまだサポートされていない Unicode 文字をすべて示します。

文字セット 文字数
0x00000000 - 0x0000001F (制御文字) 32
0x0000FDD0 - 0x0000FDDD (アラビア文字表示形 - a) 14
  • 0x00000022 (引用符)
  • 0x0000002A (アスタリスク)
  • 0x0000002F (スラッシュ)
  • 0x0000003A (コロン)
  • 0x0000003C (より小さい)
  • 0x0000003E (より大きい)
  • 0x0000003F (疑問符)
  • 0x0000005C (円記号)
  • 0x0000007C (パイプまたはバー)
9
  • 0x0004FFFE - 0x0004FFFF = 2 (非文字)
  • 0x0008FFFE - 0x0008FFFF = 2 (非文字)
  • 0x000CFFFE - 0x000CFFFF = 2 (非文字)
  • 0x0010FFFE - 0x0010FFFF = 2 (非文字)
8
  • 0x0000009D (osc オペレーティング システム コマンド)
  • 0x00000090 (dcs デバイス コントロール文字列)
  • 0x0000008F (ss3 シングル シフト 3)
  • 0x00000081 (ハイ オクテット プリセット)
  • 0x0000007F (del 削除)
  • 0x0000008D (ri 逆改行)
6
0x0000FFF0、0x0000FFFD、0x0000FFFE、0x0000FFFF (特殊文字) 4
末尾がピリオドのファイルまたはディレクトリ 1

一般的な同期エラー

同期セッションが取り消されました。

エラー コード
HRESULT 0x800704c7
HRESULT (10 進値) -2147023673
エラー文字列 ERROR_CANCELLED
修復が必要か いいえ

同期セッションは、サーバーの再起動や更新、VSS スナップショットなど、さまざまな理由によって失敗することがあります。このエラーはフォローアップが必要なように見えますが、数時間にわたって続かない限り無視してかまいません。

サービスとの接続を確立できませんでした。

エラー コード
HRESULT 0x80072ee7
HRESULT (10 進値) -2147012889
エラー文字列 WININET_E_NAME_NOT_RESOLVED
修復が必要か はい

このエラーは、サーバーから Azure File Sync サービスにアクセスできない場合に発生します。 次の手順を行うと、このエラーを解決できます。

  1. Windows サービス FileSyncSvc.exe がファイアウォールによってブロックされていないことを確認します。

  2. Azure File Sync サービスへの発信接続に対して、ポート 443 が開いていることを確認します。 この確認には、Test-NetConnection コマンドレットを使用します。 以下の <azure-file-sync-endpoint> プレースホルダーの URL については、Azure File Sync のプロキシとファイアウォールの設定に関するページを参照してください。

    Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
    
  3. プロキシ構成が意図したとおりに設定されていることを確認します。 この確認には、Get-StorageSyncProxyConfiguration コマンドレットを使用します。 Azure File Sync のプロキシ構成の詳細については、Azure File Sync のプロキシとファイアウォールの設定に関するページを参照してください。

    $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
    Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
    Get-StorageSyncProxyConfiguration
    
  4. このサービス エンドポイントへのネットワーク接続を確認するには、Test-StorageSyncNetworkConnectivity コマンドレットを使用します。 詳細については、サービス エンドポイントへのネットワーク接続のテストに関するページを参照してください。

  5. ネットワーク接続のトラブルシューティングについてさらにサポートが必要な場合は、ネットワーク管理者に相談してください。

注意

Azure File Sync サービスへのネットワーク接続が復元されたとき、同期が直ちに再開されない可能性があります。 既定では、サーバー エンドポイントの場所で変更が検出されなかった場合、Azure File Sync は 30 分ごとに同期セッションを開始します。 同期セッションを強制的に実行するには、ストレージ同期エージェント (FileSyncSvc) サービスを再起動するか、サーバー エンドポイントの場所にあるファイルまたはディレクトリに変更を加えます。

ユーザーの要求がサービスによってスロットルされました。

エラー コード
HRESULT 0x80c8004c
HRESULT (10 進値) -2134376372
エラー文字列 ECS_E_USER_REQUEST_THROTTLED
修復が必要か いいえ

必要なアクションはありません。サーバーは再試行します。 このエラーが数時間継続して発生する場合は、サポート要求を作成してください。

操作が中止されたため、同期に失敗しました

エラー コード
HRESULT 0x80c83000
HRESULT (10 進値) -2134364160
エラー文字列 ECS_E_OPERATION_ABORTED
修復が必要か いいえ

必要な操作はありません。 このエラーが数時間継続して発生する場合は、サポート要求を作成してください。

復元後に変更検出が完了するまでは同期がブロックされます

エラー コード
HRESULT 0x80c83075
HRESULT (10 進値) -2134364043
エラー文字列 ECS_E_SYNC_BLOCKED_ON_CHANGE_DETECTION_POST_RESTORE
修復が必要か いいえ

必要な操作はありません。 Azure Backup を使用してファイルまたはファイル共有 (クラウド エンドポイント) が復元されるとき、Azure ファイル共有に対する変更検出が完了するまでは同期がブロックされます。 復元が完了すると変更検出がただちに実行され、その期間はファイル共有内のファイル数に基づきます。

同期データベースがアンロードされたため、同期が失敗しました。

エラー コード
HRESULT 0x80041295
HRESULT (10 進値) -2147216747
エラー文字列 SYNC_E_METADATA_INVALID_OPERATION
修復が必要か いいえ

このエラーは、通常、バックアップ アプリケーションによって VSS スナップショットが作成され、同期データベースがアンロードされた場合に発生します。 このエラーが数時間継続して発生する場合は、サポート要求を作成してください。

Sync が、クラウド エンドポイントで指定された Azure ファイル共有にアクセスできません。

エラー コード
HRESULT 0x80c8305f
HRESULT (10 進値) -2134364065
エラー文字列 ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED
修復が必要か はい

このエラーは、Azure File Sync エージェントが Azure ファイル共有にアクセスできないために発生します。原因としては、Azure ファイル共有またはそれをホストしているストレージ アカウントが存在しなくなったことが考えられます。 次の手順を行うと、このエラーを解決できます。

  1. ストレージ アカウントが存在することを確認します。
  2. Azure ファイル共有が存在することを確認します。
  3. Azure File Sync がストレージ アカウントへのアクセス権を持っていることを確認します。
  4. ストレージ アカウントに対するファイアウォールと仮想ネットワークの設定が適切に構成されていることを確認します (有効な場合)

この要求にこの操作の実行権限がないために同期が失敗しました。

エラー コード
HRESULT 0x80c86044
HRESULT (10 進値) -2134351804
エラー文字列 ECS_E_AZURE_AUTHORIZATION_FAILED
修復が必要か はい

このエラーは、Azure File Sync エージェントが Azure ファイル共有へのアクセスを承認されていないために発生します。 次の手順を行うと、このエラーを解決できます。

  1. ストレージ アカウントが存在することを確認します。
  2. Azure ファイル共有が存在することを確認します。
  3. ストレージ アカウントに対するファイアウォールと仮想ネットワークの設定が適切に構成されていることを確認します (有効な場合)
  4. Azure File Sync がストレージ アカウントへのアクセス権を持っていることを確認します。

使用されているストレージ アカウント名を解決できませんでした。

エラー コード
HRESULT 0x80C83060
HRESULT (10 進値) -2134364064
エラー文字列 ECS_E_STORAGE_ACCOUNT_NAME_UNRESOLVED
修復が必要か はい
  1. サーバーからストレージの DNS 名を解決できることを確認します。

    Test-NetConnection -ComputerName <storage-account-name>.file.core.windows.net -Port 443
    
  2. ストレージ アカウントが存在することを確認します。

  3. ストレージ アカウントに対するファイアウォールと仮想ネットワークの設定が適切に構成されていることを確認します (有効な場合)

ストレージ アカウントへのアクセス中に不明なエラーが発生しました。

エラー コード
HRESULT 0x80c8308a
HRESULT (10 進値) -2134364022
エラー文字列 ECS_E_STORAGE_ACCOUNT_UNKNOWN_ERROR
修復が必要か はい
  1. ストレージ アカウントが存在することを確認します。
  2. ストレージ アカウントに対するファイアウォールと仮想ネットワークの設定が適切に構成されていることを確認します (有効な場合)

ストレージ アカウントがロックされているため、同期できませんでした。

エラー コード
HRESULT 0x80c83092
HRESULT (10 進値) -2134364014
エラー文字列 ECS_E_STORAGE_ACCOUNT_LOCKED
修復が必要か はい

このエラーは、ストレージ アカウントに読み取り専用のリソース ロックがある場合に発生します。 この問題を解決するには、ストレージ アカウント上の読み取り専用のリソース ロックを削除します。

同期データベースの問題により、同期が失敗しました。

エラー コード
HRESULT 0x8e5e044e
HRESULT (10 進値) -1906441138
エラー文字列 JET_errWriteConflict
修復が必要か はい

このエラーは、Azure File Sync で使用される内部データベースに問題がある場合に発生します。この問題が発生した場合は、サポート要求を作成してください。問題解決のために Microsoft からご連絡を差し上げます。

サーバーにインストールされている Azure File Sync エージェントのバージョンはサポートされていません。

エラー コード
HRESULT 0x80C8306B
HRESULT (10 進値) -2134364053
エラー文字列 ECS_E_AGENT_VERSION_BLOCKED
修復が必要か はい

このエラーは、サーバーにインストールされている Azure File Sync エージェントのバージョンがサポートされていない場合に発生します。 この問題を解決するには、サポートされているエージェントのバージョンアップグレードします。

Azure ファイル共有ストレージの上限に達しました。

エラー コード
HRESULT 0x80c8603e
HRESULT (10 進値) -2134351810
エラー文字列 ECS_E_AZURE_STORAGE_SHARE_SIZE_LIMIT_REACHED
修復が必要か はい
エラー コード
HRESULT 0x80c80249
HRESULT (10 進値) -2134375863
エラー文字列 ECS_E_NOT_ENOUGH_REMOTE_STORAGE
修復が必要か はい

同期セッションは、Azure ファイル共有ストレージの上限に達したときに、これらのいずれかのエラーで失敗します。Azure ファイル共有にクォータが適用されている場合や、使用量が Azure ファイル共有の制限を超えた場合に発生する可能性があります。 詳細については、Azure ファイル共有の現在の制限に関する記事を参照してください。

  1. ストレージ同期サービス内で同期グループに移動します。

  2. 同期グループ内でクラウド エンドポイントを選択します。

  3. 開いているウィンドウ内の Azure ファイル共有名をメモします。

  4. リンクされているストレージ アカウントを選択します。 このリンクが失敗する場合は、参照されているストレージ アカウントが削除されています。

    ストレージ アカウントへのリンクが表示されたクラウド エンドポイントの詳細ウィンドウを示すスクリーンショット

  5. [ファイル] を選択して、ファイル共有の一覧を表示します。

  6. クラウド エンドポイントによって参照されている Azure ファイル共有の行の末尾にある 3 つの点をクリックします。

  7. [クォータ] の下に [使用量] があることを確認します。 このクォータは、代替クォータが指定されていない限り Azure ファイル共有の最大サイズと同じになります。

    Azure ファイル共有のプロパティのスクリーンショット

共有がいっぱいでクォータが設定されていない場合、この問題を解決する 1 つの方法は、現在のサーバー エンドポイントの各サブフォルダーを、個別の専用の同期グループの専用のサーバー エンドポイントにすることです。 これにより、各サブフォルダーが個々の Azure ファイル共有に同期されるようになります。

Azure ファイル共有が見つかりません。

エラー コード
HRESULT 0x80c86030
HRESULT (10 進値) -2134351824
エラー文字列 ECS_E_AZURE_FILE_SHARE_NOT_FOUND
修復が必要か はい

このエラーは、Azure ファイル共有にアクセスできない場合に発生します。 トラブルシューティング方法は次のとおりです。

  1. ストレージ アカウントが存在することを確認します。
  2. Azure ファイル共有が存在することを確認します。

Azure ファイル共有が削除されている場合は、新しいファイル共有を作成してから同期グループを再作成する必要があります。

この Azure サブスクリプションが中断されている間は同期が一時停止されます。

エラー コード
HRESULT 0x80C83076
HRESULT (10 進値) -2134364042
エラー文字列 ECS_E_SYNC_BLOCKED_ON_SUSPENDED_SUBSCRIPTION
修復が必要か はい

このエラーは、Azure サブスクリプションが中断されている場合に発生します。 Azure サブスクリプションが復元されると、同期は再度有効になります。 詳細については、「私の Azure サブスクリプションが無効になっています。その理由と、再度有効にする方法を教えてください。」を参照してください。

ストレージ アカウントにファイアウォールまたは仮想ネットワークが構成されています。

エラー コード
HRESULT 0x80c8033e
HRESULT (10 進値) -2134375618
エラー文字列 ECS_E_SERVER_BLOCKED_BY_NETWORK_ACL
修復が必要か はい

このエラーは、ストレージ アカウントにファイアウォールがあるか、またはストレージ アカウントが仮想ネットワークに属しているという理由により、Azure ファイル共有にアクセスできない場合に発生します。 ストレージ アカウントに対するファイアウォールと仮想ネットワークの設定が適切に構成されていることを確認します。 詳細については、「ファイアウォールと仮想ネットワークの設定を構成する」を参照してください。

同期データベースの問題により、同期が失敗しました。

エラー コード
HRESULT 0x80c80219
HRESULT (10 進値) -2134375911
エラー文字列 ECS_E_SYNC_METADATA_WRITE_LOCK_TIMEOUT
修復が必要か いいえ

このエラーは通常、自動的に解決されます。これは次のような場合に発生する可能性があります。

  • 同期グループ内のサーバー全体でファイルの変更数が多い。
  • 個々のファイルやディレクトリでのエラーの数が多い。

このエラーが数時間を超えて続く場合は、サポート要求を作成してください。問題解決のために Microsoft からご連絡を差し上げます。

サーバーはセキュリティで保護された接続を確立できませんでした。クラウド サービスが予期しない証明書を受信しました。

エラー コード
HRESULT 0x800b0109
HRESULT (10 進値) -2146762487
エラー文字列 CERT_E_UNTRUSTEDROOT
修復が必要か はい

このエラーは、組織で TLS 終端プロキシを使用している場合、または悪意のあるエンティティがサーバーと Azure File Sync サービスの間のトラフィックをインターセプトしている場合に発生する可能性があります。 これが (組織で TLS 終端プロキシを使用しているため) 予測されることが確信できる場合は、レジストリのオーバーライドによって証明書の検証をスキップします。

  1. SkipVerifyingPinnedRootCertificate レジストリ値を作成します。

    New-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Azure\StorageSync -Name SkipVerifyingPinnedRootCertificate -PropertyType DWORD -Value 1
    
  2. 登録済みサーバー上で同期サービスを再起動します。

    Restart-Service -Name FileSyncSvc -Force
    

このレジストリ値を設定すると、Azure File Sync エージェントは、サーバーとクラウド サービスの間でデータを転送するときに、ローカルに信頼される TLS/SSL 証明書をすべて受け入れます。

サービスとの接続を確立できませんでした。

エラー コード
HRESULT 0x80072ee2
HRESULT (10 進値) -2147012894
エラー文字列 WININET_E_TIMEOUT
修復が必要か はい

このエラーは、サーバーから Azure File Sync サービスにアクセスできない場合に発生します。 次の手順を行うと、このエラーを解決できます。

  1. Windows サービス FileSyncSvc.exe がファイアウォールによってブロックされていないことを確認します。

  2. Azure File Sync サービスへの発信接続に対して、ポート 443 が開いていることを確認します。 この確認には、Test-NetConnection コマンドレットを使用します。 以下の <azure-file-sync-endpoint> プレースホルダーの URL については、Azure File Sync のプロキシとファイアウォールの設定に関するページを参照してください。

    Test-NetConnection -ComputerName <azure-file-sync-endpoint> -Port 443
    
  3. プロキシ構成が意図したとおりに設定されていることを確認します。 この確認には、Get-StorageSyncProxyConfiguration コマンドレットを使用します。 Azure File Sync のプロキシ構成の詳細については、Azure File Sync のプロキシとファイアウォールの設定に関するページを参照してください。

    $agentPath = "C:\Program Files\Azure\StorageSyncAgent"
    Import-Module "$agentPath\StorageSync.Management.ServerCmdlets.dll"
    Get-StorageSyncProxyConfiguration
    
  4. このサービス エンドポイントへのネットワーク接続を確認するには、Test-StorageSyncNetworkConnectivity コマンドレットを使用します。 詳細については、サービス エンドポイントへのネットワーク接続のテストに関するページを参照してください。

  5. ネットワーク接続のトラブルシューティングについてさらにサポートが必要な場合は、ネットワーク管理者に相談してください。

注意

Azure File Sync サービスへのネットワーク接続が復元されたとき、同期が直ちに再開されない可能性があります。 既定では、サーバー エンドポイントの場所で変更が検出されなかった場合、Azure File Sync は 30 分ごとに同期セッションを開始します。 同期セッションを強制的に実行するには、ストレージ同期エージェント (FileSyncSvc) サービスを再起動するか、サーバー エンドポイントの場所にあるファイルまたはディレクトリに変更を加えます。

サーバーが Azure File Sync サービスからの応答をデコードできなかったため同期に失敗しました

エラー コード
HRESULT 0x80072f8f
HRESULT (10 進値) -2147012721
エラー文字列 WININET_E_DECODING_FAILED
修復が必要か はい

このエラーは通常、ネットワーク プロキシによって Azure File Sync サービスからの応答が変更される場合に発生します。 プロキシの構成を確認してください。

認証の問題により、同期が失敗しました。

エラー コード
HRESULT 0x80c80300
HRESULT (10 進値) -2134375680
エラー文字列 ECS_E_SERVER_CREDENTIAL_NEEDED
修復が必要か はい

このエラーは、通常、サーバーの時刻が正しくないことが原因で発生します。 サーバーが仮想マシンで実行されている場合は、ホストの時刻が正しいことを確認してください。

証明書の有効期限が切れたため、同期が失敗しました。

エラー コード
HRESULT 0x80c83078
HRESULT (10 進値) -2134364040
エラー文字列 ECS_E_AUTH_SRV_CERT_EXPIRED
修復が必要か はい

このエラーは、認証に使用される証明書が期限切れであることが原因で発生します。

証明書が有効期限切れかどうか確認するには、次の手順を実行します。

  1. [証明書] MMC スナップインを開き、[コンピューター アカウント] を選択して、[証明書 (ローカル コンピューター)][個人][証明書] に移動します。
  2. クライアント認証証明書の有効期限が切れていないか確認します。

クライアント認証証明書の有効期限が切れている場合は、次の手順を実行して問題を解決します。

  1. Azure File Sync エージェント バージョン 4.0.1.0 以降がインストールされていることを確認します。

  2. サーバーで、次の PowerShell コマンドを実行します。

    Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>
    

認証証明書が見つからないため、同期が失敗しました。

エラー コード
HRESULT 0x80c80228
HRESULT (10 進値) -2134375896
エラー文字列 ECS_E_AUTH_SRV_CERT_NOT_FOUND
修復が必要か はい

このエラーは、認証に使用される証明書が見つからないことが原因で発生します。

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

  1. Azure File Sync エージェント バージョン 4.0.1.0 以降がインストールされていることを確認します。

  2. サーバーで、次の PowerShell コマンドを実行します。

    Reset-AzStorageSyncServerCertificate -ResourceGroupName <string> -StorageSyncServiceName <string>
    

認証 ID が見つからないため、同期が失敗しました。

エラー コード
HRESULT 0x80c83079
HRESULT (10 進値) -2134364039
エラー文字列 ECS_E_AUTH_IDENTITY_NOT_FOUND
修復が必要か はい

このエラーは、サーバー エンドポイントの削除が失敗し、エンドポイントが部分的に削除された状態になったことが原因で発生します。 この問題を解決するには、サーバー エンドポイントの削除を再試行します。

サーバー エンドポイントが配置されているボリュームのディスク領域が少なくなっています。

エラー コード
HRESULT 0x8e5e0211
HRESULT (10 進値) -1906441711
エラー文字列 JET_errLogDiskFull
修復が必要か はい
エラー コード
HRESULT 0x80c8031a
HRESULT (10 進値) -2134375654
エラー文字列 ECS_E_NOT_ENOUGH_LOCAL_STORAGE
修復が必要か はい

ボリュームのディスク領域が不足しているか、ディスクのクォータ制限に達したため、同期セッションはこれらのエラーのいずれかで失敗します。 このエラーは一般に、サーバー エンドポイントの外部のファイルによってボリューム上の領域が使い果たされていることが原因で発生します。 サーバー エンドポイントを追加するか、別のボリュームにファイルを移動するか、またはサーバー エンドポイントが配置されているボリュームのサイズを大きくして、ボリューム上の領域を解放します。 ファイル サーバー リソース マネージャーまたは NTFS クォータを使用してボリュームのディスク クォータが構成されている場合、クォータ制限を増やします。

サービスは、このサーバー エンドポイントと同期する準備がまだできていません。

エラー コード
HRESULT 0x80c8300f
HRESULT (10 進値) -2134364145
エラー文字列 ECS_E_REPLICA_NOT_READY
修復が必要か いいえ

このエラーは、Azure ファイル共有に既に存在するコンテンツを使用してクラウド エンドポイントが作成されたために発生します。 Azure File Sync は、サーバー エンドポイントに初期同期の続行を許可する前に、Azure ファイル共有ですべてのコンテンツをスキャンする必要があります。

多数の個別ファイルに問題があるため同期が失敗しました。

エラー コード
HRESULT 0x80c8023b
HRESULT (10 進値) -2134375877
エラー文字列 ECS_E_SYNC_METADATA_KNOWLEDGE_SOFT_LIMIT_REACHED
修復が必要か はい
エラー コード
HRESULT 0x80c8021c
HRESULT (10 進値) -2134375908
エラー文字列 ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED
修復が必要か はい
エラー コード
HRESULT 0x80c80253
HRESULT (10 進値) -2134375853
エラー文字列 ECS_E_TOO_MANY_PER_ITEM_ERRORS
修復が必要か はい

項目ごとのエラーで同期できないファイルが多数ある場合、同期セッションはこれらのエラーのいずれかで失敗します。 項目ごとのエラーを解決するには、「同期していない特定のファイルやフォルダーがあるかどうかを確認するにはどうすればよいですか。」の説明にある手順を実行してください。 同期エラー ECS_E_SYNC_METADATA_KNOWLEDGE_LIMIT_REACHED については、サポート ケースを開いてください。

注意

Azure File Sync は、1 日 1 回サーバー上で一時 VSS スナップショットを作成して、開くハンドルを含むファイルを同期します。

サーバー エンドポイントのパスの問題により、同期が失敗しました。

エラー コード
HRESULT 0x80c80019
HRESULT (10 進値) -2134376423
エラー文字列 ECS_E_SYNC_INVALID_PATH
修復が必要か はい

パスが存在し、ローカル NTFS ボリューム上にあって、再解析ポイントや既存のサーバー エンドポイントにはなっていないことを確認します。

フィルター ドライバーのバージョンとエージェントのバージョンに互換性がないため、同期が失敗しました

エラー コード
HRESULT 0x80C80277
HRESULT (10 進値) -2134375817
エラー文字列 ECS_E_INCOMPATIBLE_FILTER_VERSION
修復が必要か はい

このエラーは、読み込まれたクラウド階層化フィルター ドライバー (StorageSync.sys) のバージョンと、ストレージ同期エージェント (FileSyncSvc) サービスとの間に互換性がないために発生します。 Azure File Sync エージェントがアップグレードされた場合は、サーバーを再起動してインストールを完了します。 エラーが引き続き発生する場合は、エージェントをアンインストールし、サーバーを再起動して、Azure File Sync エージェントを再インストールします。

サービスは現在使用できません。

エラー コード
HRESULT 0x80c8004b
HRESULT (10 進値) -2134376373
エラー文字列 ECS_E_SERVICE_UNAVAILABLE
修復が必要か いいえ

このエラーは、Azure File Sync サービスを使用できないことが原因で発生します。 このエラーは、Azure File Sync サービスが再度使用可能になると自動的に解決されます。

注意

Azure File Sync サービスへのネットワーク接続が復元されたとき、同期が直ちに再開されない可能性があります。 既定では、サーバー エンドポイントの場所で変更が検出されなかった場合、Azure File Sync は 30 分ごとに同期セッションを開始します。 同期セッションを強制的に実行するには、ストレージ同期エージェント (FileSyncSvc) サービスを再起動するか、サーバー エンドポイントの場所にあるファイルまたはディレクトリに変更を加えます。

例外が発生したため、同期が失敗しました。

エラー コード
HRESULT 0x80131500
HRESULT (10 進値) -2146233088
エラー文字列 COR_E_EXCEPTION
修復が必要か いいえ

このエラーは、例外により同期が失敗したことが原因で発生します。 このエラーが数時間継続して発生する場合は、サポート要求を作成してください。

ストレージ アカウントが別のリージョンにフェールオーバーされたため、同期が失敗しました。

エラー コード
HRESULT 0x80c83073
HRESULT (10 進値) -2134364045
エラー文字列 ECS_E_STORAGE_ACCOUNT_FAILED_OVER
修復が必要か はい

このエラーは、ストレージ アカウントが別のリージョンにフェールオーバーされたことが原因で発生します。 Azure File Sync は、ストレージ アカウントのフェールオーバー機能をサポートしていません。 Azure File Sync でクラウド エンドポイントとして使用されている Azure ファイル共有を含むストレージ アカウントは、フェールオーバーしないでください。 それを行うと、同期の動作が停止し、新しく階層化されたファイルの場合は予期せずデータが失われる可能性があります。 この問題を解決するには、ストレージ アカウントをプライマリ リージョンに移動します。

同期データベースの一時的な問題により、同期が失敗しました。

エラー コード
HRESULT 0x80c8020e
HRESULT (10 進値) -2134375922
エラー文字列 ECS_E_SYNC_METADATA_WRITE_LEASE_LOST
修復が必要か いいえ

このエラーは、同期データベースに関する内部的な問題が原因で発生します。 このエラーは、同期の再試行時に自動的に解決されます。 このエラーが長期間にわたって続く場合は、サポート要求を作成してください。問題解決のために Microsoft からご連絡を差し上げます。

Azure Active Directory テナントでの変更が原因で同期が失敗しました

エラー コード
HRESULT 0x80c83088
HRESULT (10 進値) -2134364024
エラー文字列 ECS_E_INVALID_AAD_TENANT
修復が必要か はい

最新の Azure File Sync エージェントがあることを確認します。 エージェント V10 では、Azure File Sync で別の Azure Active Directory テナントへのサブスクリプションの移動がサポートされます。

最新のエージェント バージョンを入手したら、Microsoft.StorageSync アプリケーションにストレージ アカウントへのアクセス権を付与する必要があります (「Azure File Sync がストレージ アカウントへのアクセス権を持っていることを確認します」を参照してください)。

ファイアウォールと仮想ネットワークの例外が構成されていないことが原因で同期が失敗しました

エラー コード
HRESULT 0x80c83096
HRESULT (10 進値) -2134364010
エラー文字列 ECS_E_MGMT_STORAGEACLSBYPASSNOTSET
修復が必要か はい

このエラーは、ストレージ アカウントに対してファイアウォールと仮想ネットワークの設定が有効になっていて、[信頼された Microsoft サービスによるこのストレージ アカウントに対するアクセスを許可します] 例外のチェック ボックスがオンになっていない場合に発生します。 この問題を解決するには、デプロイ ガイドの「ファイアウォールと仮想ネットワークの設定を構成する」セクションに記載されている手順に従います。

システム ボリューム情報フォルダーのアクセス許可が正しくないため、同期が失敗しました。

エラー コード
HRESULT 0x80070005
HRESULT (10 進値) -2147024891
エラー文字列 ERROR_ACCESS_DENIED
修復が必要か はい

このエラーは、サーバー エンドポイントが配置されているボリューム上のシステム ボリューム情報フォルダーへのアクセス許可が NT AUTHORITY\SYSTEM アカウントにない場合に発生する可能性があります。 個々のファイルが ERROR_ACCESS_DENIED との同期に失敗する場合は、「ファイル/ディレクトリ単位の同期エラーのトラブルシューティング」セクションに記載されている手順を実行してください。

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

  1. Psexec ツールをダウンロードします。
  2. 管理者特権でのコマンド プロンプトから次のコマンドを実行して、システム アカウントを使用してコマンド プロンプトを起動します。PsExec.exe -i -s -d cmd
  3. システム アカウントで実行されているコマンド プロンプトから次のコマンドを実行して、NT AUTHORITY\SYSTEM アカウントからシステム ボリューム情報フォルダーにアクセスできないことを確認します。cacls "drive letter:\system volume information" /T /C
  4. NT AUTHORITY\SYSTEM アカウントからシステム ボリューム情報フォルダーにアクセスできない場合は、次のコマンドを実行します。cacls "drive letter:\system volume information" /T /E /G "NT AUTHORITY\SYSTEM:F"
    • アクセス拒否により手順 #4 が失敗した場合は、次のコマンドを実行して、システム ボリューム情報フォルダーの所有権を取得し、その後、手順 #4 を繰り返します。takeown /A /R /F "drive letter:\System Volume Information"

Azure ファイル共有が削除されて再作成されたため、同期に失敗しました。

エラー コード
HRESULT 0x80c8027e
HRESULT (10 進値) -2134375810
エラー文字列 ECS_E_SYNC_REPLICA_ROOT_CHANGED
修復が必要か はい

このエラーは、Azure File Sync では同じ同期グループ内の Azure ファイル共有の削除と再作成がサポートされていないために発生します。

この問題を解決するには、次の手順のようにして、同期グループを削除して再作成します。

  1. 同期グループ内のすべてのサーバー エンドポイントを削除します。
  2. クラウド エンドポイントを削除します。
  3. 同期グループを削除します。
  4. サーバー エンドポイントでクラウドを使った階層化が有効になっていた場合は、「サーバー エンドポイントを削除した後、サーバー上で階層化されたファイルにアクセスできない」セクションの手順を実行して、サーバー上の孤立した階層化ファイルを削除します。
  5. 同期グループを作成し直します。

レプリカが古い状態に復元されたことが同期によって検出されました

エラー コード
HRESULT 0x80c80254
HRESULT (10 進値) -2134375852
エラー文字列 ECS_E_SYNC_REPLICA_BACK_IN_TIME
修復が必要か いいえ

必要な操作はありません。 このエラーは、レプリカが古い状態に復元されたことが同期によって検出されたために発生します。 同期は調整モードになり、Azure ファイル共有の内容とサーバー エンドポイントのデータをマージして、同期関係を再作成します。 調整モードがトリガーされた場合、名前空間のサイズによってはプロセスに非常に時間がかかることがあります。 通常の同期は、調整が完了するまで発生しません。また、Azure ファイル共有とサーバー エンドポイントの間でファイルが異なると (最終変更時刻またはサイズ)、ファイルの競合が発生します。

HTTP 要求がリダイレクトされたため、同期に失敗しました

エラー コード
HRESULT 0x80190133
HRESULT (10 進値) -2145844941
エラー文字列 HTTP_E_STATUS_REDIRECT_KEEP_VERB
修復が必要か はい

このエラーは、Azure File Sync が HTTP リダイレクトをサポートしていないために発生します (3xx 状態コード)。 この問題を解決するには、プロキシ サーバーまたはネットワーク デバイスで HTTP リダイレクトを無効にします。

オフラインのデータ転送中にタイムアウトが発生したものの、まだ進行中である。

エラー コード
HRESULT 0x80c83085
HRESULT (10 進値) -2134364027
エラー文字列 ECS_E_DATA_INGESTION_WAIT_TIMEOUT
修復が必要か いいえ

このエラーは、データ インジェスト操作のタイムアウト期間が経過したときに発生します。 同期が進行中である (AppliedItemCount が 0 より大きい) 場合、このエラーは無視してもかまいません。 「現在の同期セッションの進行状況を監視するにはどうすればよいですか。」を参照してください。

サーバーでサーバー エンドポイント パスが見つからないため、同期に失敗しました。

エラー コード
HRESULT 0x80c8027a
HRESULT (10 進値) -2134375814
エラー文字列 ECS_E_SYNC_ROOT_DIRECTORY_NOT_FOUND
修復が必要か はい

このエラーは、サーバー エンドポイント パスとして使用されているディレクトリの名前が変更または削除されている場合に発生します。 ディレクトリの名前が変更されている場合は、ディレクトリの名前を元の名前に戻し、ストレージ同期エージェント サービス (FileSyncSvc) を再起動します。

ディレクトリが削除されている場合は、次の手順を実行して既存のサーバー エンドポイントを削除し、新しいパスを使用して新しいサーバー エンドポイントを作成します。

  1. サーバー エンドポイントを削除する」に記載されている手順に従って、同期グループのサーバー エンドポイントを削除します。
  2. サーバー エンドポイントを追加する」に記載されている手順に従って、同期グループに新しいサーバー エンドポイントを作成します。

サーバーのパスが空であるため、サーバー エンドポイントのプロビジョニングに失敗しました。

エラー コード
HRESULT 0x80C80299
HRESULT (10 進値) -2134375783
エラー文字列 ECS_E_SYNC_AUTHORITATIVE_UPLOAD_EMPTY_SET
修復が必要か はい

次の条件が満たされた場合、サーバー エンドポイントのプロビジョニングがこのエラー コードで失敗します。

  • このサーバー エンドポイントは、初期同期モードであるサーバー権限を使用してプロビジョニングされている。
  • ローカル サーバー パスが空であるか、同期できると認識される項目が含まれていない。

このプロビジョニング エラーにより、Azure ファイル共有で使用できる可能性があるすべてのコンテンツが削除されることがなくなります。 サーバー権限のアップロードは、サーバーの場所からの更新を使用して、既にシードされたクラウドの場所をキャッチアップするための特別なモードです。 このモードが作成されたシナリオについて理解するには、この移行ガイドを参照してください。

  1. サーバー エンドポイントを削除する」に記載されている手順に従って、同期グループのサーバー エンドポイントを削除します。
  2. サーバー エンドポイントを追加する」に記載されている手順に従って、同期グループに新しいサーバー エンドポイントを作成します。

一般的なトラブルシューティング手順

ストレージ アカウントが存在することを確認します。

  1. ストレージ同期サービス内で同期グループに移動します。
  2. 同期グループ内でクラウド エンドポイントを選択します。
  3. 開いているウィンドウ内の Azure ファイル共有名をメモします。
  4. リンクされているストレージ アカウントを選択します。 このリンクが失敗する場合は、参照されているストレージ アカウントが削除されています。 ストレージ アカウントへのリンクが表示されたクラウド エンドポイントの詳細ウィンドウを示すスクリーンショット

Azure ファイル共有が存在することを確認します。

  1. 左側の目次で [概要] をクリックして、ストレージ アカウントのメイン ページに戻ります。
  2. [ファイル] を選択して、ファイル共有の一覧を表示します。
  3. クラウド エンドポイントによって参照されているファイル共有 (上の手順 1 でメモしたもの) がファイル共有の一覧に表示されていることを確認します。

Azure File Sync がストレージ アカウントへのアクセス権を持っていることを確認します。

  1. 左側の目次で [アクセス制御 (IAM)] をクリックします。

  2. [ロールの割り当て] タブをクリックして、ストレージ アカウントにアクセスできるユーザーとアプリケーション (サービス プリンシパル) を一覧表示します。

  3. Microsoft.StorageSync または ハイブリッド ファイル同期サービス (古いアプリケーション名) が一覧に 閲覧者とデータ アクセス ロールで表示されるか確認します。

    ストレージ アカウントのアクセス制御タブに表示された [Hybrid File Sync Service](ハイブリッド ファイル同期サービス) サービス プリンシパルのスクリーンショット

    Microsoft.StorageSync または ハイブリッド ファイル同期サービス が一覧の表示されない場合は、次の手順を行います。

    • [追加] をクリックします。
    • [ロール] フィールドで、 [閲覧者とデータ アクセス] を選択します。
    • [選択] フィールドに「Microsoft.StorageSync」と入力してロールを選択し、 [保存] をクリックします。

クラウドの階層化

クラウドの階層化の障害パスは 2 つあります。

  • ファイルを階層化できないことがあります。これは、Azure File Sync がファイルを Azure Files に階層化しようとして失敗することを意味します。
  • ファイルを再呼び出しできないことがあります。これは、ユーザーが階層化されたファイルにアクセスしようとしたときに、Azure File Sync ファイル システム フィルター (StorageSync.sys) がデータのダウンロードに失敗することを意味します。

いずれかの障害パスで発生する可能性がある障害には 2 つの主要なクラスがあります。

  • クラウド ストレージの障害
    • "一時的なストレージ サービスの可用性の問題"。 詳しくは、Azure Storage のサービス レベル アグリーメント (SLA) に関するページをご覧ください。
    • "アクセスできない Azure ファイル共有"。 この障害は通常、Azure ファイル共有がまだ同期グループ内のクラウド エンドポイントであるときにこれを削除した場合に発生します。
    • "アクセスできないストレージ アカウント"。 この障害は通常、同期グループ内のクラウド エンドポイントである Azure ファイル共有がまだあるときにストレージ アカウントを削除した場合に発生します。
  • サーバーの障害
    • "Azure File Sync ファイル システム フィルター (StorageSync.sys) が読み込まれていない"。 階層化/再呼び出し要求に応答するためには、Azure File Sync ファイル システム フィルターが読み込まれている必要があります。 フィルターが読み込まれない理由はいくつかありますが、最も一般的な理由は、管理者が手動でアンロードしたことです。 Azure File Sync が正常に機能するためには、Azure File Sync ファイル システム フィルターが常に読み込まれている必要があります。
    • "不足、破損、切断している再解析ポイント"。 再解析ポイントは、ファイルの特別なデータ構造であり、次の 2 つの部分で構成されています。
      1. Azure File Sync ファイル システム フィルター (StorageSync.sys) がファイルへの IO になんらかのアクションを行う必要があることをオペレーティング システムに示す再解析タグ。

      2. 関連付けられているクラウド エンドポイント (Azure ファイル共有) 上のファイルの URI をファイル システムがフィルターすることを示す再解析データ。

        再解析ポイントが破損する最も一般的な原因は、管理者がタグまたはそのデータを変更しようとしたことです。

    • "ネットワーク接続性の問題"。 ファイルを階層化または再呼び出しするには、サーバーにインターネット接続が必要です。

次の各セクションでは、クラウド階層化の問題のトラブルシューティングを行い、問題がクラウド ストレージの問題かサーバーの問題かを確認する方法を示します。

サーバー上の階層化アクティビティを監視する方法

サーバー上の階層化アクティビティを監視するには、テレメトリ イベント ログ (イベント ビューアーの [アプリケーションとサービス][Microsoft][FileSync][Agent] の下) にあるイベント ID 9003、9016、9029 を使用します。

  • イベント ID 9003 は、サーバー エンドポイントのエラー分布を示します。 たとえば、Total Error Count、ErrorCode などです。エラー コードごとに 1 つのイベントがログ記録されます。
  • イベント ID 9016 は、ボリュームの非実体化の結果を示します。 たとえば、空き領域の割合、セッション内の非実体化されたファイルの数、非実体化が失敗したファイルの数などです。
  • イベント ID 9029 では、サーバー エンドポイントの非実体化セッション情報が提供されます。 たとえば、セッション内の試行されたファイルの数、セッション内の階層化されたファイルの数、既に階層化されているファイルの数などです。

サーバー上の呼び戻しアクティビティを監視する方法

サーバー上の呼び戻しアクティビティを監視するには、テレメトリ イベント ログ (イベント ビューアーの [アプリケーションとサービス][Microsoft][FileSync][Agent] の下) にあるイベント ID 9005、9006、9009、9059 を使用します。

  • イベント ID 9005 は、サーバー エンドポイントの呼び戻しの信頼性を示します。 たとえば、アクセスされた一意のファイルの合計数、アクセスが失敗した一意のファイルの合計数などです。
  • イベント ID 9006 は、サーバー エンドポイントの呼び戻しエラーの分布を示します。 たとえば、失敗した要求の合計数、ErrorCode などです。エラー コードごとに 1 つのイベントがログ記録されます。
  • イベント ID 9009 では、サーバー エンドポイントの呼び戻しセッション情報が提供されます。 たとえば、DurationSeconds、CountFilesRecallSucceeded、CountFilesRecallFailed などです。
  • イベント ID 9059 では、サーバー エンドポイントのアプリケーション呼び戻し分布が提供されます。 たとえば、ShareId、Application Name、TotalEgressNetworkBytes です。

階層化に失敗するファイルのトラブルシューティングを行う方法

ファイルが Azure ファイルへの階層化に失敗する場合:

  1. イベント ビューアーで、[アプリケーションとサービス][Microsoft][FileSync][Agent] の下にあるテレメトリ ログ、操作イベント ログ、および診断イベント ログをレビューします。
    1. ファイルが Azure ファイル共有に存在することを確認します。

      注意

      階層化の前に、ファイルが Azure ファイル共有と同期されている必要があります。

    2. サーバーがインターネットに接続できることを確認します。

    3. Azure File Sync フィルター ドライバー (StorageSync.sys と StorageSyncGuard.sys) が実行されていることを確認します。

      • 管理者特権でのコマンド プロンプトで、fltmc を実行します。 ファイル システム フィルター ドライバーの StorageSync.sys と StorageSyncGuard.sys が表示されることを確認します。

注意

イベント ID 9003 は、ファイルの階層化が失敗した場合に、テレメトリ イベント ログに 1 時間に 1 回ログ記録されます (エラー コードごとに 1 つのイベントがログ記録されます)。 「階層化エラーと修復」セクションを参照して、エラー コードに対する修復手順が示されているかどうかを確認します。

階層化エラーと修復

HRESULT HRESULT (10 進値) エラー文字列 問題 Remediation
0x80c86045 -2134351803 ECS_E_INITIAL_UPLOAD_PENDING 初期アップロードが進行中のため、ファイルを階層化できませんでした。 必要なアクションはありません。 初期アップロードが完了したら、ファイルは階層化されます。
0x80c86043 -2134351805 ECS_E_GHOSTING_FILE_IN_USE ファイルは使用中のため、階層化できませんでした。 必要なアクションはありません。 ファイルは使用されなくなると階層化されます。
0x80c80241 -2134375871 ECS_E_GHOSTING_EXCLUDED_BY_SYNC ファイルは同期によって除外されているため、階層化できませんでした。 必要なアクションはありません。 同期除外リスト内のファイルは階層化できません。
0x80c86042 -2134351806 ECS_E_GHOSTING_FILE_NOT_FOUND ファイルはサーバー上で見つからなかったため、階層化できませんでした。 必要なアクションはありません。 エラーが引き続き発生する場合は、ファイルがサーバー上に存在するかどうかを確認します。
0x80c83053 -2134364077 ECS_E_CREATE_SV_FILE_DELETED ファイルは Azure ファイル共有で削除されたため、階層化できませんでした。 必要なアクションはありません。 ファイルは、次のダウンロード同期セッションが実行されたときにサーバー上で削除されるはずです。
0x80c8600e -2134351858 ECS_E_AZURE_SERVER_BUSY ネットワークの問題が発生したため、ファイルを階層化できませんでした。 必要なアクションはありません。 エラーが引き続き発生する場合は、Azure ファイル共有へのネットワーク接続を確認します。
0x80072ee7 -2147012889 WININET_E_NAME_NOT_RESOLVED ネットワークの問題が発生したため、ファイルを階層化できませんでした。 必要なアクションはありません。 エラーが引き続き発生する場合は、Azure ファイル共有へのネットワーク接続を確認します。
0x80070005 -2147024891 ERROR_ACCESS_DENIED アクセス拒否エラーが発生したため、ファイルを階層化できませんでした。 このエラーは、ファイルが DFS-R 読み取り専用レプリケーション フォルダーにある場合に発生することがあります。 Azure Files Sync は DFS-R 読み取り専用レプリケーション フォルダーにおけるサーバー エンドポイントをサポートしません。 詳細については、計画ガイドを参照してください。
0x80072efe -2147012866 WININET_E_CONNECTION_ABORTED ネットワークの問題が発生したため、ファイルを階層化できませんでした。 必要なアクションはありません。 エラーが引き続き発生する場合は、Azure ファイル共有へのネットワーク接続を確認します。
0x80c80261 -2134375839 ECS_E_GHOSTING_MIN_FILE_SIZE ファイルのサイズがサポートされているサイズを下回っているため、ファイルを階層化できませんでした。 エージェントのバージョンが 9.0 未満の場合、サポートされるファイルの最小サイズは 64 KiB です。 エージェントのバージョンが 9.0 以降の場合、サポートされるファイルの最小サイズは、ファイル システムのクラスター サイズ (ファイル システム クラスターのサイズの倍) に基づきます。 たとえば、ファイル システム クラスターのサイズが 4 KiB の場合、ファイルの最小サイズは 8 KiB です。
0x80c83007 -2134364153 ECS_E_STORAGE_ERROR Azure Storage の問題が発生したため、ファイルを階層化できませんでした。 エラーが解決しない場合は、サポート リクエストを開いてください。
0x800703e3 -2147023901 ERROR_OPERATION_ABORTED ファイルは同時に呼び戻しされたため、階層化できませんでした。 必要なアクションはありません。 このファイルは、呼び戻しが完了し、ファイルが使用中でなくなると階層化されます。
0x80c80264 -2134375836 ECS_E_GHOSTING_FILE_NOT_SYNCED ファイルは Azure ファイル共有と同期されていないため、階層化できませんでした。 必要なアクションはありません。 ファイルは、Azure ファイル共有と同期されると階層化されます。
0x80070001 -2147942401 ERROR_INVALID_FUNCTION クラウドの階層化フィルター ドライバー (storagesync.sys) が実行されていないため、ファイルを階層化できませんでした。 この問題を解決するには、管理者特権でコマンド プロンプトを開き、次のコマンドを実行します: fltmc load storagesync
fltmc コマンドの実行時に Azure File Sync フィルター ドライバーの読み込みが失敗する場合は、Azure File Sync エージェントをアンインストールし、サーバーを再起動し、Azure File Sync エージェントを再インストールします。
0x80070070 -2147024784 ERROR_DISK_FULL サーバー エンドポイントが配置されているボリュームのディスク領域が不足しているため、ファイルを階層化できませんでした。 この問題を解決するには、サーバー エンドポイントが配置されているボリューム上で、少なくとも 100 MiB のディスク領域を解放します。
0x80070490 -2147023728 ERROR_NOT_FOUND ファイルは Azure ファイル共有と同期されていないため、階層化できませんでした。 必要なアクションはありません。 ファイルは、Azure ファイル共有と同期されると階層化されます。
0x80c80262 -2134375838 ECS_E_GHOSTING_UNSUPPORTED_RP ファイルはサポートされていない再解析ポイントであるため、階層化できませんでした。 ファイルがデータ重複除去の再解析ポイントである場合は、計画ガイドの手順に従って、データ重複除去のサポートを有効にします。 データ重複除去以外の再解析ポイントを含むファイルはサポートされておらず、階層化されません。
0x80c83052 -2134364078 ECS_E_CREATE_SV_STREAM_ID_MISMATCH ファイルは変更されているため、階層化できませんでした。 必要なアクションはありません。 ファイルは、変更されたファイルが Azure ファイル共有と同期されると階層化されます。
0x80c80269 -2134375831 ECS_E_GHOSTING_REPLICA_NOT_FOUND ファイルは Azure ファイル共有と同期されていないため、階層化できませんでした。 必要なアクションはありません。 ファイルは、Azure ファイル共有と同期されると階層化されます。
0x80072ee2 -2147012894 WININET_E_TIMEOUT ネットワークの問題が発生したため、ファイルを階層化できませんでした。 必要なアクションはありません。 エラーが引き続き発生する場合は、Azure ファイル共有へのネットワーク接続を確認します。
0x80c80017 -2134376425 ECS_E_SYNC_OPLOCK_BROKEN ファイルは変更されているため、階層化できませんでした。 必要なアクションはありません。 ファイルは、変更されたファイルが Azure ファイル共有と同期されると階層化されます。
0x800705aa -2147023446 ERROR_NO_SYSTEM_RESOURCES システム リソースが不足しているため、ファイルを階層化できませんでした。 エラーが引き続き発生する場合は、どのアプリケーションまたはカーネル モード ドライバーがシステム リソースを消費しているかを調べます。
0x8e5e03fe -1906441218 JET_errDiskIO クラウドを使った階層化のデータベースへの書き込み中に I/O エラーが発生したため、ファイルを階層化できませんでした。 エラーが引き続き発生する場合は、ボリュームで chkdsk を実行して、ストレージのハードウェアを確認してください。
0x8e5e0442 -1906441150 JET_errInstanceUnavailable クラウドを使った階層化のデータベースが実行されていないため、ファイルを階層化できませんでした。 この問題を解決するには、FileSyncSvc サービスまたはサーバーを再起動します。 エラーが引き続き発生する場合は、ボリュームで chkdsk を実行して、ストレージのハードウェアを確認してください。
0x80C80285 -2160591493 ECS_E_GHOSTING_SKIPPED_BY_CUSTOM_EXCLUSION_LIST ファイルの種類が階層化から除外されているため、ファイルを階層化できません。 このファイルの種類でファイルを階層化するには、HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Azure\StorageSync の下にある GhostingExclusionList レジストリ設定を変更します。
0x80C86050 -2160615504 ECS_E_REPLICA_NOT_READY_FOR_TIERING 現在の同期モードが初期アップロードまたは調整であるため、ファイルの階層化に失敗しました。 必要なアクションはありません。 同期の初期アップロードまたは調整が完了すると、ファイルは階層化されます。

再呼び出しに失敗するファイルのトラブルシューティングを行う方法

ファイルが再呼び出しに失敗する場合:

  1. イベント ビューアーで、[アプリケーションとサービス][Microsoft][FileSync][Agent] の下にあるテレメトリ ログ、操作イベント ログ、および診断イベント ログをレビューします。
    1. ファイルが Azure ファイル共有に存在することを確認します。
    2. サーバーがインターネットに接続できることを確認します。
    3. サービス MMC スナップインを開き、Storage 同期エージェント サービス (FileSyncSvc) が実行されていることを確認します。
    4. Azure File Sync フィルター ドライバー (StorageSync.sys と StorageSyncGuard.sys) が実行されていることを確認します。
      • 管理者特権でのコマンド プロンプトで、fltmc を実行します。 ファイル システム フィルター ドライバーの StorageSync.sys と StorageSyncGuard.sys が表示されることを確認します。

注意

イベント ID 9006 は、ファイルの呼び戻しが失敗した場合に、テレメトリ イベント ログに 1 時間に 1 回ログ記録されます (エラー コードごとに 1 つのイベントがログ記録されます)。 「呼び戻しエラーと修復」セクションを確認して、エラー コードに対する修復手順が一覧表示されているかどうかを確認します。

呼び戻しエラーと修復

HRESULT HRESULT (10 進値) エラー文字列 問題 Remediation
0x80070079 -2147942521 ERROR_SEM_TIMEOUT I/O タイムアウトのため、ファイルの呼び戻しに失敗しました。 この問題は、サーバー リソースの制約、ネットワーク接続の低下、または Azure Storage の問題 (調整など) といったいくつかの理由によって発生する可能性があります。 必要なアクションはありません。 エラーが数時間継続して発生する場合は、サポート ケースを開いてください。
0x80070036 -2147024842 ERROR_NETWORK_BUSY ネットワークの問題が発生したため、ファイルの呼び戻しに失敗しました。 エラーが引き続き発生する場合は、Azure ファイル共有へのネットワーク接続を確認します。
0x80c80037 -2134376393 ECS_E_SYNC_SHARE_NOT_FOUND サーバー エンドポイントが削除されたため、ファイルの呼び戻しに失敗しました。 この問題を解決する方法は、「サーバー エンドポイントを削除した後、サーバー上で階層化されたファイルにアクセスできない」を参照してください。
0x80070005 -2147024891 ERROR_ACCESS_DENIED アクセス拒否エラーが発生したため、ファイルの呼び戻しに失敗しました。 この問題は、ストレージ アカウントでファイアウォールと仮想ネットワークの設定が有効になっていて、サーバーにそのストレージ アカウントへのアクセス権がない場合に発生します。 この問題を解決するには、デプロイ ガイドの「ファイアウォールと仮想ネットワークの設定を構成する」セクションに記載されている手順に従い、サーバー IP アドレスまたは仮想ネットワークを追加します。
0x80c86002 -2134351870 ECS_E_AZURE_RESOURCE_NOT_FOUND Azure ファイル共有にアクセスできないため、ファイルの呼び戻しに失敗しました。 この問題を解決するには、ファイルが Azure ファイル共有に存在することを確認します。 ファイルが Azure ファイル共有に存在する場合は、最新の Azure File Sync エージェントのバージョンにアップグレードします。
0x80c8305f -2134364065 ECS_E_EXTERNAL_STORAGE_ACCOUNT_AUTHORIZATION_FAILED ストレージ アカウントへの承認エラーが発生したため、ファイルの呼び戻しに失敗しました。 この問題を解決するには、Azure File Sync にストレージ アカウントへのアクセス権があることを確認します。
0x80c86030 -2134351824 ECS_E_AZURE_FILE_SHARE_NOT_FOUND Azure ファイル共有にアクセスできないため、ファイルの呼び戻しに失敗しました。 ファイル共有が存在し、アクセス可能であることを確認します。 ファイル共有が削除され、再作成された場合は、「Azure ファイル共有が削除されて再作成されたため、同期に失敗しました」セクションに記載されている手順を行い、同期グループを削除して再作成します。
0x800705aa -2147023446 ERROR_NO_SYSTEM_RESOURCES システム リソースが不足しているため、ファイルの呼び戻しに失敗しました。 エラーが引き続き発生する場合は、どのアプリケーションまたはカーネル モード ドライバーがシステム リソースを消費しているかを調べます。
0x8007000e -2147024882 ERROR_OUTOFMEMORY メモリが不足しているため、ファイルの呼び戻しに失敗しました。 エラーが引き続き発生する場合は、メモリ不足の原因になっているアプリケーションまたはカーネル モード ドライバーを調べます。
0x80070070 -2147024784 ERROR_DISK_FULL ディスク領域が不足しているため、ファイルの呼び戻しに失敗しました。 この問題を解決するには、ファイルを別のボリュームに移動することでボリュームの領域を解放するか、ボリュームのサイズを増やすか、または Invoke-StorageSyncCloudTiering コマンドレットを使用することでファイルを強制的に階層化します。
0x80072f8f -2147012721 WININET_E_DECODING_FAILED サーバーが Azure File Sync サービスからの応答をデコードできなかったため、ファイルの再呼び出しに失敗しました。 このエラーは通常、ネットワーク プロキシによって Azure File Sync サービスからの応答が変更される場合に発生します。 プロキシの構成を確認してください。
0x80090352 -2146892974 SEC_E_ISSUING_CA_UNTRUSTED 組織で TLS 終端プロキシを使用しているか、または悪意のあるエンティティがサーバーと Azure File Sync サービスの間のトラフィックをインターセプトしているため、ファイルの再呼び出しに失敗しました。 これが予想される場合 (組織が TLS 終端プロキシを使用している場合)、エラー CERT_E_UNTRUSTEDROOT に記載されている手順に従って、この問題を解決します。
0x80c86047 -2134351801 ECS_E_AZURE_SHARE_SNAPSHOT_NOT_FOUND ファイルは、Azure ファイル共有に存在しなくなったバージョンのファイルを参照しているので、再呼び出しに失敗しました。 この問題は、階層化されたファイルが Windows Server のバックアップから復元された場合に発生する可能性があります。 この問題を解決するには、Azure ファイル共有にあるスナップショットからファイルを復元します。

サーバー エンドポイントを削除した後、サーバー上で階層化されたファイルにアクセスできない

サーバーのエンドポイントを削除する前にファイルが再呼び出しされない場合、サーバー上の階層化ファイルはアクセスできなくなります。

階層化されたファイルにアクセスできない場合にログに記録されるエラー

  • ファイルを同期すると、エラー コード -2147942467 (0x80070043 - ERROR_BAD_NET_NAME) が ItemResults イベント ログに記録されます。
  • ファイルを再呼び出しすると、エラー コード -2134376393 (0x80c80037 - ECS_E_SYNC_SHARE_NOT_FOUND) が RecallResults イベント ログに記録されます。

次の条件が満たされている場合、階層化されたファイルへのアクセスを復元できます。

  • 過去 30 日以内にサーバー エンドポイントが削除されました
  • クラウド エンドポイントは削除されませんでした
  • ファイル共有は削除されませんでした
  • 同期グループは削除されませんでした

上記の条件が満たされる場合、30 日以内に同じ同期グループ内のサーバー上の同じパスにサーバー エンドポイントを再作成することで、サーバー上のファイルへのアクセスを復元できます。

上記の条件が満たされない場合、サーバー上の階層化されたファイルが孤立しているため、アクセスを復元することはできません。 次の手順に従って、孤立した階層化ファイルを削除します。

メモ

  • 階層化されたファイルにサーバーでアクセスできない場合でも、Azure ファイル共有に直接アクセスするなら、完全なファイルにアクセスできます。
  • 今後、階層化されたファイルの孤立を防ぐには、サーバーエンド ポイントを削除するとき、「サーバー エンドポイントを削除する」に記載されている手順に従ってください。

孤立した階層化ファイルの一覧を取得する方法

  1. Azure File Sync エージェント バージョン v5.1 以降がインストールされていることを確認します。
  2. 次の PowerShell コマンドを実行すると、孤立した階層化ファイルが一覧表示されます。
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
  1. ファイルの削除後、バックアップから復元する必要がある場合、OrphanTieredFiles.txt 出力ファイルを保存してください。

孤立した階層化ファイルを削除する方法

オプション 1: 孤立した階層化ファイルを削除する

このオプションでは、Windows Server 上で孤立している階層化ファイルが削除されますが、サーバー エンドポイントが 30 日後の再作成に起因して存在する場合、あるいは異なる同期グループに接続されている場合、サーバー エンドポイントを削除する必要があります。 サーバー エンドポイントが再作成される前に Windows Server または Azure ファイル共有でファイルが更新された場合、ファイル競合が発生します。

  1. Azure File Sync エージェント バージョン v5.1 以降がインストールされていることを確認します。
  2. Azure ファイル共有とサーバー エンドポイントの場所をバックアップします。
  3. 同期グループにサーバー エンドポイントが存在する場合、「サーバー エンドポイントを削除する」に記載されている手順でそれを削除します。

警告

Remove-StorageSyncOrphanedTieredFiles コマンドレットを使用する前にサーバー エンドポイントが削除されていない場合、サーバー上で孤立している階層化ファイルを削除すると、Azure ファイル共有で完全なファイルが削除されます。

  1. 次の PowerShell コマンドを実行すると、孤立した階層化ファイルが一覧表示されます。
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
$orphanFiles = Get-StorageSyncOrphanedTieredFiles -path <server endpoint path>
$orphanFiles.OrphanedTieredFiles > OrphanTieredFiles.txt
  1. ファイルの削除後、バックアップから復元する必要がある場合、OrphanTieredFiles.txt 出力ファイルを保存してください。
  2. 次の 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 ファイル共有と同期していない場合、ファイルは削除されます。
  • アクセス可能な (孤立していない) 階層化ファイルは削除されません。
  • 階層化されていないファイルはサーバーに残ります。
  1. 省略可能:手順 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
  1. OrphanTieredFiles.txt 出力ファイルを使用し、サーバー上で孤立している階層化ファイルを特定します。
  2. Azure ファイル共有から Windows Server に完全なファイルをコピーすることで、孤立した階層化ファイルを上書きします。

サーバーで予期せず呼び戻されるファイルのトラブルシューティング方法

ウイルス対策、バックアップ、および多数のファイルを読み取るその他のアプリケーションは、オフライン スキップ属性を尊重してそれらのファイルのコンテンツの読み取りをスキップする場合を除いて、意図しない再呼び出しの原因となります。 オフライン ファイルをスキップするオプションをサポートしている製品でスキップを実行すると、ウィルス対策スキャンやバックアップ ジョブなどの操作中の意図しない再呼び出しを回避できます。

オフライン ファイルの読み取りをスキップするようにソリューションを構成する方法については、ソフトウェア ベンダーにお問い合わせください。

意図しない呼び出しは、ファイル エクスプローラーでファイルを参照する場合などの他のシナリオで発生することもあります。 サーバー上でクラウド階層化されたファイルがあるフォルダーをファイル エクスプローラーで開くと、意図しない再呼び出しが発生することがあります。 ウイルス対策ソリューションがサーバーで有効になっている場合よりも、こちらのほうが発生する可能性が高まります。

注意

テレメトリ イベント ログでイベント ID 9059 を使用して、呼び戻しの原因となっているアプリケーションを特定します。 このイベントは、サーバー エンドポイントのアプリケーション呼び戻し分布を提供し、1 時間に 1 回ログに記録されます。

Azure File Sync のプロセスの除外

Azure File Sync によってアクセスされるファイルのスキャンをスキップするようにウイルス対策または他のアプリケーションを構成する場合は、次に示すプロセスの除外を構成します。

  • 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 File Sync には TLS 1.2 が必要

サーバーで TLS 設定を表示するには、レジストリ設定を参照します。

プロキシを使用している場合は、プロキシのドキュメントを参照し、TLS 1.2 を使用するように構成されていることを確実にします。

一般的なトラブルシューティング

サーバーで Azure File Sync の問題が発生する場合は、次の手順を完了します。

  1. イベント ビューアーで、テレメトリ イベント ログ、操作イベント ログ、および診断イベント ログをレビューします。
    • 同期、階層化、および再呼び出しの問題は、[アプリケーションとサービス][Microsoft][FileSync][Agent] の下のテレメトリ イベント ログ、診断イベント ログ、および操作イベント ログに記録されます。
    • サーバーの管理 (構成設定など) に関連する問題は、Applications と Services\Microsoft\FileSync\Management の下の診断イベント ログと操作イベント ログに記録されます。
  2. Azure File Sync サービスがサーバーで実行されていることを確認します。
    • サービスの MMC スナップインを開き、ストレージ同期エージェント サービス (FileSyncSvc) が実行されていることを確認します。
  3. Azure File Sync フィルター ドライバー (StorageSync.sys と StorageSyncGuard.sys) が実行されていることを確認します。
    • 管理者特権でのコマンド プロンプトで、fltmc を実行します。 ファイル システム フィルター ドライバーの StorageSync.sys と StorageSyncGuard.sys が表示されることを確認します。

問題が解決されない場合は、AFSDiag ツールを実行し、その .zip ファイルの出力を、ケースに割り当てられたサポート エンジニアに送信して、さらに詳しい診断を依頼します。

AFSDiag を実行するには、次の手順に従います。

エージェント バージョン v11 以降の場合:

  1. 管理者特権で PowerShell ウィンドウを開き、次のコマンドを実行します (各コマンドの後で Enter キーを押します)。

    注意

    AFSDiag はログを収集する前に、出力ディレクトリとその中の一時フォルダーを作成し、実行後に一時フォルダーを削除します。 データが含まれていない出力場所を指定してください。

    cd "c:\Program Files\Azure\StorageSyncAgent"
    Import-Module .\afsdiag.ps1
    Debug-AFS -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
    
  2. 問題を再現します。 操作が終了したら、 [D] を入力します。

  3. ログファイルとトレース ファイルを含む .zip ファイルが、指定した出力ディレクトリに保存されます。

エージェント バージョン v10 以前の場合:

  1. AFSDiag の出力が保存されるディレクトリを作成します (例: C:\Output)。

    注意

    AFSDiag では、ログが収集される前に、出力ディレクトリ内のすべてのコンテンツが削除されます。 データが含まれていない出力場所を指定してください。

  2. 管理者特権で PowerShell ウィンドウを開き、次のコマンドを実行します (各コマンドの後で Enter キーを押します)。

    cd "c:\Program Files\Azure\StorageSyncAgent"
    Import-Module .\afsdiag.ps1
    Debug-Afs c:\output # Note: Use the path created in step 1.
    
  3. Azure File Sync のカーネル モード トレース レベルには、(より詳細なトレースの作成を指定しない限り) 1 を入力し、Enter キーを押します。

  4. Azure File Sync のユーザー モード トレース レベルには、(より詳細なトレースの作成を指定しない限り) 1 を入力し、Enter キーを押します。

  5. 問題を再現します。 操作が終了したら、 [D] を入力します。

  6. ログファイルとトレース ファイルを含む .zip ファイルが、指定した出力ディレクトリに保存されます。

関連項目