次の方法で共有

Migration Manager ファイルの移行のトラブルシューティング

この記事では、ファイル共有の移行に Migration Manager を使用するときに発生する可能性がある問題とエラーを解決する方法について説明します。

前提条件と設定を確認する

エージェントのインストールの前提条件を満たしていることを確認し、必要なエンドポイントを確認します。 Government クラウドのお客様は、構成が正しく設定されていることを確認する必要があります。

エージェントのエラー メッセージ

メッセージ 操作
移行エージェントをインストールできませんでした。 セットアップを閉じてからもう一度お試しください。 古いバージョンのエージェント セットアップ ファイルを使用してエージェントをインストールしている可能性があります。 詳細については、「 エージェントのインストール エラー 」セクションを参照してください。
現在のユーザーがソース ファイル共有にアクセスできない ソースファイル共有がネットワーク ファイル共有であることを確認します。 エージェントに関連付けられている Windows アカウントに、移行するファイル共有に対する 読み取り アクセス許可があることを確認します。
ソース ファイル共有が存在しない ソースファイル共有が既存のネットワークファイル共有であることを確認します。 エージェントに関連付けられている Windows アカウントに、移行するファイル共有に対する 読み取り アクセス許可があることを確認します。

リンク先サイトの URL に関する問題

メッセージ 推奨される操作
宛先サイトまたは Web が存在しない リンク先のサイトまたはサブサイトが存在することを確認します。 OneDrive アカウントの場合は、事前にプロビジョニングされていることを確認します。
サイトまたは Web の存在を確認できませんでした。 リンク先のサイトまたはサブサイトが存在することを確認します。

よく見るエラーメッセージ

メッセージ 推奨される操作
無効なソース フォルダー 入力したパスが正しいことを確認し、適切な形式に従います。
フォルダーへの 読み取り アクセス権があることを確認します。
サイトを作成または更新することはできません サイトを作成するためのアクセス許可があり、URL が有効であることを確認します。
サイトが存在する場合は、サイト コレクション管理者であることを確認します。
それでも問題が解決しない場合は、サイトを手動で作成し、その新しく作成されたサイトを移行ツールに指定します。
スキャン ファイルのエラー: フォルダー名が無効です 「OneDrive と SharePoint の無効なファイル名とファイルの種類」を参照してください。
スキャン ファイルのエラー: ターゲット パスが長すぎます 「OneDrive と SharePoint の無効なファイル名とファイルの種類」を参照してください。
OneDrive および SharePoint では、ファイル名を含むパス全体の長さは 400 文字よりも少なくする必要があります。
スキャン ファイルのエラー: ファイルをパックするのに十分なディスク領域がありません 移行作業フォルダーに使用できるディスク領域が、ソース ファイルのサイズに対して小さすぎます。 作業フォルダーのサイズを拡大して、もう一度やり直してください。
パッケージ化の失敗: ファイルを開くことができない 存在しないソースが原因でパッケージ化に失敗しました。 ソース ルート フォルダーにアクセスできるかどうかを確認します。
重複するタスクが既に作成されています。 一括移行を実行するために使用される CSV ファイルには、重複するエントリを含めることはできません。 重複する行または行を削除して、もう一度やり直してください。
親フォルダーが移行されませんでした 親フォルダーは移行されていないため、フォルダー内のすべての項目は移行に失敗します。 親フォルダーを確認し、移行を再試行してください。

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

問題: 古いバージョンのエージェント セットアップ ファイルを使用してエージェントをインストールすると、移行エージェントのインストールに失敗します。

エージェントのインストールの失敗を示す画面

診断/調査:

古いclientsetup.exe ファイルがこの問題を引き起こす可能性があります。

軽減策:

  1. SharePoint 管理センターの移行センターに移動し、組織の管理者権限が付与されているアカウントでサインインします。
  2. [エージェント セットアップ ファイルのダウンロード] を選択します。
  3. エージェントをインストールするコンピューターまたは仮想マシンで、 clientsetup.exe ファイルを実行します。 指示に従って、エージェントのインストールを完了します。

発行： 移行エージェントが正常にインストールされないか、clientsetup.exe を開くことができない。

例:

