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

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

方法はこちら:

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 "Target SubFolder" オプション。 ドキュメント ライブラリのサブフォルダーの名前を入力します。 この列を空のままにすると、ファイルはルート レベルに移動されます。
列 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 ファイルの形式を示しています。

必要な最小値は SourcePathTargetPath です

{
  "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"
    }
  ]
}