更改 SharePoint 域名（预览）
首次注册 Microsoft 365 时，你创建了一个 onmicrosoft.com 域。 即使你后来添加了自定义域，原始 onmicrosoft.com 域也将用于所有 SharePoint 和 OneDrive URL。
如果你的组织已进行品牌重组、合并或收购，并且需要在 SharePoint 和 OneDrive URL 中更改域，则现在可以使用 PowerShell 执行此操作。 例如，如果组织名称从 Contoso 更改为 Fabrikam，则现在可以将 SharePoint URL 从 contoso.sharepoint.com 更改为 fabrikam.sharepoint.com。
重要
此功能以公共预览版提供，目前可供总共不超过 10，000 个 SharePoint 网站和 OneDrive 帐户的组织使用，这比 2022 年 8 月 23 日之前限制的 5，000 个网站数有所提高。 如果尝试启动域重命名时收到错误 773“未实现”，则表示尚未为你的组织启用该功能，因为我们仍在推出该功能。请稍后再试。
备注
- 此更改仅影响 SharePoint 和 OneDrive URL。 不会影响电子邮件地址。
- 有关将网站地址从
https://contoso.sharepoint.com/sites/sample1更改为https://contoso.sharepoint.com/sites/sample2的信息，请参阅更改网站地址。 - 此功能不适用于已设置多地理位置的组织。
- 此功能不适用于 Microsoft 365 政府 GCC High 和 DoD 客户。
- 当你重命名 SharePoint 域时，我们会在之前的地址创建重定向。
- 只能每六个月重命名一次 SharePoint 域。
- 不支持重命名 SharePoint 域名后将其更改回原始名称。 例如，如果你将 SharePoint 域从
contoso.sharepoint.com更改为fabrikam.sharepoint.com，则不支持将其更改回contoso.sharepoint.com。 - 上一个名称中的重定向是永久性的，不会过期。
限制
低影响
| 应用/功能 | 限制 | 必需的操作 |
|---|---|---|
| 中心网站菜单项 | 尽管菜单项将继续工作，但包含绝对 URL 的项不会更改。 | 编辑菜单项，并在必要时，将 URL 更改为新域名。 |
| Office“最近使用”和“已固定”列表 | 这些列表会根据使用情况随时间更新。 | 无 |
| Office.com | https://www.office.com 的 URL 可能需要 24 小时才能更新。 | 无 |
| OneDrive | 仅更改 URL 中的域名部分。 基于用户主体名 (UPN) 的相对路径不会更改。 | 无 |
| Microsoft OneDrive 同步应用 (OneDrive.exe) | 要求所有用户使用版本 17.3.6943.0625 或更高版本。 | 确保 URL“oneclient.sfx.ms”和“g.live.com” 不会被阻止，并且组织中的所有计算机都可以访问它们以应用更新。 |
| Microsoft OneDrive 同步应用 (OneDrive.exe) | Office 应用中显示的组织名称不会更改。 （例如，应用显示旧文件夹名称 C：\Users\Sophia\OneDrive – Contoso） | 用户可以在 Office 应用中断开连接并重新连接其帐户。 |
| OneNote | 需要最新版本的 OneNote。 | 确保所有用户都已安装以下版本的 Office： OneNote 桌面应用：版本 16.0.8326.2096 或更高版本。 面向 Windows 10 的 OneNote：版本 16.0.8431.1006 或更高版本。 OneNote 移动应用：版本 16.0.8431.1011 或更高版本。 |
| OneNote | 更改域名时，用户可能会收到笔记本同步错误。 | 无 |
| SharePoint 移动应用 | 需要最新版本的移动应用。 | 确保所有用户都已安装以下版本的 Office： iOs：4.20.0 或更高版本。 Android：3.21.0 或更高版本。 |
| SharePoint 移动应用 | 更改域名时，用户可能会收到笔记本同步错误。 | 无 |
| 搜索和 Delve | 搜索索引可能需要一段时间才能反映新的 URL 更改。 | 无 |
| 搜索和 Delve | 搜索结果可能未完成，或者在更新搜索索引之前可能会返回原始 URL 的结果。 | 无 |
| SharePoint 内容 | 尽管包含域名的内容（如页面上的文本）将继续工作，但不会更新该内容以显示新名称。 | 搜索旧域名并编辑内容以显示新域名。 |
中等影响
| 应用/功能 | 限制 | 必需的操作 |
|---|---|---|
| 自定义应用和组策略对象 | 这些应用和对象中嵌入的绝对 URL 不会更改。 | 编辑包含绝对 URL 的自定义应用和 Active Directory 组策略对象，如有必要，请将 URL 更改为新域名。 与第三方应用发布者确认应用不包含绝对 URL。 |
| 自定义和第三方应用 | 某些应用可能无法正确处理 HTTP 308 直通。 | 编辑自定义应用并与第三方应用发布者协作，确保这些应用能够正确处理 HTTP 308 响应。 |
| Delve | 可能需要 24 小时才能查看人员配置文件。 | 无 |
| 电子数据展示 | 在更新 URL 之前，无法删除保留项。 | 在 Microsoft Purview 合规性门户中，将电子数据展示保留 URL 更改为新域名。 |
| InfoPath 表单 | 使用 SharePoint 连接作为数据源的窗体将不起作用。 | 将这些表单重新连接到 SharePoint。 |
| Microsoft Forms | 提供在回复中上传附件选项的表单将不起作用。 | 删除“上传”按钮，然后在表单中再次添加。 |
| Office 应用 | 更改域名时，用户在保存位于网站或 OneDrive 中的 Word、Excel 和 PowerPoint 文档时可能会遇到错误。 | 尝试再次保存文档，并在必要时更改保存位置的 URL。 |
| OneDrive | OneDrive 和 SharePoint 中的快速访问链接将不起作用。 | None |
| Power Automate | 使用 SharePoint 作为连接的请求注销流将不起作用。 | 删除并重新创建请求注销流。 |
| Power Automate | 任何部署为具有使用 SharePoint 作为连接的托管层的解决方案的流都将不起作用。 | 删除并重新创建流。 |
| Power BI | 使用 SharePoint 连接作为数据源的 Power BI 报表将不起作用。 | 在更改域名之前，请下载使用 SharePoint 连接作为数据源作为 .pbix 文件的 Power BI 报表。 更改域名后，编辑 Power BI Desktop 应用中的连接并重新发布报表。 Power BI 需要重新创建或维护未在 Power BI Desktop 应用中创建或维护的报表。 |
| Project Online | 处于“未完成”状态的工作流将无法完成，并将会孤立。 无法启动新的工作流实例。 与以前的工作流实例的关联不可用，将会孤立。 |
在更改域名之前，请确保已完成所有“未完成”的工作流。 更改域名后，重新发布工作流。 然后，可以转到“更改”或“重启工作流>PWA 设置”，在 Project Web App 中将其重置为“未完成”。 |
| Project Online | 工作流中嵌入的 URL 不会更改。 例如，如果工作流包含嵌入的 URL contoso.sharepoint.com，则不会更改。 这可能会影响工作流的功能。 |
包含引用原始域名的 URL 的工作流可能需要更新为新名称。 |
| Project Online | 对 https://project.microsoft.com 的 Project Online 中 PWA 网站的引用将不起作用。 | 在位于 https://project.microsoft.com 的 Project Online 中，更改“设置>我的 PWA 网站”下的 PWA 网站的 URL。 |
| Project Online | 使用 Microsoft Project 数据连接作为数据源的自定义 Excel 报表将不起作用。 | 需要重新连接这些报表。 |
| Project Pro | 在更新 PWA 站点的 URL 之前，应用将无法正常工作。 | 在更改域名之前，请确保在 Project Pro 中已签出的所有项目均已签入。 更改域名后，更改“文件>信息>管理帐户”下的 PWA 站点的 URL。 |
| SharePoint 2013 工作流 | 处于“未完成”状态的工作流将无法完成，并将会孤立。 无法启动新的 2013 工作流实例。 与以前的工作流实例的关联不可用，将会孤立。 |
在更改域名之前，请确保已完成所有“未完成”的工作流。 更改域名后，重新发布工作流。 |
| SharePoint 2013 工作流 | 工作流中嵌入的 URL 不会更改。 例如，如果工作流包含嵌入的 URL contoso.sharepoint.com，则不会更改。 这可能会影响工作流的功能。 |
包含引用原始域名的 URL 的工作流可能需要更新为新名称。 |
| SharePoint 外接程序 | 加载项可能无法按预期工作。 | 可能需要重新发布加载项。 查看 Azure AD 中加载项的应用配置设置，并将任何 URL 更新为新的域名。 对于 SPFx 应用程序，在 Azure AD 中，将身份验证 URL 更新为 SharePoint Online 客户端扩展性 Web 应用程序主体的新域。 |
| SharePoint 中心网站 | 注册为中心网站的站点将不起作用。 | 重命名后，在 SharePoint 管理中心注销受影响的网站并将其注册为中心网站。 |
| 网站自定义和嵌入代码 | SharePoint 自定义项中嵌入的绝对 URL 不会更新。 | 编辑包含绝对 URL 的自定义，如有必要，请将 URL 更改为新域名。 |
| Teams 网页版和 Teams 桌面应用 | The first time someone tries to access the Files tab for a team or private channel, they'll receive an error. The tab will work for all users after that. | 无 |
| Teams 网页版和 Teams 桌面应用 | 会议笔记可能需要 72 小时才能工作（适用于当前和以前的会议）。 | 无 |
| Teams 网页版和 Teams 桌面应用 | 在“文件”选项卡上，添加了“添加云存储”（指向另一个 SharePoint 网站）的任何文件夹都将不起作用。 | 删除并重新添加文件夹。 |
| Teams 网页版和 Teams 桌面应用 | 添加为选项卡的文档库将不起作用。 | 删除并重新添加选项卡。 |
| Teams 网页版和 Teams 桌面应用 | Wiki 中嵌入的图像不会显示。 | 编辑位于 SharePoint 站点 Teams Wiki 数据库中的 Wiki .mht 文件，如有必要，请将嵌入图像的 URL 更改为新域名。 |
| Teams 网页版和 Teams 桌面应用 | 个人 Wiki 将不起作用。 | 在一对一聊天或群组聊天中，附加文件并将其发送到聊天。 |
| 第三方应用包含备份解决方案 | 在这些第三方应用中嵌入的绝对 URL（包括备份解决方案）不会更改。 | 向第三方应用发布者确认（包括备份解决方案）是否支持租户重命名。 |
高影响
| 应用/功能 | 限制 | 必需的操作 |
|---|---|---|
| 商业生产力在线套件 (BPSO) 网站 | 如果租户中仍有 Microsoft 商业生产力在线套件 (BPOS) 网站，则无法更改域名。 | 无可用操作。 |
| 删除的网站 | 更改后，无法还原任何已删除的网站。 | 在更改域名之前，请查看 SharePoint Online 管理中心的“已删除网站”页面，并还原你可能想要保留的任何网站。 |
| 已锁定网站和 OneDrive 帐户 | 任何已锁定（LockState 为 NoAccess）的网站或 OneDrive 都无法重命名。 | Before changing your domain name, review any sites and OneDrive accounts that have been locked to determine if the lock should be removed. Lock and unlock sites |
| 多地理位置配置 | 如果你的组织当前或之前已设置为 Microsoft 365 多地理位置，则无法更改 SharePoint 域名。 | 无可用操作。 |
| 时间点还原 | 无法网站还原到域名更改之前的时间点。 | 无可用操作。 |
| 根网站替换 | 在计划域名更改和完成期间，无法替换根网站（使用 SharePoint 管理中心或 PowerShell cmdlet Invoke-SPOSiteSwap)。 | 在计划域名更改之前或完成后替换根网站。 |
| SharePoint 公共网站 | 如果租户包含旧的 SharePoint 公共网站，则将不允许更改 SharePoint 域名。 | SharePoint 公共网站已不再受支持。 删除公共网站，然后重试。 请参阅 要停用的 SharePoint Online 公共网站 |
| 特殊云和政府云 | 如果组织使用特定云或政府云 (GCC、GCC High、DoD 等)，则无法更改域名。 | 无可用操作。 |
| 虚域配置 | 例如，如果 SharePoint 域是 teams.Contoso.com（而不是 contoso.sharepoint.com），则无法更改域名。 | 无可用操作。 |
第 1 步：验证新域名
检查你想要的新域的可用性。 例如，如果希望 SharePoint 和 OneDrive URL 以
fabrikam.sharepoint.com开头，请在浏览器中输入https://fabrikam.sharepoint.com。 如果收到无法找到地址的消息 (404)，则该消息可能可用。 如果接收到登录屏幕或在 fabrikam.sharepoint.com 目录中找不到用户名的消息，则该域已占用，需要尝试其他域。 如果域已被其他客户注册，则我们无法提供任何信息，你也可以与客户联系。- 或者 -
如果你拥有另一个订阅的域，则需要 在 Azure AD 中删除该租户。 删除租户通常需要三天才能完成并使域可用。
警告
请勿先使用域在测试环境中测试此过程。 如果这样做，将无法将域用于生产环境。
转到 https://aka.ms/SPORenameAddDomain。
重要
必须使用链接 https://aka.ms/SPORenameAddDomain 转到 Azure AD 管理中心的自定义域名页面。 如果浏览页面而不是使用链接，则你将无法成功添加自定义 onmicrosoft.com 域。
选择 添加自定义域。
在“自定义域名”框中，输入完整的新“.onmicrosoft.com”域，然后选择“添加域”。
重要
添加域时，该域必须是“onmicrosoft.com”域。 例如，如果要将租户重命名为 fabrikam.sharepoint.com，则输入的域应为 fabrikam.onmicrosoft.com。 无需购买“onmicrosoft.com”域以进行添加，也无需任何公共 DNS 注册。
如果收到域不可用的消息，请尝试其他域。
After getting a confirmation that the domain was added successfully, you might see a message that the properties could not be found. Select the message to refresh domain references.
警告
请勿添加任何其他域。 请勿将新域配置为初始域。 如果在添加域后，系统提示你使用域名注册机构创建新的 TXT 记录，则表示该域未正确添加，你将无法执行重命名操作。 如果出现提示，则需要删除无效域并返回到步骤 2。
在页面顶部的导航中，选择租户名称以返回到自定义域名页面。 确保添加的 onmicrosoft.com 域在列表中，并且状态显示为“已验证”。
重要
如果状态不是“已验证”，则你将无法执行重命名操作。
第 2 步：使用 Microsoft PowerShell 重命名域
警告
更改 SharePoint 域名可能需要几个小时到几天的时间，具体取决于你拥有的网站数量和 OneDrive 用户数。 强烈建议你在低使用率期间（如周末）进行此更改，并告知用户避免在更改期间访问 SharePoint 和 OneDrive 内容。 此外，在重命名过程中，将暂时阻止创建新 OneDrives 和网站（例如在 Microsoft Teams 中创建新团队或专用频道）的任何操作。
必需 - 下载最新的 SharePoint Online 命令行管理程序。
重要
如果已安装早期版本的 SharePoint Online 命令行管理程序，请转到“添加或删除程序”并卸载“SharePoint Online 命令行管理程序”。
请务必查看系统要求和安装说明。 Mac 不支持该应用。
在 Microsoft 365 中以全局管理员或 SharePoint 管理员 身份连接到 SharePoint。 若要了解具体操作步骤，请参阅 SharePoint 在线管理壳入门。
示例：
Connect-SPOService -Url "https://contoso-admin.sharepoint.com"运行以下命令，指定新域名：
Start-SPOTenantRename -DomainName <DomainName> -ScheduledDateTime <YYYY-MM-DDTHH:MM:SS> [-WhatIf] [-Confirm]其中“DomainName”是“sharepoint.com”或“onmicrosoft.com”之前的部分，而“ScheduledDateTime”在未来至少为 24 小时，但不超过 30 天。 输入的时间基于你正在使用的计算机的当前日期和时间。
示例：
Start-SPOTenantRename -DomainName "fabrikam" -ScheduledDateTime "2021-12-31T10:25:00"备注
如果找不到 PowerShell 命令 Start-SPOTenantRename 或未返回任何内容，请确保已安装最新的 SharePoint Online 命令行管理程序。 在安装最新版本之前，可能需要通过运行
Uninstall-Module Microsoft.Online.SharePoint.PowerShell -Force -AllVersions卸载所有历史版本。 有关 Start-SPOTenantRename cmdlet 的详细信息，请参阅 Start-SPOTenantRename
可以通过运行 Get-SPOTenantRenameStatus 来获取重命名的状态。 请确保打开新的 PowerShell 窗口以再次登录。 此命令中显示的日期和时间采用 UTC 格式。 有关 Get-SPOTenantRenameStatus 的详细信息
在重命名期间和之后，可以通过运行 Get-SPOSiteRenameState 获取网站状态。 有关此 cmdlet 的详细信息，请参阅 Get-SPOSiteRenameState。
要验证重命名操作是否成功，请确保查看重命名操作的状态，以及与站点总数相比重命名站点的计数。 无法重命名为新域的站点计数将显示在“需要注意”字段中。 要获取有关这些站点的详细信息，请运行 Get-SPOSiteRenameState 并将租户重命名状态中列出的 RenameJobID 作为 ParentOperationID 传递，并传递所需状态 (Success/Failed/Suspended)。 如果要将这些结果导出到 CSV 文件，可以使用 Export-Csv cmdlet。
Get-SPOSiteRenameState -ParentOperationID <RenameJobID> -State Failed | Export-Csv -Path <Path>
若要取消尚未启动的重命名，可以运行 Stop-SPOTenantRename。 有关此 cmdlet 的详细信息
第 3 步：重命名后查看功能和设置
查看可能阻止访问新域的任何防火墙规则。
查看组织浏览器设置，确保新域是受信任的位置。 这包括查看可能控制浏览器设置的任何组策略设置。
查看访问 SharePoint 的任何第三方应用、自定义应用和脚本。 可能需要对其进行修改才能使用新域。
重要
如果您有需要访问 API 的自定义 SharePoint 框架解决方案，请检查 SharePoint 管理中心中的 API 访问页，以确保 SharePoint 框架组件可以使用新域名。