首次注册 Microsoft 365 时,系统会自动创建一个 *.onmicrosoft.com 域名,SharePoint 和 OneDrive 的 URL 也会使用这个域名。如果不满意这个随机生成的域名,或者需要进行品牌重塑,可以通过以下方法修改 SharePoint 的 onmicrosoft 域名。

一、重要限制与注意事项

在开始之前,请务必了解以下限制:

项目 说明
影响范围 仅影响 SharePoint 和 OneDrive URL,不会影响电子邮件地址
重命名间隔 只能每六个月重命名一次
不可逆 不支持将域名改回原始名称
重定向 原域名会自动创建永久性重定向
多地理位置 已设置多地理位置的组织不适用此功能

二、准备工作

2.1 检查新域名是否可用

在浏览器中访问 https://你的新域名.sharepoint.com

  • 如果返回 404 或提示找不到 → 该域名可用
  • 如果需要登录或显示用户信息 → 该域名已被占用,需要换一个

2.2 添加新的 onmicrosoft.com 域名

必须使用以下链接,直接在 Azure AD 后台是找不到这个选项的!

访问链接: https://aka.ms/SPORenameAddDomain

操作步骤:

  1. 使用 Edge 浏览器打开上述链接(Chrome 可能无法正常加载)
  2. 使用 Microsoft 365 全局管理员账号登录
  3. 点击 Add Custom Domain添加自定义域
  4. 输入新的域名前缀,例如 username.onmicrosoft.com
  5. 点击确认添加

注意事项:

  • 添加后无法删除
  • 每个账户最多只能添加 30 个 onmicrosoft 域名

三、通过 PowerShell 执行重命名

3.1 安装 SharePoint Online 管理工具

下载并安装 SharePoint Online Management Shell:

下载 SharePoint Online Management Shell

3.2 连接到 SharePoint 管理中心

首先确认你的管理域名:

打开 OneDrive,地址栏格式为 https://你的前缀-my.sharepoint.com/personal/...,其中 你的前缀 就是当前域名。

1
2
3
4
5
# 连接到 SharePoint 管理中心
Connect-SPOService -Url "https://你的前缀-admin.sharepoint.com"

# 例如
Connect-SPOService -Url "https://username-admin.sharepoint.com"

执行后会弹出登录窗口,使用管理员账号登录。

3.3 计划并执行重命名

1
2
# 执行重命名计划
Start-SPOTenantRename -DomainName "新前缀" -ScheduledDateTime "2026-05-01T10:00:00"

参数说明:

参数 说明 示例
-DomainName 新域名前缀(不含 .onmicrosoft.com) contoso
-ScheduledDateTime 生效时间(格式:年-月-日T时:分:秒) 2026-05-01T10:00:00

时间要求:

  • 必须设置为当前时间 24 小时之后
  • 最长可设置为 30 天之后
  • 时区与电脑系统时区一致

执行确认:

执行命令后会提示确认,输入 Y 确认操作。

四、监控与管理

4.1 查询重命名状态

1
2
# 查看整体重命名状态
Get-SPOTenantRenameStatus

状态说明:

状态 含义
Queued 已排队,等待执行
InProgress 正在进行中
Success 已完成

4.2 查看单个站点进度

1
2
# 查看单个站点重命名状态
Get-SPOSiteRenameState -ParentOperationId <RenameJobID>

4.3 取消重命名

如果需要取消重命名,可在计划时间之前执行:

1
2
# 取消重命名(必须在计划时间之前执行)
Stop-SPOTenantRename

五、验证更改是否成功

  1. 登录 Microsoft 365 管理中心
  2. 左侧菜单点击 显示所有SharePoint
  3. 检查地址栏是否显示新的域名

六、常见问题

Q: 报错 -722 是什么原因?

A: 计划的重命名时间距离现在不足 24 小时,请重新设置一个更晚的时间。

Q: 可以将域名改回原来的吗?

A: 不支持。微软只允许重命名一次,不支持回退。

Q: 重命名过程中会影响用户使用吗?

A: 会有一定影响。重命名期间将暂时阻止创建新的 OneDrive 和网站(如 Teams 新团队)。

参考链接