适用于学校数据同步的 PowerShell

  • 项目

使用学校数据同步 (SDS) 和Microsoft Entra ID时，在 PowerShell 中执行任务和操作非常有用。 借助 PowerShell，可以轻松完成批量操作和脚本化操作。 本文介绍开始将 PowerShell 与 Microsoft Entra ID 和学校数据同步配合使用的设置和先决条件，使管理员能够使用 PowerShell 作为工具更好地管理其同步的 SDS 数据。

有关参考，可在此处找到 SDS PowerShell 脚本。

安装 Microsoft Graph PowerShell SDK

对于 PowerShell 中的 SDS 对象管理，建议安装 Microsoft Graph PowerShell。 若要查看先决条件并安装这两个模块，请按照以下说明操作：

安装 Microsoft Graph PowerShell。

确认安装和导入模块

安装后，确认模块已成功安装。 该命令也是将模块加载到 PowerShell 中的方式。 将模块加载到 PowerShell 中可以运行与模块关联的 cmdlet。

若要确认模块是否已安装并导入到 PowerShell 中，请执行以下步骤：

  1. 启动 PowerShell。

  2. 运行此命令以确保成功加载并安装模块。

    Get-InstalledModule Microsoft.Graph

    注意

    如果已安装在系统上，该命令将返回 Microsoft Graph 模块的已安装版本、名称和参数。

  3. 若要导入 Microsoft Graph 模块，请运行以下命令：

    Import-Module Microsoft.Graph

使用 PowerShell 连接到Microsoft Entra ID

导入模块后，需要将 PowerShell 连接到 Microsoft Entra ID，以针对 Microsoft Entra 目录运行与每个模块关联的命令。

注意

你将使用委派访问权限以用户身份登录。 每个会话只需登录一次。

  1. 将 Microsoft Graph 模块连接到Microsoft Entra ID。

    Connect-MgGraph -Scopes 
"User.Read.All","Group.ReadWrite.All"

  2. 该命令会提示你导航到要进行身份验证的网页。

  3. 选择“下一步”按钮或“登录”以继续。 它请求你代表组织提供连接到 Microsoft Graph PowerShell 的权限和同意。

  4. 启用“代表组织同意”复选框，然后选择“接受”按钮。

  5. 在成功验证时，PowerShell 终端会显示“欢迎使用 Microsoft Graph！