更改 SharePoint 域名

项目
04/08/2024

首次注册 Microsoft 365 时，你创建了一个 onmicrosoft.com 域。即使你后来添加了自定义域，原始 onmicrosoft.com 域也将用于所有 SharePoint 和 OneDrive URL。

如果你的组织经历了品牌重塑、合并或收购，并且需要更改 SharePoint 和 OneDrive URL 中的域，则可以使用 PowerShell 执行此操作。例如，如果组织名称从 Contoso 更改为 Fabrikam，则可以将 SharePoint URL 从 contoso.sharepoint.com 更改为 fabrikam.sharepoint.com。

重要

目前，SharePoint 网站和 OneDrive 帐户总数不超过 10,000 个的组织可以使用此功能。如果在尝试开始域重命名时收到错误 773“未实现”，则尚未为组织启用该功能。
如果你的组织网站总数超过 10,000 个，但网站总数少于 100,000 个，你可能对高级租户重命名感兴趣，该重命名目前采用有限的基于邀请的预览版。请参阅高级租户重命名 (预览版) 。

注意

此更改仅影响 SharePoint 和 OneDrive URL。不会影响电子邮件地址。
有关更改站点地址的信息（例如，从 https://contoso.sharepoint.com/sites/sample1 更改为 https://contoso.sharepoint.com/sites/sample2），请参阅更改站点地址。
此功能不适用于已设置多地理位置的组织。
如果组织使用特殊云或政府云 (GCC、GCC High、DoD 等 ) ，或者仍具有 .de 域，则无法更改域名。
重命名 SharePoint 域时，我们会在上一个地址创建重定向，该重定向将在重命名后 1 年过期。
只能重命名 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 365 存档	存档的网站不会重命名。	在重命名之前重新激活存档的网站。避免在重命名期间存档任何站点。
Microsoft Forms	提供在回复中上传附件选项的表单将不起作用。	删除“上传”按钮，然后在表单中再次添加。
Office 应用	更改域名时，用户在保存位于网站或 OneDrive 中的 Word、Excel 和 PowerPoint 文档时可能会遇到错误。	尝试再次保存文档，并在必要时更改保存位置的 URL。
OneDrive	OneDrive 和 SharePoint 中的快速访问链接不起作用。	没有可用的操作。
Power Automate	使用 SharePoint 作为连接的请求注销流将不起作用。	删除并重新创建请求注销流。
Power Automate	任何部署为具有使用 SharePoint 作为连接的托管层的解决方案的流都将不起作用。	删除并重新创建流。
Power BI	使用 SharePoint 连接作为数据源的 Power BI 报表将不起作用。	在更改域名之前，请下载使用 SharePoint 连接作为数据源作为 .pbix 文件的 Power BI 报表。更改域名后，编辑 Power BI Desktop 应用中的连接并重新发布报表。需要重新创建未在 Power BI Desktop 应用中创建或维护的 Power BI 报表。
Project Online	“正在进行的”工作流不会完成，并且会孤立。无法启动新的工作流实例。与以前的工作流实例的关联不可用，将会孤立。	在更改域名之前，请确保已完成所有“未完成”的工作流。更改域名后，重新发布工作流。然后，可以通过转到 PWA 设置>更改或重启工作流，在 Project Web App 中将其重置为“未完成”。
Project Online	工作流中嵌入的 URL 不会更改。例如，如果工作流包含嵌入的 URL `contoso.sharepoint.com`，则不会更改。这可能会影响工作流的功能。	包含引用原始域名的 URL 的工作流可能需要更新为新名称。
Project Online	对 https://project.microsoft.com 的 Project Online 中 PWA 网站的引用将不起作用。	在 Project Online 处https://project.microsoft.com，更改“设置我的 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 外接程序	加载项可能无法按预期工作。	可能需要重新发布加载项。查看加载项Microsoft Entra ID中的应用配置设置，并将任何 URL 更新到新域名。对于 SPFx 应用程序，在 Microsoft Entra ID将身份验证 URL 更新到 SharePoint Online 客户端扩展性 Web 应用程序主体的新域。
SharePoint 中心网站	注册为中心网站的站点将不起作用。	重命名后，在 SharePoint 管理中心注销受影响的网站并将其注册为中心网站。
SharePoint Web 部件	某些 Web 部件可能无法按预期运行。	Web 部件可能依赖于直接 URL 引用。使用新 URL 更新 Web 部件。
网站自定义和嵌入代码	SharePoint 自定义项中嵌入的绝对 URL 不会更新。	编辑包含绝对 URL 的自定义，如有必要，请将 URL 更改为新域名。
Teams 网页版和 Teams 桌面应用	当有人首次尝试访问团队或专用频道的“文件”选项卡时，他们会收到错误。之后，所有用户都可以使用该选择卡。	无
Teams 网页版和 Teams 桌面应用	会议笔记可能需要 72 小时才能工作（适用于当前和以前的会议）。	无
Teams 网页版和 Teams 桌面应用	在“文件”选项卡上，添加了“添加云存储”（指向另一个 SharePoint 网站）的任何文件夹都将不起作用。	删除并重新添加文件夹。
Teams 网页版和 Teams 桌面应用	添加为选项卡的文档库将不起作用。	删除并重新添加选项卡。
Teams 网页版和 Teams 桌面应用	Wiki 中嵌入的图像不会显示。	编辑 SharePoint 网站 Teams Wiki 数据库中的 Wiki.mht 文件，如有必要，将嵌入图像的 URL 更改为新的域名。
Teams 网页版和 Teams 桌面应用	个人 Wiki 将不起作用。	在一对一聊天或群组聊天中，附加文件并将其发送到聊天。
第三方应用包含备份解决方案	在这些第三方应用中嵌入的绝对 URL（包括备份解决方案）不会更改。	向第三方应用发布者确认（包括备份解决方案）是否支持租户重命名。
独立 Web 部件和整页应用	独立组件不会更新，并且将停止工作。	包含独立组件的解决方案需要在租户应用目录中重新发布。之后，解决方案将再次开始工作。

