SDS 疑难解答

  • 项目

排查属性映射和值问题

启用 Sync 时，学生和教师需要源目录和目标目录之间的匹配属性，以便将两个目录之间的用户对象相关联。 以下说明包含有关检查学生和教师的源属性和目标属性的分步说明，这些属性由同步方法详细说明。

检查源目录 - CSV 文件

将 SDS 同步配置为 CSV 文件作为源目录时，CSV 中提供了下面列出的三个属性，用于匹配 Azure AD 中用户对象的属性。

  • 用户 用户名是 Student 和 Teacher csv 文件中的标头字段，可以设置格式以匹配 UserPrincipalName、mailNickname 或 Mail) (任何可用的目标目录选项。 若要检查此属性的值，请检查包含用户的学生或教师 csv。

  • 学生编号/教师编号 学生编号是 Student csv 文件中的标头字段，教师编号是 Teacher csv 文件中的标头字段。 此属性的相应格式设置是一个没有空格的 alpha 数字字符的简单字符串，它可以提供与 Azure AD 中用户的 mailNickname 属性的直接匹配。 还可以使用域后缀追加此源属性，以匹配 Azure AD 中的 UserPrincipalName 或 Mail 属性。 若要检查此属性的值，请检查包含用户的学生或教师 csv。

  • 辅助Email辅助Email是学生或教师 csv 文件中的标头字段，只能设置格式以匹配 Azure AD 中的 UserPrincipalName 或 Mail 属性。 它要求域后缀包含在 CSV 文件中包含的值中。 若要检查此属性的值，请检查包含用户的学生或教师 csv。

检查源目录 - PowerSchool

将 SDS 同步配置为 PowerSchool 作为源目录时，PowerSchool 中提供了下面列出的三个属性，用于匹配 Azure AD 中用户对象的属性。

用户 PowerSchool 中的此属性称为 学生用户名 或 教师用户名。 若要检查 PowerSchool 中学生或教师的此属性的值，请执行以下步骤：

  1. 以管理员身份登录到 PowerSchool。

  2. 在 PowerSchool 门户中，为学生选择 “学生 ”选项卡或“教师 教职员工 ”选项卡。

  3. 搜索用户。 找到后，选择用户。

  • 如果 学生在 “信息 ”部分下的左窗格中选择 “访问帐户”。 PowerSchool 中学生的用户名称为 “学生用户名”。

  • 如果 “教师”，请在“ 函 数”部分下的左窗格中，选择 “安全设置”。 PowerSchool 中教师的用户名称为 教师用户名。

学生编号/教师编号 PowerSchool 中的此属性称为 学生学生号 和教师 ID 。 若要检查 PowerSchool 中学生或教师的此属性的值，请执行以下步骤：

  1. 以管理员身份登录到 PowerSchool。

  2. 在 PowerSchool 门户中，为学生选择 “学生 ”选项卡或“教师 教职员工 ”选项卡。

  3. 搜索用户。 找到后，选择用户。

  • 如果是 “学生”，则在用户选择之前，学生号码将显示在主搜索页上。 PowerSchool 中的学生编号称为 “学生编号”。

  • 如果 “教师”，请在“ 函 数”部分下的左窗格中选择 “信息”。 PowerSchool 中的教师编号称为 ID。

辅助Email Clever 中的此属性称为学生和教师的电子邮件。 若要检查 Clever 中学生或教师的此属性的值，请执行以下步骤：

  1. 以管理员身份登录到 PowerSchool。

  2. 在 PowerSchool 门户中，为学生选择 “学生 ”选项卡或“教师 教职员工 ”选项卡。

  3. 搜索用户。 找到后，选择用户。

  • 如果“学生”，请在“信息”部分下的左窗格中，选择“学生Email”。 PowerSchool 中学生的辅助Email称为Email地址。

  • 如果 “教师”，请在“ 函 数”部分下的左窗格中选择 “信息”。 PowerSchool 中教师的辅助Email称为Email地址。

检查目标目录 - Azure AD

配置 SDS 同步时，目标目录始终为 Azure Active Directory。 下面列出的三个属性可用于匹配源目录中用户对象的属性。

UserPrincipalName

通过Office 365管理中心检查 UserPrincipalName

  1. 在专用浏览器中启动 Internet Explorer。

  2. 导航到 portal.office.com。

  3. 使用全局管理员帐户登录到Microsoft 365 管理中心。

  4. 导航到“管理员”磁贴>“”用户“选项卡”>活动用户”。

  5. 搜索要检查的用户。

  6. 在用户上选择。

请注意标题字段中列出的 UserPrincipalName。

通过 PowerShell 检查 UserPrincipalName

  1. 使用导入的适用于 PowerShell 的 Azure AD 模块以管理员身份启动 PowerShell。
Import-Module msonline
  1. 运行以下命令以连接到 Azure AD。 出现提示时输入全局管理员凭据。
$Cred = Get-Credential
Connect-MsolService -credential $cred
  1. 连接后，运行以下命令以检查单个用户的 UserPrincipalName。 显示一个示例，其中用户的姓名是博伊德·考利。
Get-MsolUser -SearchString "<Display Name>" | FL UserPrincipalName

Ex. Get-MsolUser -SearchString "Boyd Cowley" | FL UserPrincipalName

> [！注意] >搜索字符串参数将搜索要查找的用户，并且将仅返回具有电子邮件地址或显示名称（以此字符串开头）的用户。 有关Get-MsolUser cmdlet 的详细信息，请参阅 [https://msdn.microsoft.com/library/dn194133.aspx] (/previous-versions/azure/dn194133 (v=azure.100) ) 。

mail (primarysmtpaddress)

通过Office 365管理中心检查“邮件” (主机板地址)

  1. 在专用浏览器中启动 Internet Explorer。

  2. 导航到 portal.office.com。

  3. 使用全局管理员帐户登录到Microsoft 365 管理中心。

  4. 导航到“管理员”磁贴>“”用户“选项卡”>活动用户”。

  5. 搜索要检查的用户。

  6. 在用户上选择。

  7. 在“更多设置”部分中选择“编辑 Exchange 属性”。

  8. 选择电子邮件地址。

邮件属性将使用该类型的大写 SMTP 进行注释，并以粗体列出。

通过 PowerShell 检查邮件 (主机板地址)

  1. 使用导入的适用于 PowerShell 的 Azure AD 模块以管理员身份启动 PowerShell。
Import-Module msonline
  1. 运行以下命令以连接到 Azure AD。 出现提示时输入全局管理员凭据。
$Cred = Get-Credential
Connect-MsolService -credential $cred
  1. 连接后，运行以下命令以检查单个用户的“邮件”属性。 显示一个示例，其中用户的姓名是博伊德·考利。
Get-MsolUser -SearchString "<Display Name>" | FL proxyaddresses

Ex. Get-MsolUser -SearchString "Boyd Cowley" | FL proxyaddresses
  1. Proxyaddresses 是一个多值属性，可能包含多个条目。 具有大写 SMTP 的地址是用户的主板地址，是 Azure AD 中的“邮件”属性。

注意

搜索字符串参数将搜索要查找的用户，并且将仅返回具有电子邮件地址或显示名称（以此字符串开头）的用户。 有关Get-MsolUser cmdlet 的详细信息，请参阅 https://msdn.microsoft.com/library/dn194133.aspx。

mailNickname（别名）

通过Office 365管理中心检查 mailNickname (别名)

  1. 在专用浏览器中启动 Internet Explorer。

  2. 导航到 portal.office.com。

  3. 使用全局管理员帐户登录到Microsoft 365 管理中心。

  4. 导航到“管理员”磁贴>“”用户“选项卡”>活动用户”。

  5. 搜索要检查的用户。

  6. 在用户上选择。

  7. 在“更多设置”部分中选择“编辑 Exchange 属性”。

  8. 选择“常规”。

mailnickname (*Alias) 属性将显示在以下 displayname 中。

通过 PowerShell 检查 mailNickname (别名)

  1. 使用导入的适用于 PowerShell 的 Azure AD 模块以管理员身份启动 PowerShell。
Import-Module msonline
  1. 运行以下命令以连接到 Azure AD 并Exchange Online。 出现提示时输入全局管理员凭据。
$Cred = Get-Credential
$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell/ -Credential $Cred -Authentication Basic -AllowRedirection
Import-PSSession $Session
Connect-MsolService -credential $cred
  1. 连接后，运行以下命令以检查单个用户的“邮件”属性。
Get-MsolUser -SearchString "<Display Name>" | FL proxyaddresses

  1. Proxyaddresses 是一个多值属性，可能包含多个条目。 具有大写 SMTP 的地址是用户的主板地址，是 Azure AD 中的“邮件”属性。

  2. 运行以下行以拉取用户的别名值

Get-Recipient <primarysmtpaddress> | FL Alias

搜索字符串参数将搜索要查找的用户，并且仅返回具有电子邮件地址或显示名称（以此字符串开头）的用户。 有关Get-MsolUser cmdlet 的详细信息，请参阅 https://msdn.microsoft.com/library/dn194133.aspx。