Migration Manager エージェントのインストールエラーのスクリーンショット。

診断/調査:

clientsetup.exe を開くことができない場合:

  • 管理者として Windows にサインインするか、アプリケーションを開いたときに管理者のユーザー名とパスワードを入力します。 管理者アカウントがドメインに追加されているはずです。

インストールのプロセス中にエラーが発生した場合:

  • エラー メッセージに、失敗の理由と、可能であれば行うべき適切な操作が含まれているはずです。
  • エラーによって解決するアクションが提案されない場合は、一時的なネットワーク障害によってこの問題またはその他の不明な問題が発生する可能性があります。

軽減策:

clientsetup.exe を開くことができない場合:

  1. 管理者として Windows にサインインします。
  2. clientsetup.exe アプリケーションをもう一度開くか、アプリケーションを開いたときに管理者のユーザー名とパスワードを入力します。

インストール プロセス中にエラーが発生した場合:

  • 特定の操作が示されているエラーの場合は、対応する操作を実行してから、clientsetup.exe を再度開きます。
  • その他の特定以外のエラーの場合は、管理者アカウントがドメインに追加されていることを確認します。 アプリケーション ウインドウを閉じて、インストールを再試行します。

エージェントが切断されている

問題: エージェントの状態に "切断済み" と表示され、変更されることはありません。

エージェントが切断されている

診断/調査:

  • エージェントがインストールされているコンピューターのネットワークの正常性を確認します。
  • ログインしたテナント管理者アカウントのパスワードが変更された場合、またはその他の同様の重要な変更がテナント 管理 アカウントに適用され、再度サインインする必要がある場合は、すべてのエージェントが切断されます。 それらのすべてに再インストールが必要です。
  • エージェントが自動アップグレードに失敗した場合、バージョンが古すぎる可能性があります。 エージェントを再インストールします。
  • トークンの有効期限が切れると、エージェントが切断される場合もあります。

軽減策:

  • ネットワークに問題がある場合は、それを修正します。 エージェントはすぐに再接続されます。
  • 再度サインインする必要があるテナント 管理 アカウントに重大な変更がある場合: すべてのコンピューターにエージェントを再インストールします。
  • どちらのオプションも適用されない場合は、まずエージェントを再インストールします。

タスクが [キューに登録済み] の状態が続いている

問題: タスクの状態が "[キューに登録済み]" のままで、エージェントで実行するようにスケジュールされない。

キューに登録された状態でタスクが停止しました。

診断/調査:

  • このテナントにエージェントがインストールされていることを確認します。 それらはエージェントの一覧に表示されます。
  • 各エージェントの状態を確認します。 [有効] に設定されている必要があります。
  • [使用中] の状態は、そのエージェントがすでに別のタスクを処理中であることを示します。 エージェントは、現在のタスクを完了せずに、より多くのタスクを割り当てることはできません。
  • エージェントが "無効" として表示されている場合は、有効にします。
  • 長時間にわたって [切断] と表示される場合は、「エージェントが切断されている」をチェックしてください。

軽減策:

  • 一覧には使用可能な有効なエージェントが含まれているが、長時間にわたってタスクがスケジュールされていない場合: 同じタスクを別に作成します。 場合によっては、問題が解決されることがあります。

タスク レポートをダウンロードできない

問題: タスクの詳細パネルのリンクからタスク レポートをダウンロードできません。

  • [タスク レポートのダウンロード] リンクが無効になっている。
  • [タスク レポートのダウンロード] リンクはアクティブに表示されますが、クリックしても何も起こりません。

タスク レポートをダウンロードできないスクリーンショット。

診断/調査:

  • [タスク レポートのダウンロード] リンクは、タスクが完了するまで無効になります。 レポートは、タスクの状態が "完了" または "失敗" 状態になった後にのみ使用できます。 タイムアウトが原因で失敗したタスクには、無効なタスク レポート リンクもあります。
  • 完了した、タイムアウトしていないタスク用にレポートをダウンロードできない場合は、移行プロセス中に発生したエラーが発生し、レポートの SharePoint へのアップロードが中断される可能性があります。 ただし、それらが存在していれば、ローカルで見つけることができます。

軽減策:

