如何通过Microsoft Graph创建统一组时指定邮件域名？

你遇到的这个问题很常见——mail属性确实是只读字段，直接设置它肯定会触发报错。要在创建统一组时指定租户内的目标域名，正确的思路是通过proxyAddresses属性来定义组的邮件地址，而非直接操作mail字段。

具体操作步骤如下：

• 先确认目标域名已完成租户验证：这是前提，必须保证你想使用的域名已经在Microsoft 365租户中通过验证，否则无法用于组的邮件地址配置。
• 构造请求体时使用proxyAddresses字段：在创建组的请求里，添加proxyAddresses数组，用大写的SMTP:前缀标记主邮件地址（这个地址最终会自动填充到只读的mail属性中）；如果需要添加别名，可以用小写smtp:前缀。同时别忘了设置mailNickname字段（这是组的邮件别名前缀，和域名无关）。

举个实际的请求体例子，假设你要创建一个主邮件地址为marketing-team@contoso.eu的统一组：

{
  "displayName": "Marketing Team",
  "mailNickname": "marketing-team",
  "groupTypes": ["Unified"],
  "mailEnabled": true,
  "securityEnabled": false,
  "proxyAddresses": [
    "SMTP:marketing-team@contoso.eu",
    "smtp:marketing-team@contoso.com" // 可选的邮件别名
  ]
}

• 发送创建请求：用上述请求体调用创建组的API后，Graph会自动将SMTP:开头的地址设为组的主邮件地址，同时完成mail属性的赋值。

额外注意事项：

• mailEnabled必须设为true，否则无法配置任何邮件相关属性。
• proxyAddresses里的主地址不一定非要和mailNickname完全匹配，但保持格式一致会更规范，避免后续管理混淆。
• 这种方法支持指定租户内任意已验证的域名作为组的主邮件地址，不需要依赖租户的默认域名设置。

如果创建后需要修改主邮件地址，也可以通过更新proxyAddresses属性实现：把原主地址改成小写smtp:前缀，新地址设为大写SMTP:前缀即可。

内容的提问来源于stack exchange，提问作者Oliver