M365Con 2027 – 無料オンラインカンファレンス · 11–22 Jan 2027 · 120 sessions→ m365con.net

ブログ · Mirko Peters

SharePoint のパス長とファイル名の制限:移行前に修正すべき点

By · · Updated

SharePoint の URL の長さの上限は、デコード後のファイルパスで400文字です。移行前に、このチェックリストを使って長すぎるパスと無効な名前を見つけましょう。

Automatically translated with AI from the original post. Read the English original

SharePoint の URL の長さの上限は、ファイル名を含むデコード後のファイルパスで400文字です。これを超えるファイルは、アップロード、コピー、同期に失敗し、ユーザーにはファイルの代わりにエラーが表示されます。このチェックリストは、SharePoint 移行を担当するリーダーを対象としています。移行後の名前変更は手間がかかり、リスクも高いため、最初のコピーの前に移行元で長いパスと無効な名前を見つけることが目的です。Microsoft が文書化している内容、不明確な点、最も長いパスを順番に修正する方法を解説します。

重要なポイント

  • Microsoft は、OneDrive と SharePoint において、ファイル名を含むデコード後のファイルパス全体の上限を400文字と文書化しています。
  • Windows には独自の上限もあります。Office デスクトップアプリは、クラウドがファイルを受け入れても、パス全体が260文字を超えるファイルを開けません。
  • 無効な文字には、二重引用符、アスタリスク、コロン、山かっこ、疑問符、スラッシュ、パイプが含まれます。先頭や末尾のスペースも使用できません。
  • 情報源は、エンコード後とデコード後のどちらで数えるか、また数え始める位置についても一致していません。そのため、/sites から数え、チェックには余裕を持たせてください。
  • 移行元でパスを測定し、フォルダー名を短くして最も長いものから修正します。ファイル名は、コピーの後ではなくコピーの前に変更してください。

SharePoint の URL の長さの上限:Microsoft の文書による説明

Microsoft は、SharePoint Online の400文字の上限を2か所で示しています。サービスの説明である SharePoint limits では、Microsoft 365 の OneDrive と SharePoint について、ファイル名を含むデコード後のファイルパス全体が400文字を超えてはならないと記載されています。ヘルプ記事の What are the file path length limits? も同じ数値を示し、詳細を補足しています。どちらのページも上限を引き上げる設定については触れていないため、この上限を前提に計画してください。

この記事の重要なポイント:

  • フォルダー階層内のすべてのフォルダーと、拡張子を含むファイル名が数えられます。区切り文字、スペース、拡張子を含め、すべての文字が数えられます。
  • Office for the web も同じ400文字の上限を使用します。
  • SharePoint では、特殊文字、スペース、アクセント付き文字は URL エンコードされます。スペースは %20 に変換されます。

エンコードの扱いについては、ページ間で説明が異なります。ヘルプ記事ではエンコードされた形式が上限に含まれるとしていますが、主要なルールではデコード後のパスに言及しています。サービスの説明ではデコード後のパスのみが言及されています。次のセクションでは、ほかにどのような点で説明が食い違っているかを見ていきます。

SharePoint が文字を数える方法

文字数の数え方について3つの情報源が回答していますが、その内容は完全には一致していません。

  • デコード後のパスか、エンコード後のパスか? Microsoft Q&A で Microsoft の外部スタッフが承認した回答では、パスの長さはデコード後のパスで計算されるとされ、制限に関する記事が示されています。2017 年の発表も同じ内容でした。Redmondmag は、Microsoft の Bill Baer の発言として、「SharePoint Online と OneDrive for Business では、エンコードされた URL の長さに制限はありません。」と伝えています。ヘルプ記事の「%20 もカウントされる」という注記のほうが例外です。
  • カウントはどこから始まるのか? Microsoft Q&A の別の回答(Microsoft の外部スタッフによるもの)では、/sites セグメントから数え始め、クエリ文字列のパラメーターは無視するとされています。たとえば /sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=... のようなリンクでは、疑問符より前の部分だけが対象になります。この回答によれば、サイト名とライブラリ名もカウントされます。ヘルプ記事自身の例はライブラリのルートから始まっているため、この Q&A の回答は公式ドキュメントではなく、サポート上のガイダンスとして扱ってください。
  • サーバー名はどうなるのか? Redmondmag が 2017 年に報じた計算式は、プロトコル、サーバー名、フォルダーまたはファイルのパス、フォルダーまたはファイル名、パラメーターを合計するものです。これはサポートの回答とは異なっており、ぎりぎりの文字数で運用しないほうがよいもう一つの理由になります。

安全なルールは次のとおりです。/sites から数え、サイト名、ライブラリ名、すべてのフォルダーとファイル名を含めてください。そのうえで、テナントで実際のエッジケースを検証するまでは、数十文字程度の余裕を残しておきます。

