今回は私がドハマりしたCSVの記入方法で起きたエラーについての内容です。
簡単な概要は記載ありますが、ツールの使い方などは他の有識者様のブログをご確認ください。
① 移行ツール（SPMT）とは？
SharePoint 移行ツール (SPMT) は、オンプレミスのファイルサーバーや、古いSharePoint Server（2010 / 2013 / 2016など）にあるコンテンツを、Microsoft 365のSharePoint OnlineやOneDrive、Microsoft Teamsへ移行するための無料デスクトップアプリです。
https://learn.microsoft.com/ja-jp/sharepointmigration/introducing-the-sharepoint-migration-tool
主な特徴
- 無料: Microsoft 365ユーザーなら誰でも利用可能。
- 権限の維持: Active Directoryと連携し、ファイルに付与されたアクセス権を可能な限り保持したままコピーできます。
- 増分移行: 一度移行した後、差分（更新されたファイル）だけを再度送り込むことができ、切り替え直前のダウンタイムを最小限に抑えられます。
② どのような場面で活用できるか？
活用シーン
- ファイルサーバーのクラウド統合: 社内のNASやWindows Serverにある膨大な共有フォルダを、構造を保ったままSharePointへ移行したい場合。
- Teamsへの移行: プロジェクトごとに管理していたデータを、Teamsの「ファイル」タブ（中身はSharePoint）へ直接流し込みたい場合。
- 古いSharePointのアップグレード: サポートが終了する古いSharePoint Serverから、最新のSharePoint Onlineへコンテンツを昇格させたい場合。
単なるコピー＆ペーストとは異なり、大規模で複雑なシーンで真価を発揮します。
③ 移行用CSV作成の注意点
大量のフォルダを効率的に移行するには、「どのフォルダを、どこのサイトに飛ばすか」を記述したCSVの作成が実用的です。
作成の注意点
- パス（URL）の正確性：Source（移行元）のローカルパスと、Destination（移行先）のSharePoint URLを正確に記載が必要です。
私がドハマりした部分
- 「ヘッダー（項目名）」は必須ではない。
- 以下の画像のように必須かと思いましたが、上手くいかず記載していた1行目を消してデータから始めたら上手くいきました。
以下ダメな例：Microsoft Learn（公式ドキュメント）にある小さい画像をよく見てみると、実はあちらもヘッダーはなく、1行目からデータ（フォルダパス）が始まっていることが確認できます。
最後に
エラー時のメッセージにはヘッダーは不要などの文言はないので気づくまでに時間がかかりました。
当時エラーを検索しても見当たらなかったのでブログとして残せればと思います。
ここまで読んでいただき、ありがとうございます。もしこの記事の技術や考え方に少しでも興味を持っていただけたら、ネクストのエンジニアと気軽に話してみませんか。
- 選考ではありません
- 履歴書不要
- 技術の話が中心
- 所要時間30分程度
- オンラインOK
