使用 Graph API 预填充 Outlook 联系人

随着许多组织现在允许用户在任何地方、在任何设备上工作，一系列新的挑战已经浮出水面。例如，在办公室外工作的新用户可以通过了解如何联系 IT 服务台、人力资源和其他内部服务部门而受益。

此信息通常可以在全局地址列表 (GAL) 中轻松获得。在移动设备上查找此信息变得更加困难，因为电子邮件客户端通常无法访问 GAL。例如，Outlook mobile 仅将个人联系人同步到设备。

为了解决这个问题，我创建了一个 PowerShell 脚本来从 CSV 文件中读取一组标准联系人，并将它们作为个人联系人写入用户邮箱。然后，移动设备可以将这些联系人与用户创建的其他联系人同步。

创建注册应用程序

该脚本使用 Graph API 来配置联系人，因此我们需要在 Azure AD 中注册一个应用程序来保存权限和身份验证（这是通过 PowerShell 使用 Graph 的另一个示例）。在 Azure AD 门户中创建新的应用程序注册并添加Contacts.ReadWrite应用程序权限。确保授予管理员同意权限，以允许脚本访问所有用户的联系人：

返回到应用属性，记下“概览”页面中的应用程序（客户端）ID 和目录（租户）ID：

最后，打开证书和机密页面并创建一个新的客户端机密。请注意秘密的值。应用程序标识符、租户标识符和应用程序密钥的组合将允许我们的脚本进行身份验证并使用分配的权限与用户邮箱进行交互。

注意：由于密钥用于验证应用程序注册，因此请将此密钥视为密码，并以纯文本形式存储它时要小心。

准备联系人导入文件

该脚本从 CSV 文件中读取联系人列表。 GitHub 上提供了示例文件，其中包含以下列：

• 助理姓名
• 商业主页
• 商务手机
• 公司名称
• 部门
• 电子邮件地址
• 给定的名称
• 职称
• 中间名字
• 昵称
• 职业
• 个人笔记
• 姓
• 标题

其中每个值都直接映射到您在 Outlook 联系页面上看到的值。所有值都是可选的，因此如果不需要，请将其留空。示例条目已填充到文件中，可以替换为您的第一个条目。您可以在 CSV 中添加任意数量的条目。该脚本会将 CSV 中的每个项目添加为目标邮箱中的个人联系人：

运行脚本

准备好导入文件后，从 GitHub 下载脚本并将其保存在本地。该脚本需要以下参数：

• 邮箱 - 这是目标邮箱的 UPN。
• CSVPath - 这是导入 CSV 的完整路径。
• ClientID - 这是已注册应用程序的应用程序 ID。
• ClientSecret - 这是之前创建的 Secret 值。
• TenantID - 这是租户的目录 ID。

掌握每个参数后，可以通过指定目标邮箱的 UPN 为单个用户运行该脚本：

##Declare Parameters##
$mailbox = [email protected]
$clientSecret = <Client Secret Value>
$clientID = <Application (Client) ID Value>
$tenantID = <Directory (Tenant) ID Value>
$CSVPath = <Full path to the import CSV>
##Run Script##
.\graph-PopulateContactsFromCSV.ps1 -Mailbox $mailbox -ClientSecret $clientSecret -ClientID $clientID -TenantID $tenantID -CSVPath $csvPath

该脚本在配置时以 JSON 格式显示每个联系人的详细信息：

一些附加逻辑允许脚本将联系人集添加到所有邮箱。为此，请连接到 Exchange Online 命令行管理程序并按如下方式运行。这将获取环境中所有用户邮箱的列表，然后为每个用户运行导入脚本：

##Declare Parameters##
$clientSecret = <Client Secret Value>
$clientID = <Application (Client) ID Value>
$tenantID = <Directory (Tenant) ID Value>
$CSVPath = <Full path to the import CSV>
##Run Script##
$mailboxes = Get-EXOMailbox -resultsize unlimited -RecipientTypeDetails usermailbox
Foreach($mailbox in $mailboxes){
.\graph-PopulateContactsFromCSV.ps1 -Mailbox  $mailbox.UserPrincipalName -ClientSecret $clientSecret -ClientID $clientID -TenantID $tenantID -CSVPath $csvPath
}

脚本完成后，联系人将出现在用户的个人联系人中，并且可以同步到他们的设备：

概括

通过少量的准备工作，此脚本可以轻松地为任意数量的用户填充联系人。新的联系人可以同步到移动设备，并且可以随时随地使用。

脚本和导入文件示例均可在 GitHub 上获取。

注意：一如既往，请确保在生产环境中运行任何代码之前对其进行检查和测试。