Microsoft はパスの上限を引き上げたのか?

Redmondmag によれば、一度だけです。2017 年 5 月の記事では、SharePoint Online と OneDrive for Business の URL パスの最大長が、256 から 400 Unicode コード単位に拡張されたと報じられています。それ以降、上で引用した Microsoft のページでも数値は 400 のままです。古いガイドや移行ツールで 256 または 260 と書かれている場合、それは現在のクラウドの制限ではなく、古い制限または Windows の制限を説明しています。

ハイパーリンク列には独自の 255 文字制限があります

パスの上限とよく混同される、もう一つの制限があります。Microsoft Q&A のスレッドで、Microsoft のサポートの回答は、SharePoint のリストまたはライブラリの「ハイパーリンク」列には 255 文字の制限があり、これは仕様によるものだと述べています。深いフォルダー構造では、ファイルへのリンクがフォルダー名をすべて繰り返すため、簡単に長いリンクになってしまいます。

提案されている回避策は、「拡張リッチ テキスト」を有効にした「複数行のテキスト」列を使い、エディターのハイパーリンクオプションでリンクを追加する方法です。スレッドのコメント投稿者は二つの欠点を挙げています。対象ファイルの名前を変更したり移動したりすると、リンクが更新されないことがあること、そして拡張リッチ テキストのオプションはドキュメント ライブラリでは使えないことです。根本的に問題を避けるには、フォルダー名を短くするのが効果的です。

Windows で問題になる上限

パスは SharePoint では問題なくても、デスクトップで壊れることがあります。同じヘルプ記事には Windows 側の制限も記載されています。

  • Office デスクトップ アプリは、ファイルがローカルに保存されていても、フルパスが 260 文字を超えるファイルを開けません。
  • エクスプローラーは、ファイルを開く、名前を変更する、移動するときに 260 文字の制限を使用します。Windows の長いパスのポリシーは使用しません。
  • OneDrive の同期では、ローカルパスの合計は 520 文字までです。内訳は、ローカルパスが最大 400 文字、OneDrive のルートフォルダーが最大 120 文字です。
  • 個々のファイル名またはフォルダー名は、エクスプローラーと macOS の Finder では最大 255 文字です。

ローカルパスには、同期されたライブラリを格納しているフォルダーも含まれるため、多くの人が想定するより長くなります。つまり、クラウド上で 250 文字のパスでも、ユーザーのノートパソコンでは 310 文字になることがあります。同期フォルダーから人が開くコンテンツには、260 を実質的な上限として扱ってください。

SharePoint が拒否する名前

長さはチェックリストの半分にすぎません。Microsoft の記事 OneDrive と SharePoint の制限事項には、確認すべき点が記載されています。

  • 使用できない文字: 二重引用符、アスタリスク、コロン、小なり記号、大なり記号、疑問符、スラッシュ、バックスラッシュ、パイプ。
  • スペース: 先頭と末尾のスペースは使用できません。
  • 予約された名前: .lock、CON、PRN、AUX、NUL、COM0~COM9、LPT0~LPT9、_vti_、desktop.ini。
  • 接頭辞と文字列: ~$ で始まるファイル名は使用できません。また、名前のどこにも _vti_ を含めることはできません。ライブラリのルートでは、forms という名前は使用できません。
  • 番号記号とパーセント記号: 組織によっては、名前での使用がまだサポートされていない場合があります。グローバル管理者と SharePoint 管理者が有効にできます。

これらの制限はファイルとフォルダーの両方に適用されます。末尾にスペースがあるフォルダーは、その配下のすべてをブロックするため、1 つの不正なフォルダー名で数千件の項目が失敗する原因になります。

移行前のチェックリスト

コピーを行う前に、すべての共有またはサイトで次の順序に従ってください。

  1. 移行元でパスの長さを測定します。 完全なパスの一覧をエクスポートし、それぞれの長さを計算します。ファイル共有の場合、PowerShell の Get-ChildItem -Recurse ですべての項目の完全な名前を取得でき、短いスクリプトで文字数を数えられます。
  2. 移行先のパスを計算します。 ライブラリに存在しない移行元パスの部分を取り除き、新しいライブラリ相対の接頭辞を追加します。/sites から数えてください。サイト名と ドキュメント ライブラリの名前も合計に含まれます。
  3. 300 を超えるものはすべてフラグを立てます。 400 が絶対的な上限です。300 でフラグを立てておくと、同期フォルダーや後からの名前変更のための余裕が残ります。
  4. 使用できない文字と予約された名前を一覧化します。 上記の文字、先頭と末尾のスペース、~$ のようなファイルを検索してください。
  5. 影響の大きい順に修正します。 長いツリーの中で最も上位にあるフォルダー名から短縮してください。1 つのフォルダー名を短くすると、その配下のすべてのパスが短くなります。
  6. 再測定します。 同じ計測をもう一度実行してください。そのうえで初めてコピーを計画します。

