使用 CSV 或 JSON 文件将任务批量上传到迁移管理器

2025-04-03

有两种不同的方法可用于将任务批量上传到迁移管理器。一种方法是使用逗号分隔值 (CSV) 文件，另一种方法是使用 JSON 文件。

手动将值输入为所选格式。验证第一行以确保目标链接有效。如果收到无效目标错误，请确保同时检查任务的其余部分，确保它们具有有效的目标。

开始之前：

预配置 OneDrive 账户。如果要迁移到 OneDrive 帐户，请确保在迁移之前预先预配了帐户。可以使用以下脚本完成此预预配：为组织中的用户预配 OneDrive。
模板。 .csv 模板可用于批量上传：迁移管理器批量上传模板。
列标题。可以选择性地使用 CSV 文件中 YInclude 列标题，使文件更易于阅读。
所有列必须是 的账户。请记住，即使不需要给定字段的值，也要考虑文件中的所有六列。
UTF-8。 CSV 文件的编码必须为 UTF-8。
如果要迁移到 OneDrive 帐户。进入 OneDrive 目标时，请不要在项尾包含"_layouts/15/onedrive.aspx"。此外，目标 OneDrive 的文档库应为“Documents”而不是“MyFiles”。

使用逗号分隔值 (CSV) 文件进行批量上传

借助迁移管理器，可使用逗号分隔 (CSV) 文件批量迁移数据。使用任何文本编辑器或 Excel 等应用程序创建 CSV 文件。

CSV 文件格式

CSV 文件中需要六列。前三列是源值，每个列都提供有关数据当前所在位置的详细信息。其余三列指示要将数据迁移到的位置的网站、文档库和可选子文件夹。必须在文件中考虑所有六列，即使不需要给定字段的值。还可以在文件中包括列标题。

以下是 CSV 文件的格式示例。行显示正从本地文件共享迁移过来的文件。可以选择在文件中包括标题行。

使用 CSV 文件时的示例格式。

此示例显示它在具有列标题的 .txt 文件中的显示方式。

FileSharePath,,,SharePointSite,DocLibrary,DocSubFolder
\\MigrationTests\testfiles,,,https://contoso.sharepoint.com/sites/sitecollection,Documents,SubFolderName
\\MigrationTests\testfiles,,,https://contoso-my.sharepoint.com/personal/user_contoso_onmicrosoft_com,Documents,

创建用于数据迁移的 CSV 文件的具体步骤

以下示例使用 Excel 创建 CSV 文件。

启动 Excel。
输入迁移作业的值。每行输入一个迁移源和迁移目标。有关列的进一步说明，请参阅以下列表。
- 列 A：输入文件共享路径。 必需。
- 列 B：将此列留空。此列不适用于文件共享迁移。
- 列 C：将此列留空。此列不适用于文件共享迁移。
- D 列：输入要迁移文件的 SharePoint 网站 URL 或 OneDrive 电子邮件/URL。 必需。
- 列 E：输入文件要迁移到的 SharePoint 网站中文档库的名称。 必需。
- 列 F：在文档库中输入子文件夹的名称。如果此列留空，则文件将移动到根级别。 可选。
关闭并另存为逗号分隔 (*.csv) 文件。

使用 JSON 文件进行批量上传

以下示例显示在数据迁移中使用的 JSON 格式。所需的最小值为 SourcePath、TargetPath 和 TargetList。


{

  "Tasks": [

    {
      "SourcePath": "\\\\contoso\\fileshare\\dept1",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "TargetList": "Documents",
      "TargetListRelativePath": "dept1",

      "Settings": {

        "MigrateHiddenItems": true,
        "MigrateItemsCreatedAfter": "2016-05-22",
        "MigrateItemsModifiedAfter": "2016-05-22",
        "SkipFilesWithExtensions": "txt:mp3",
        "MigrateOneNoteNotebook": true
      }
    },

    {

      "SourcePath": "\\\\contoso\\fileshare\\dept2",
      "TargetPath": "https://a830edad9050849387E18042320.sharepoint.com",
      "TargetList": "Documents",
      "TargetListRelativePath": "dept2",

      "Settings": {

        "MigrateHiddenItems": true,
        "MigrateItemsCreatedAfter": "2016-05-22",
        "MigrateItemsModifiedAfter": "2016-05-22",
        "SkipFilesWithExtensions": "txt:mp3",
        "MigrateOneNoteNotebook": false,

      }

    }
  ]
}

通过