タスクを完了したコンピューターで、レポートを取得してみてください。

  • フォルダー %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site]、または Your-Customed-Working-Folder >\Migration\MigrationTool[tenant_site]を<して、サブフォルダーを変更した時間で並べ替えます。 更新日時がタスクの開始時刻に最も近いサブフォルダーを探します。 タスク レポートが存在する場合は、このサブフォルダー内の "レポート" フォルダーにあります。

または

  • タスクが失敗した場合は、 フォルダー %AppData%\Microsoft\SPMigration\Logs に移動し、サブフォルダーを変更した時間で並べ替えます。 更新日時がタスクの開始時刻に最も近いサブフォルダーを探します。 エラー レポートは、このサブフォルダーにあります。

タスク レポート中の移行エラー

問題: 移行タスクはさまざまな理由で失敗し、タスク レポートで詳しく説明されています。

移行マネージャー エラー

診断/調査:

  • 失敗の理由は、提案された解決策とともにレポートに詳細に記述されているはずです。
  • タスク レポートをダウンロードできない場合は、「 タスク レポートをダウンロードできない」を参照してください。

軽減策:

軽減策 特定のエラーに関する詳細については、「エラー コード」 を参照してください。

次のようなエラーが発生した場合: SUBMITING FAILURE Failed to Submit the Job to Server: Unknown failed reason when submiting a job. 0x01610002, チェック、エージェント コンピューターにインストールされているウイルス対策アプリケーションの設定をチェックします。 移行トラフィックが中断されないように、2 つの移行アプリケーションを例外として追加します。

  • microsoft.sharepoint.migration.clientservice.exe
  • microsoft.sharepoint.migration.mthost.exe

レポートに HTML コードが表示されている Google エラー レポート

問題: Google 移行用に生成されたエラー レポートに、レポートに HTML コードが埋め込まれている場合があります。

Google エラー レポートには HTML コードが含まれています。

詳細:

Google API は、生成されたレポートに含まれる HTML エラーを返します。 この問題は、Google サーバーの読み込みエラーが発生した場合に発生する可能性があります。

軽減策:

同時実行の少ないトランザクションを実行します。

状態:

この問題は既知の問題です。 ETA が設定されていない。

Geo 管理者はサポートされていません

移行マネージャーは現在、特定のシナリオにおいて Geo 管理者ロールをサポートしていません。 ファイル共有の移行の場合、これらのユーザーは [ スキャン ] タブにアクセスできません。クラウド移行の場合、これらのユーザーは [ スキャン ] タブまたは [ 移行 ] タブにアクセスできません。

回避策。 Geo ユーザーに SharePoint 管理者またはグローバル管理者ロールを割り当てる。

重要

Microsoft では、アクセス許可が最も少ないロールを使用し、organizationのセキュリティを強化することをお勧めします。 グローバル管理者は高い特権を持つロールであり、既存のロールを使用できない場合の緊急時に限定する必要があります。

  1. 管理センターで、[ユーザー]>[アクティブ ユーザー] ページの順に移動します。
  2. [アクティブ ユーザー] ページで、どのユーザーの管理者ロールを変更するかを選択します。 ポップアップ ウィンドウの [役割] で、[役割の管理] を選択します。
  3. ユーザーに割り当てる管理者の役割を選択します。 探しているロールが表示されない場合は、リストの下部にある [すべて表示] を選択します。

グループ継承された SharePoint 管理者が [スキャン] タブと [移行] タブにアクセスできない

移行マネージャーは、Azure グループに参加した結果として作成された SharePoint 管理者ロールを完全にサポートしていません。 ファイル共有の移行の場合、これらのユーザーは [ スキャン ] タブにアクセスできません。クラウド移行の場合、これらのユーザーは [ スキャン ] タブまたは [ 移行 ] タブにアクセスできません。

回避策。 ユーザーに SharePoint 管理者またはグローバル管理者ロールを割り当てます。

重要

