JSON または CSV ファイルを使用した SPMT 移行タスクの一括アップロード

[アーティクル]
03/19/2024

SharePoint Migration ツール (SPMT) を使用すると、JSON または CSV ファイルを使用して移行タスク情報を一括アップロードできます。この方法は、多数のタスクを作成する場合に役立ちます。

方法はこちら:

CSV ファイルを使用する一括アップロード
一括アップロードに JSON ファイルを使用する
トラブルシューティング

CSV ファイルを使用して一括アップロードする

CSV ファイルの作成には、任意のテキストエディターや、Microsoft Excel などのアプリケーションを使用します。最初の 3 つは、データが現在配置されている場所に関する詳細を示すソース値です。残りの 3 列は、データの移行先となるサイト、ドキュメントライブラリ、またはオプションのサブフォルダーを示します。

列の定義

列の内容	説明
列 1 "移行元"	必須。オンプレミスの SharePoint Server サイトの URL またはローカルファイル共有へのパスを入力します。 SharePoint Server 2013 および 2016 の場合、この列にログイン名または SID を使用することもできます。
列 2 "移行元 DocLib"	オプション。移行している SharePoint Server のドキュメントライブラリの名前を入力します。このフィールドを空のままにすると、すべてのドキュメントライブラリが移行されます。ローカルファイル共有から移行する場合は、この列を空にする必要があります。
列 3 "移行元サブフォルダー"	オプション。ドキュメントライブラリのサブフォルダーの名前を入力します。この列が空白の場合は、ルートから移行が開始されます。この列に値がある場合は、移行はサブフォルダーから開始されます。ローカルファイル共有から移行する場合は、この列を空にする必要があります。
列 4 "移行先 Web"	必須。ファイルの移行先になる SharePoint サイトの URL を入力します。
列 5 "移行先 DocLib"	必須。ファイルを移行する SharePoint サイトのドキュメントライブラリの名前を入力します。
列 6 "移行先サブフォルダー"	オプション。ドキュメントライブラリのサブフォルダーの名前を入力します。この列を空のままにすると、ファイルはルートレベルに移動されます。
列 7 "RegisterAsHubSite"	省略可能です。移行後にサイトをハブサイトとして登録するには、ハブサイトの名前を入力し、次の列である AssociateWithHubURL を空白のままにします。 SharePoint サイトの移行のみのオプションです。
列 8 "AssociateWithHubURL"	省略可能です。サイトを別のハブサイトに関連付けるには、既存のハブサイトの URL を入力します。この場合、列 7 の "RegisterAsHubSite" は空白のままです。 SharePoint サイトの移行のみのオプションです。

重要

ハブサイトの関連付け: ハブサイトの登録と関連付けは、移行の最終段階で行われます。タスクが完了する前に終了すると、ハブサイトの作業が実行されない場合があります。 SPMT は、サイトが既にハブサイトに関連付けられていることが検出された場合、ハブの関連付けを変更しません。サイトがすでにハブサイトとして登録されている場合、そのサイトは "未登録" にはなりません。

CSV の例

以下に、CSV ファイルの形式の例を示します。最初の行には、ローカルのファイル共有から SharePoint に移行されるファイルが表示されます。 2 行目には、オンプレミスの SharePoint Server サイトから Microsoft 365 の SharePoint に移行されるファイルが表示されます。 3 行目には、ローカルのファイル共有から OneDrive に移行されるファイルが表示されます。

はじめに

1 行につき 1 つの移行元と移行先を入力します。
標準で使用できるドキュメントライブラリ (「共有ドキュメント」) を使用する場合は、CSV ファイルの [ソースドキュメントライブラリ] (列 B) のプレースホルダー値として内部名「ドキュメント」を使用する必要があります。その列に「共有ドキュメント」と入力すると、"無効なドキュメントライブラリ" エラーが表示されます。
移行先の SharePoint サイトの言語が英語でない場合は、https://contoso.sharepoint.com/sites/SampleSite/_layouts/15/viewlsts.aspx?view=14 にある「共有ドキュメント」ドキュメントライブラリの内部名を確認してください。

重要

上記で詳しく説明したすべての列が存在する必要があり、必要ない場合は空白にすることができます。

