更改 SharePoint 域名

项目
05/01/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 个的组织。
高级租户重命名适用于网站总数少于 100,000 个的组织，可通过 SharePoint 高级管理使用。请参阅高级租户重命名。

注意

此更改仅影响 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 更改。	无。作为基准，文档数低于 100,000 个的网站通常会在 3 天内更新。对于文档超过 100,000 个的网站，更新可能需要几周时间，具体取决于流量。
搜索和 Delve	搜索结果可能未完成，或者在更新搜索索引之前可能会返回原始 URL 的结果。	无
SharePoint 内容	尽管包含域名的内容 (（如页面上的文本）) 继续工作，但它不会更新以显示新名称。	搜索旧域名并编辑内容以显示新域名。

中等影响

应用/功能	限制	必需的操作
自定义应用和组策略对象	这些应用和对象中嵌入的绝对 URL 不会更改。	编辑包含绝对 URL 的自定义应用和 Active Directory 组策略对象，如有必要，请将 URL 更改为新域名。与第三方应用发布者确认应用不包含绝对 URL。
自定义和第三方应用	某些应用可能无法正确处理 HTTP 308 直通。	编辑自定义应用并与第三方应用发布者协作，确保这些应用能够正确处理 HTTP 308 响应。
Delve	可能需要 24 小时才能查看人员配置文件。	无
电子数据展示	在更新 URL 之前，无法删除保留项。	在 Microsoft Purview 合规性门户中，将电子数据展示保留 URL 更改为新域名。
InfoPath 表单	使用 SharePoint 连接作为数据源的Forms不起作用。	将这些表单重新连接到 SharePoint。
Microsoft 365 存档	存档的网站不会重命名。	在重命名之前重新激活存档的网站。避免在重命名期间存档任何站点。
Microsoft Forms	可以选择在响应中上传附件的Forms不起作用。	删除“上传”按钮，然后在表单中再次添加。
Office 应用	更改域名时，用户在保存位于网站或 OneDrive 中的 Word、Excel 和 PowerPoint 文档时可能会遇到错误。	尝试再次保存文档，并在必要时更改保存位置的 URL。
OneDrive	OneDrive 和 SharePoint 中的快速访问链接不起作用。	没有可用的操作。
Power Automate	使用 SharePoint 作为连接的请求注销流将不起作用。	删除并重新创建请求注销流。
Power Automate	任何部署为具有使用 SharePoint 作为连接的托管层的解决方案的流都将不起作用。	删除并重新创建流。
Power Automate	重命名后，某些常规流不起作用。	在重命名操作过程中，尝试更新 Power Automate，但一小部分可能会因服务问题而失败。对于标识为不起作用的任何流，请手动更新 URL。
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	对 Project Online 中的 https://project.microsoft.com PWA 网站的引用不起作用。	在 Project Online 处https://project.microsoft.com，更改“设置我的 PWA 网站”>下的 PWA 网站的 URL。
Project Online	使用 Microsoft Project Data 连接作为数据源的自定义 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 高级管理的一部分。

先决条件

高级租户重命名当前只能支持满足以下条件的租户：