Microsoft では、アクセス許可が最も少ないロールを使用し、organizationのセキュリティを強化することをお勧めします。 グローバル管理者は高い特権を持つロールであり、既存のロールを使用できない場合の緊急時に限定する必要があります。

  1. 管理センターで、[ユーザー]>[アクティブ ユーザー] ページの順に移動します。
  2. [アクティブ ユーザー] ページで、どのユーザーの管理者ロールを変更するかを選択します。 ポップアップ ウィンドウの [役割] で、[役割の管理] を選択します。
  3. ユーザーに割り当てる管理者の役割を選択します。 探しているロールが表示されない場合は、リストの下部にある [すべて表示] を選択します。

サイト コレクション "XXXX" を作成または更新できません

参照されているユーザー プリンシパル名 (UPN) が無効です。 OneDrive サイト コレクションを作成または更新するには、Microsoft Entra ID参照される UPN を含める必要があります。 宛先 URL を確認し、ユーザーがMicrosoft Entra IDに存在することを検証します。

スキャン タスクが "キューに入っている" 状態でスタックしている

問題: ファイル共有スキャンの状態は "Queued" のままであり、エージェントで実行するようにスケジュールされることはありません。

スキャン タスクの問題がキューに入ったフェーズでスタックしました。

診断/調査

  • スキャン タスクの [エージェント グループ] 列を確認します。 既定のエージェント グループ内のエージェントのみをスケジュールできます。

スキャン タスクの問題のトラブルシューティング。

軽減策

  • [既定のエージェント] グループにエージェントがない場合は、既存のエージェントのグループを [既定] に変更します。 スタックしたスキャン タスクは、この状態から移行する必要があります。

スキャン タスクの問題のエージェントの編集。

エラー コード