Microsoft の移行スキャンも役立ちます。Migration Manager はすべてのファイルを既知の潜在的な問題についてスキャンし、SharePoint 移行ツールには、スキャンのみを行うオプションがあります。移動する前に問題を確認できます。これらは二次チェックとして使用し、唯一のチェック手段にしないでください。

例: 1 つの長いパスと 2 つの上限

この例は架空の名前と数値を使用しています。ファイルは、ファイル共有のルートから 247 文字のパスにあります。たとえば 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/ の後に、107 文字のファイル名が続きます。移行先は Projects という名前のライブラリで、数値を単純に保つためにサイト名は無視しています。ライブラリでは Projects/ の 9 文字が加わり、合計は 256 になります。

  • クラウドの上限: 256 は 400 未満なので、SharePoint はこのファイルを受け入れます。
  • Windows の上限: 一般的な同期パスは、C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\ のような 62 文字のローカル フォルダーから始まります。ローカルの合計は 62 + 247 = 309 で、260 を超えています。Office デスクトップ アプリは同期フォルダーからこのファイルを開けません。

対策は上限を引き上げることではなく、名前を短くすることです。移行リーダーはフォルダー名を Contracts、Northwind Phase 2、Tech Spec、Approved、Signed に変更し、ファイル名を Northwind Phase 2 - Tech Spec v3 signed.docx に変更します。ルート以下のパスは 247 文字から 103 文字に減ります。ローカルの合計は 309 から 165 に減り、260 を十分に下回るため、より長いユーザー名にも対応できる余裕が残ります。

名前を変更する前に、業務面の確認を行ってください。契約書や技術仕様書には命名規則が適用されていることが多く、法的な理由からファイル名を変更できない場合もあります。その場合は、フォルダーを短くし、ファイル名はそのまま維持してください。

パスが長すぎる場合の対処方法

次の 4 つの方法があり、優先順位は以下のとおりです。

  • フォルダー名を短くします。 URL を短くする最も低コストな方法であり、その配下のすべてのファイルに効果があります。
  • 構造を簡素化します。 Approved 内の Final のように、情報を重複させるだけの階層を取り除きます。Microsoft のファイル共有ガイドでは、大規模なドライブを、より小さく目的を絞ったライブラリに分割することも推奨されています。
  • フォルダーではなくメタデータを使います。 ライブラリーに「年」や「顧客」といった列を作れば、フォルダーの2階層分を置き換えられます。
  • 不要なファイルは残さないようにします。 長年誰も開いていないファイルは、別の場所にアーカイブします。

移行後にファイルを1階層上に移動するといった回避策には頼らないでください。原因を解消しなければ、次の再編でも同じ問題が起きます。

名前を変更する前に、コンテンツ所有者とルールを合意しておきます。たとえば「フォルダー名は40文字以内」「フォルダーの階層は8段階以内」といった簡単な命名規則を決めると、目標が明確になります。移行後に新しいコンテンツが上限を超えて再び増えるのも防げます。移行の告知にも同じ内容を記載し、慣れ親しんだフォルダー名が変わった理由を利用者が理解できるようにします。

よくある間違い

  • 数える起点を誤る。 元の場所のパスは、ライブラリーでのパスとは異なります。移行先のパスを計算してください。
  • ローカルの同期フォルダーを忘れる。 ブラウザーでは問題なく開けるパスでも、Office デスクトップアプリでは失敗することがあります。
  • 数えるルールを軽視する。 文字のエンコードや起点の数え方は資料によって異なるため、余裕を持たせておきます。1件の長いアイテムで移行要求が失敗すると、似たようなエラーの中に本当の原因が埋もれてしまいます。
  • コピーの後に名前を修正する。 クラウドでの名前変更はすべてのクライアントに同期されます。移動後に名前を変えると、移動前のソース側で済ませられた作業を繰り返すことになります。
  • 1つのチェックだけを信用する。 独自に計測することと、移行スキャンの両方を実行してください。

ソフトウェアが役立つ場面

始めるだけなら PowerShell と表計算ソフトで十分です。すべてのパスとその長さを一覧にし、長さで並べ替えて、最上位のフォルダーごとにまとめます。Microsoft の移行スキャンは、別の視点を与えてくれます。サードパーティ製ツールにも、パスと名前のレポート機能を持つものがあります。ツールを評価する際は、正しい起点から数えているか、コピーを妨げているファイルやフォルダーを表示できるかで判断してください。

次のステップ

今週、ある共有の パスを書き出し、長さで並べ替えてください。そのうえで、300文字を超えるファイルが何件あるかを記録してください。この件数が、SharePoint の URL 長の上限に対応するクリーンアップの作業量を決めます。

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS