如何通过使用 OneRoster CSV 文件部署学校数据同步

重要:  本文是由机器翻译的,请参阅免责声明。请在 此处 中查找本文的英文版本以便参考。

注意: 

您可以使用 OneRoster 逗号分隔值 (CSV) 文件学校数据同步 (SDS) 导入和同步您学生信息系统的 (SIS) 学生、 教师、 学校、 分区和花名册使用 Office 365 的信息。要部署 SDS 使用此同步方法,从您 SIS 导出 OneRoster 格式的 CSV 文件,将它们转换为学校数据同步所需的格式使用我们工具包,然后将文件上载到学校数据同步和 Azure AD。

本主题内容:

开始之前

在使用“CSV 导入”与 SDS 进行同步之前,请阅读学校数据同步与 Classroom 概述

若要完成此过程,您必须安装 Microsoft 学校数据同步工具包。此工具可帮助您转换 CSV 导出、 添加和更新您的用户 SIS 和 Office 365 之间同步,也可用于验证的 CSV 文件数据。有关详细信息,请参阅安装 Microsoft 学校数据同步工具包

请确保满足下列先决条件:

  • Office 365 教育版租户。

  • 全局管理员权限

  • CSV 文件不能包含任何字符显示在此列表中的无效字符

  • CSV 文件不能包含的数据的行数超过 500000。如果超出 500 K 行限制的任何 CSV 文件,关闭其他行拆分为另一个组 6 CSV 文件,并创建其他同步配置文件上载和同步这些其他对象和属性。

如果要为通过 AADConnect 从本地 Active Directory 进行同步的租户配置学校数据同步,可能会注意到 miisclient 中所显示的断电器的数量有所增加。这是因为 Office 365 组无法同步回 AADConnect Metaverse 和本地 Active Directory。这些警告对当前的 AADConnect 部署无任何不利影响,仅提供有关同步失败结果的信息说明。在 SDS 中启用同步后应预期 AADConnect 中会出现这些警告,因为这会为每个通过 SDS 同步的班级创建一个 O365 组。

注意: 第三方应用程序提供商可经由其应用访问通过学校数据同步提供的数据,因此,请仅同步要使第三方可用的数据。

导入 CSV 文件以创建配置文件

请确保您导出 OneRoster 格式中的 CSV 文件,并且他们已准备好使用。然后按照这些步骤将转换文件,创建您的配置文件同步。

  1. OneRoster CSV 文件保存在 C:\temp 目录中。

  2. 安装学校数据同步工具包。

  3. 创建一个称为 c:\temp\csvs 子文件夹。

  4. 创建一个称为 c:\temp\sdslogs 子文件夹。

  5. 运行转换 OneRosterToMicrosoftSDS 命令,使用以下语法:

    Convert-OneRosterToMicrosoftSDS -onerosterfolderpath “c:\temp” -sdsfolderpath “c:\temp\csvs” -logpath “c:\temp\logs”
  6. 转到 c:\temp\csvs 目录,然后验证存在新 SDS 转换文件。

  7. 在 web 浏览器中,转到 sds.microsoft.com,,并为您的 Office 365 教育版租户中使用全局管理员凭据登录。

  8. 如果这是您首次登录和设置配置文件,您必须选择启用/禁用 SDS 和 Microsoft 课堂。要启用学校数据同步,并继续进行安装,请切换学校数据同步切换到位置。

    屏幕截图显示学校数据同步中的设置,用于打开或关闭学校数据同步。

    启用学校数据同步设置后,选择添加配置文件以创建 SDS 同步配置文件,然后开始同步您 SIS 中的数据。

    屏幕截图显示学校数据同步菜单中的“添加配置文件”选项。
  9. 在“输入配置文件名称”框中,输入配置文件名称。

    屏幕截图显示在学校数据同步中添加配置文件期间的“输入配置文件的名称”
  10. 数据提取部分中,在选择数据源下拉菜单中选择CSV 文件

    屏幕截图的数据提取选项,期间添加在学校数据同步的配置文件
  11. 在“数据提取”部分中,选择“新建用户”或“同步现有用户”。

    屏幕截图显示在学校数据同步中添加配置文件期间,创建和同步新用户数据或同步现有用户数据的配置文件选项
    • 创建新用户如果您不从本地 Active Directory 同步标识或同步的范围中的用户不会创建 Microsoft Azure Active Directory 中已,选择此选项。此选项将创建新的学生和教师 CSV 文件中的用户的用户帐户。

    • 同步现有用户如果您从本地 Active Directory 同步标识或已创建在 Azure AD 同步的范围中的用户,请选择此选项。此选项不会创建新的学生和教师 CSV 文件中的用户的用户帐户。

  12. 如果您选择创建新用户选项,跳过此步骤。.如果选中同步现有用户选项,选择相应的标识匹配可用下拉菜单中的选项。这是在其中将定义如何匹配的学生和教师从 CSV 文件向 Office 365 中其用户帐户。观看有关如何选择适当的源、 后缀和目标值的其他信息的标识匹配视频和正确配置的标识与下面列出的设置相匹配。

    标识匹配选项 - 学生和教师

    屏幕截图显示在学校数据同步中同步学生的 3 个设置,包括源属性、后缀和目标属性。

    屏幕截图显示在学校数据同步中同步教师的 3 个设置,包括源属性、后缀和目标属性。

    选择源属性此下拉菜单允许您选择从 CSV 文件,用于标识匹配来源属性。

    • 辅助电子邮件CSV 文件中的辅助电子邮件属性 (例如: JohnSmith@contoso.com)

    • 学生数CSV 文件中的学生号码属性 (例如: 1234567)

    • 用户名CSV 文件中的用户名属性 (例如: JohnSmith 或 JohnSmith@contoso.com)

    选择后缀 此下拉菜单允许在所选源属性后面追加域后缀。将列出已添加到你租户的所有域。

    选择目标属性 此下拉菜单允许选择 Office 365 中的目标属性,以完成源和目标的匹配。

    • UserPrincipalName登录名用户 (例如 JohnSmith@contoso.com)

    • 邮件PrimarySmtpAddress 的用户名 (例如 JohnSmith@contoso.com)

    • mailNicknameExchange 别名 (例如 1234567) 的用户

  13. 正确设置“配置文件名称”、“数据提取选项”和“标识匹配选项”后,请选择“下一步”。

  14. 目录选项页面中,选择可用的每个下拉列表的相应域。如果您在步骤 11 中选择同步现有用户选项,您只需要学校和节中选择相应的域,因为所有现有的学生和教师的已有域与其各自的用户帐户相关联。此域将用作Office 365组中的域后缀创建的每一节,除非策略处于覆盖此域设置的位置。通过选中分配 Microsoft 课堂许可证复选框,也可能会将教室许可证分配给同步,范围内的所有用户。如果您想要允许 SDS 保持在 O365 中的部分/组显示名称的控制,请选中同步选项分区组的显示名称复选框。如果您愿意 SDS 创建组的显示名称基于初始 SDS 同步,但允许的教师覆盖和维护自定义显示名称,在第一次同步完成后,请选中第二个复选框。

    屏幕截图显示学校数据同步中同步配置文件的域选择、分配 Microsoft Classroom 许可证的复选框,以及同步分区组显示名称的复选框

    如果您在步骤 11 中选择创建新用户选项,您将需要除了域为教师和学生,域学校和部分中,选择相应的域如下所示。此域将用作 SDS,通过创建的每个用户的学生和教师的 csv 文件中包含的用户帐户域后缀。

    在单一同步配置文件中,仅可为教师和学生分别输入一个域。如果具有必须扩展至多个域的对象类型,则必须为每个用户集创建单独的配置文件(每个域对应一个同步配置文件)。

    屏幕截图显示学校数据同步中的学校/分区、教师和学生的域选择
  15. 如果您在步骤 11 中选择创建新用户选项,您还必须选择适当的 SKU 将分配给每个新创建的教师和学生使用如下所示的下拉菜单。每个可用 SKU Office 365租户中将显示在列表中。您也可以选择的教室,将这些用户许可证,通过选中下面显示的复选框。完成设置向导的这一部分之后,选择下一步

    屏幕截图显示学校数据同步中用于新用户的 SKU 和许可证选择
  16. 选择要同步属性页面上,选择每您打算同步 (必需和可选) 为每个 CSV 文件的属性。此页面上选择每个属性应该相关到 CSV 文件中包含的每个属性标头字段。CSV 文件学校数据同步的详细信息 (在灰色) 所需的属性和可选属性可用于同步,并为每个 CSV 文件格式的要求。此页面上选择了所有适当的属性后,选择下一步

    屏幕截图显示学校数据同步配置文件中要同步的属性类别
  17. 在“摘要”页面上,选择“提交”以创建配置文件。

  18. 在 SDS 门户的“配置文件集合”部分中,选择刚才创建的配置文件。

  19. 选择上载文件,以便您可以选择和上载您的 CSV 文件。

  20. 选择添加文件,选择要上载后,您 CSV 文件,然后选择上载

    对话框的屏幕截图要将选定的文件上载到同步配置文件。

    上传过程中会验证 CSV 文件。如果存在错误,系统会列出错误,以便更正和重试。

  21. 上载文件的后选择开始同步选项以开始同步到 Azure AD CSV 数据

    屏幕截图显示学校数据同步的仪表板上已完成配置文件的选项,包括“开始同步”选项

视频:如何匹配用于同步的源属性和目标属性

有关各种示例匹配逻辑成功或失败同步的信息,观看标识匹配。

你的浏览器不支持视频。请安装 Microsoft Silverlight、Adobe Flash Player 或 Internet Explorer 9。

注意: 机器翻译免责声明:本文是由无人工介入的计算机系统翻译的。Microsoft 提供机器翻译是为了帮助非英语国家/地区用户方便阅读有关 Microsoft 产品、服务和技术的内容。由于机器翻译的原因,本文可能包含词汇、语法或文法方面的错误。

另请参阅

学校数据概述同步和教室

学校数据同步的 CSV 文件

学校数据同步所需 PowerSchool 同步的属性

如何部署学校数据同步使用 CSV 文件

如何部署使用 PowerSchool 同步学校数据同步

如何部署使用聪明同步学校数据同步

学校数据同步错误和疑难解答

扩展你的技能
了解培训
抢先获得新功能
加入 Office 预览体验计划

此信息是否有帮助?

谢谢您的反馈!

谢谢你的反馈! 可能需要转接到 Office 支持专员。

×