CSV ファイルを使用する際の SharePoint 移行ツールの書式設定例のスクリーンショット

次の例は、テキストエディターで開いた場合の外観を示しています。

C:\MigrationTests\testfiles,,,https://contoso.sharepoint.com/sites/Sample/,DocLibraryName,DocLibraryName_subfolder
https://sharepoint2013.com/sites/contosoteamsite/,DocumentLibraryName,DocLibrarySubfolder_name,https://contoso.sharepoint.com/sites/Sample/,DocLibraryName,DocLibraryName_subfolder
\\sharedfolder\homedrives\meganb,,,https://contoso-my.sharepoint.com/personal/meganb_contoso_com/,DocLibraryName,DocLibraryName_subfolder

一括アップロードに JSON ファイルを使用する

次の例は、データの移行に使用できる JSON ファイルの形式を示しています。

必要な最小値は SourcePath と TargetPath です。

{
  "Tasks": [
    {
      "SourcePath": "D:\\MigTest",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "TargetList": "Documents",
      "TargetListRelativePath": "subfolder"
    },
    {
      "SourcePath": "http://EXHB-1873",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "Items": {
        "Lists": [
          {
            "SourceList": "versionList",
            "TargetList": "NewVersionList"
          }
        ],
        "SubSites": []
      }
    },
    {
      "SourcePath": "http://EXHB-1873",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "Items": {
        "Lists": [
          {
            "SourceList": "listVersion2",
            "TargetList": "ListVersion2"
          },
          {
            "SourceList": "listVersion3",
            "TargetList": "ListVersion3"
          }
        ],
        "SubSites": [
          {
            "SourceSubSitePath": "subSite",
            "TargetSubSitePath": "targetSubSite",
            "Lists": [
              {
                "SourceList": "testSubListB",
                "TargetList": "TargetSubList"
              }
            ]
          }
        ]
      }
    },
    {
      "SourcePath": "http://EXHB-1873/subsite2",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com/targetSubSite2"
    }
  ]
}

トラブルシューティング

プロキシ接続

プロキシ接続は、SharePoint またはファイル共有の移行ではサポートされていません。既定では、SPMT はシステムプロキシの資格情報を使用せず、インターネットエクスプローラープロキシが構成されている場合、Web 要求は失敗します。表示されるエラーの例としては、"SharePoint ログインの失敗" や "ドキュメントライブラリを読み込めませんでした" などがあります。ただし、システムプロキシ設定に従うように SPMT アプリ構成ファイルを変更できます。

システムプロキシ設定を使用する場合は、次のいずれかの方法を使用します。

プロキシの更新

SPMT の最新バージョンをダウンロードします。 SPMT を開始します。
SPMT が Microsoft 365 に接続しない場合は、 %localappdata%\Apps\SharePointMigrationTool\SPMT に移動します。
microsoft.sharepoint.migrationtool.advancedapp.exe.config ファイルを開きます。
次に示す既定のプロキシ設定のコメントを解除します。
SPMT を再起動します。

SPMT がアップグレードしない場合

SPMT 自体をアップグレードできない場合は、 %localappdata%\Apps\SharePointMigrationTool\InstallerClient に移動します。
installclient.exe.config ファイルを開きます。
<appSettings></appSettings タグの直後の 31 行目に次の構成を追加します。
installclient.exe を起動すると、SPMT が最新の SPMT リリースに自動アップグレードされます。
microsoft.sharepoint.migrationtool.advancedapp.exe.config ファイルを開きます。
既定のプロキシ設定のコメントを解除します。
SPMT を再起動します。

その他のエラー

エラー	説明
移行先サイトが無効なハブサイトに関連付けできない	このエラーは、移行先サイトが既にハブサイトとして登録されている場合に発生します。 SPMT では、移行先サイトのハブ登録は変更されません。
移行先サイトが無効なハブサイトに関連付けできない	これは、無効なハブサイトに関連付けようとしている場合に発生します。 URL を確認し、もう一度やり直してください。
移行先サイトは既存のハブに関連付けられているため、移行中に変更することはできません	このエラーは、移行先サイトがすでに別のハブに関連付けられている場合に発生します。 SPMT では、移行先サイトの関連付けは変更されません。