高影响

应用/功能	限制	必需的操作
商业生产力在线套件 (BPSO) 网站	如果租户中仍有 Microsoft 商业生产力在线套件 (BPOS) 网站，则无法更改域名。	在尝试计划租户重命名之前，需要删除 BPOS 站点及其配置。通过选择“ 使用 BPOS 网站重命名 SharePoint 租户”提交支持请求。
删除的网站	更改后，无法还原任何已删除的网站。	在更改域名之前，请查看 SharePoint Online 管理中心的“已删除网站”页面，并还原你可能想要保留的任何网站。
历史德语云 (.de) 租户	如果租户最初位于具有 .de 域的德国云中，则无法更改域名。即使租户后来迁移到常规云，但仍保留 .de 域，这一点也适用。	无可用操作。
已锁定网站和 OneDrive 帐户	任何已锁定（LockState 为 NoAccess）的网站或 OneDrive 都无法重命名。	更改域名之前，请查看已锁定的所有网站和 OneDrive 帐户，以确定是否应取消锁定。锁定及解除锁定网站
多地理位置配置	如果你的组织当前或之前已设置为 Microsoft 365 多地理位置，则无法更改 SharePoint 域名。	无可用操作。
时间点还原	无法网站还原到域名更改之前的时间点。	无可用操作。
根网站替换	在计划域名更改和完成期间，无法替换根网站（使用 SharePoint 管理中心或 PowerShell cmdlet Invoke-SPOSiteSwap)。	在计划域名更改之前或完成后替换根网站。
SharePoint 公共网站	如果租户包含旧的 SharePoint 公共网站，则不允许更改 SharePoint 域名。	在尝试计划租户重命名之前，需要删除租户上的公共站点。通过选择“ 使用公共网站重命名 SharePoint 租户”提交支持请求。
特殊云和政府云	如果组织使用特定云或政府云 (GCC、GCC High、DoD 等)，则无法更改域名。	无可用操作。
虚域配置	例如，如果 SharePoint 域是 teams.Contoso.com（而不是 contoso.sharepoint.com），则无法更改域名。	无可用操作。

高级租户重命名 (预览)

如果组织中网站总数超过 10,000 个，或者想要对重命名操作进行更大的控制，则可以考虑高级租户重命名。它支持更改当前最多 100,000 个网站总数的租户上的 SharePoint 域，并且还使管理员能够确定组织中最多 4,000 个网站的优先级，以便提前执行。这允许选择的业务关键型或高可见性站点首先完成，并降低任何风险或问题，并降低对日常运营的影响。

高级租户重命名是 SharePoint 高级管理的一部分，目前以 基于邀请的有限预览版提供。

如何参与

受限预览版目前只能支持满足以下条件的租户：

你的组织的网站总数不到 100,000 个。
你的组织未设置多地理位置。
你的组织不使用政府云，包括 GCC、GCC High 和 DoD。
你的组织不使用虚域配置。

如果你希望参与预览版并满足上述条件，请通过我们的注册表单表达你的兴趣。选择“高级租户重命名”选项，确保包含所有请求的信息，并指示你对“组织生命周期管理”部分的兴趣。

可用槽位有限，将评审每个应用程序。如果预览版计划中有空间，Microsoft 将联系你，并分享详细信息，并与你一起执行后续步骤。

由于这是 SharePoint 高级管理的一部分，因此参与者需要已是 SharePoint 高级管理客户，或者在计划重命名时启用免费试用版。

第 1 步：验证新域名

检查你想要的新域的可用性。例如，如果希望 SharePoint 和 OneDrive URL 以 fabrikam.sharepoint.com 开头，请在浏览器中输入 https://fabrikam.sharepoint.com。如果收到无法找到地址的消息 (404)，则该消息可能可用。如果看到登录屏幕或消息指出无法在 fabrikam.sharepoint.com 目录中找到你的用户名，则表示域已被占用，你需要尝试其他域。如果域已被其他客户注册，则我们无法提供任何信息，你也可以与客户联系。

- 或者 -

如果你拥有另一个订阅的域，则需要在 Microsoft Entra ID 中删除该租户。删除租户通常需要三天才能完成并使域可用。

警告

请勿先使用域在测试环境中测试此过程。如果这样做，将无法将域用于生产环境。
使用 M365 管理员中心的“域”页添加新的 .onmicrosoft.com 域。如果此操作成功，并且新域显示为“正常”状态，请直接转到步骤 2 以计划重命名。

重要

不要将此域设为回退域。
如果在 M365 管理员中心添加域时遇到问题，请转到 https://aka.ms/SPORenameAddDomain。
选择添加自定义域。
在“自定义域名”框中，输入完整的新“.onmicrosoft.com”域，然后选择“添加域”。

重要

添加域时，该域必须是“onmicrosoft.com”域。例如，如果要将租户重命名为 fabrikam.sharepoint.com，则输入的域应为 fabrikam.onmicrosoft.com。无需购买“onmicrosoft.com”域以进行添加，也无需任何公共 DNS 注册。
如果收到域不可用的消息，请尝试其他域。
确认已成功添加域后，可能会看到一条消息，指出找不到属性。选择要刷新域引用的消息。

警告

请勿添加任何其他域。请勿将新域配置为初始域。如果在添加域后，系统提示你使用域名注册机构创建新的 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 框架组件可以使用新域名。