エラー コード 推奨される操作
0x00000000 予期しないエラーが発生しました。
0x01110001 不明な理由。
0x0111000B パスが長すぎます。
0x0111000F 親フォルダーは移行されませんでした。 エラー報告を確認してファイルを特定してから、もう一度お試しください。
0x01110003 ソース フォルダーにアクセスできません。
0x01110009 ファイル メタデータを取得できませんでした。
0x01110010 ファイル名に無効な文字が含まれています。 <>:"?*/、 を含むファイル名のレポートを確認する
0x01110011 アイテム "作成時刻" または "変更時刻" はサポートされていません。
0x0201000D 一覧が存在するかどうか、または、移行元サイトおよび移行先ターゲット サイトの一覧にアクセスできるかどうかを確認します。
0x02050008 ローカル ストレージにアクセスできません。 移行を再開します。
0x02010023 ソース リスト テンプレートはサポートされていません。 別の操作を試してみます。
0x0201000C 資格情報を確認して、ユーザー名とパスワードを再入力します。
0x02010017 サイト コレクションの管理者である必要があります。
0x02060009 1 - URL が既に使用されているか無効な URL であるため、サイト コレクションを作成できません。
2 - URL に無効な文字が含まれているため、サイト コレクションを作成できません。
3 - サイト コレクションを作成または更新できません。
0x02060007 1 - URL が既に使用されているか無効な URL であるため、サイト コレクションを作成できません。
2 - URL に無効な文字が含まれているため、サイト コレクションを作成できません。
0x02010018 1 - 資格情報を確認し、再試行します。
2 - SharePoint へのアクセス中に問題が発生しました。 資格情報を確認し、再試行します。
3 - SharePoint へのアクセス中に問題が発生しました。 資格情報とネットワーク接続を確認し、再試行します。
4 - SharePoint へのアクセス中に問題が発生しました。 資格情報とサイトの URL の正確性を確認し、再試行します。
5 - SharePoint へのアクセス中に問題が発生しました。 資格情報と URL の形式を確認します。 再試行します。
6 - SharePoint へのアクセス中に問題が発生しました。 資格情報を確認し、再試行します。 問題が解決しない場合は、サポート ケースを作成します。
7 - SharePoint へのアクセス中に問題が発生しました。 資格情報を確認し、ブラウザーでサイトを開いてみます。
0x0204000A パッケージ ファイルを作成できません。 移行マネージャー作業フォルダー %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 内のすべてのファイルとフォルダーを閉じる必要があります。 移行を再開します。
0x02030001 1 - 資格情報を確認します。 移行を再開します。
2 - 資格情報を確認します。 移行を再開します。
3 - 資格情報とネットワーク接続を確認します。 移行を再開します。
4 - 資格情報とサイトの URL を確認します。 移行を再開します。
5 - 資格情報と URL の形式を確認します。 移行を再開します。
6 - 資格情報を確認し、移行を再開します。 この問題が解決しない場合は、サポート ケースを作成します。
7 - 資格情報を確認し、ブラウザーでサイトを開いてみます。 移行を再開します。
0x02010008 ユーザー マッピング ファイルのパスと形式を確認し、アクセス許可があることを確認します。
0x02050001 移行マネージャー作業フォルダー %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 内のすべてのファイルとフォルダーを閉じる必要があります。 移行を再開します。
0x02010002 ネットワーク状態を確認します。 ブラウザーからソースのサイトにアクセスできる場合は、サポート ケースを作成します。
0x02010010 ソース リストとターゲット リストに同じテンプレートがあることを確認します。
0x0204000D 移行中は、移行マネージャー作業フォルダー %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 内のすべてのファイルとフォルダーを閉じる必要があります。 移行を再開します。
0x02040012 ローカル コンピューターの一時的な記憶域が少なすぎます。 移行マネージャーは、作業フォルダーにパッケージをキャッシュします。 一時的な記憶域を増やして、再試行します。
0x02030003 固有のアクセス許可を持つアイテムが多すぎます。 一意のアクセス許可の数を減らすことで、アクセス許可のリストを単純化します。 移行を再試行します。
0x02050001 ローカル ストレージ ファイルが破損しています。 移行中に作業フォルダーが操作されるか変更されました。 移行を再試行します。
0x02080001 パッケージ内のファイルがアップロード中に変更または削除されました。 移行マネージャー作業フォルダー %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 内のすべてのファイルとフォルダーを閉じる必要があります。 移行を再開します。
0x02040009 ディレクトリが見つからないため、パッケージを作成できません。 移行マネージャー作業フォルダー %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage 内のすべてのファイルとフォルダーを閉じる必要があります。 移行を再開します。
0x02010020 Migration Manager 設定でバージョン履歴の移行を無効にするか、SharePoint でバージョン管理を有効にします。
0x0201000E グローバル設定でターゲット パス内の特殊文字が除外されているか、パスにサポートされていない文字があるかどうかを確認します。
0X0201000F サイトの URL が無効です。 サイトの URL が有効かどうかを確認してください。 ブラウザー経由で URL にアクセスしてみてください。 このアカウントが OneDrive アカウントの場合は、移行する前に事前にプロビジョニングされていることを確認してください。
0x0207001 タスク フォルダーにアクセスできません。 %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage にアクセスできるかどうかを確認します。
0x01410010 リスト アイテムの依存関係がないため、エラーが発生しました。 詳細については、FailureSummaryReport.csv を確認してください。 依存関係が移行スコープに含まれているかどうかを確認します。
0x01510001 パッケージをアップロードできませんでした。 カスタマイズされた Azure ストレージがある場合は、Azure ストレージにアクセスできるかどうかをチェックし、ターゲット サイトにアクセスできる場合はチェックします。 もう一度移行します。
0x01510001 ジョブをサーバーにアップロードできませんでした。移行中にファイルのアップロードに失敗しました。
0x02070009 複数のパッケージをアップロードできませんでした。 タスクを一時停止し、ネットワーク接続を確認します。
0x01710009 ジョブの終了に失敗したため、エラーが発生しました。パッケージの一部が失敗しました。 移行を再開します。
0x01710009 ファイルのサーバー処理のエラーまたはタイムアウト: パッケージ内のすべての項目が移行されたわけではありません。
0x01610001 Azure コンテナーの有効期限が切れています。 移行タスクを再試行します。
0x01710006 ファイルを処理するサーバーのエラーまたはタイムアウト: ジョブの致命的なエラー。
0x01710004 ファイルを処理するサーバーのエラーまたはタイムアウト。 フォルダー名を検索に失敗しました。 アイテムは、同じサイト コレクションの他のリストまたはサイトに存在する場合があります。 または、アイテムがごみ箱にあります。
0x0131000F ファイルを読み取ることができませんでした。 ファイルがチェックアウトされました。