您必须为组织中的所有用户购买 SharePoint 高级管理许可证。
你的组织总共有 <100,000 个网站。
你的组织未启用 Microsoft365 多地理位置。
你的组织不使用政府云，包括 GCC、GCC High 和 DoD。
你的组织不使用早期 MTE 产品/服务) (虚域。

确定网站优先级

使用高级租户重命名，最多可以设置 4,000 个站点的优先级，以便提前执行。这可以包括 OneDrive 和 SharePoint 网站，不包括根网站 (，例如，contoso.sharepoint.com、contoso-admin.sharepoint.com、contoso-my.sharepoint.com) 。

首先，在组织中的所有站点中，将选取优先级站点进行处理。这样，他们就有机会更快地完成重命名。你可以通过规划租户重命名来充分利用这一点，使其从低影响期 (周末、假日等 ) 开始，并优先考虑那些你认为在下一个工作日开始时可访问的重要网站。

若要管理优先级，可以使用以下 PowerShell cmdlet。

Set-SPOTenantRenameSitePrioritization - 这允许你确定指定站点的优先级，以便提前执行。
Remove-SPOTenantRenameSitePrioritization – 这允许删除指定站点的优先级。
Get-SPOTenantRenameSitePrioritization – 这允许你查看当前优先级站点的列表。

注意

在计划租户重命名后，应使用用于优先顺序的 PowerShell cmdlet。在计划重命名开始时间前最多 2 小时，将支持对优先站点列表的更改。开始重命名后，将不接受进一步的更改。

第 1 步：验证新域名

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

- 或者 -

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

警告

请勿先使用域在测试环境中测试此过程。如果这样做，将无法将域用于生产环境。
使用 M365 管理员中心的“域”页添加新的 .onmicrosoft.com 域。
重要
- 请勿使用“域”页中直接存在的“添加域”选项，因为这不会创建 .onmicrosoft.com 域。使用上述链接中的步骤正确创建一个。
- 不要将此域设为回退域。
返回到“域”页，检查新添加的 .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

若要在重命名开始之前取消重命名，可以运行 Stop-SPOTenantRename。有关此 cmdlet 的详细信息

步骤 3： (高级) 设置站点的优先级

如果在计划重命名时为所有用户购买了 SharePoint 高级管理许可证，则会自动将其视为高级租户重命名，并能够确定网站优先级。

可以使用 Set-SPOTenantRenameSitePrioritization cmdlet 设置单个网站的优先级。例如，若要确定网站 “projectx”的优先级，应运行以下命令：

Set-SPOTenantRenameSitePrioritization -SiteUrl https://contoso.sharepoint.com/sites/projectx

如果已确定要确定优先级的网站列表，并且想要批量执行 Set 操作，则可以在 CSV 文件中填充这些站点，然后使用 PowerShell 导入它并迭代执行 cmdlet。该文件应只包含标题为“SiteUrl”的单个列，并且每个后续行都应是所需网站的完整 URL。

示例：

Import-Csv <Path> | ForEach-Object {Set-SPOTenantRenameSitePrioritization -SiteUrl $_.SiteUrl}

注意

如果使用包含整个 4,000 个站点的文件尝试此操作，则此 cmdlet 的完整执行大约需要 4-6 小时。如果想要缩短等待时间，建议拆分站点列表并分批执行此操作。若要查看当前优先级的网站列表，请运行以下命令：

Get-SPOTenantRenameSitePrioritization

如果要删除站点的优先级，可以运行 Remove-SPOTenantRenameSitePrioritization cmdlet。例如，若要删除“projectx”网站的优先级，应运行以下命令：

Remove-SPOTenantRenameSitePrioritization -SiteUrl https://contoso.sharepoint.com/sites/projectx

确定站点的优先级并不保证会首先完成。有几个因素可能会影响处理时间，并并行处理多个站点重命名。优先站点首先完成的几率较高。

步骤 4：监视重命名的状态

可以通过运行 Get-SPOTenantRenameStatus 来获取重命名的状态。请确保打开新的 PowerShell 窗口以再次登录。使用此命令显示的日期和时间采用 UTC 时间 (但将遵循运行 cmdlet 的系统的本地格式) 。有关 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>

步骤 5：在重命名后查看功能和设置

查看可能阻止访问新域的任何防火墙规则。
查看组织浏览器设置，确保新域是受信任的位置。这包括查看可能控制浏览器设置的任何组策略设置。
查看访问 SharePoint 的任何第三方应用、自定义应用和脚本。可能需要对其进行修改才能使用新域。

重要

如果您有需要访问 API 的自定义 SharePoint 框架解决方案，请检查 SharePoint 管理中心中的 API 访问页，以确保 SharePoint 框架组件可以使用新域名。