更改 SharePoint 域名
首次注册 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 连接作为数据源的表单不起作用。 | 将这些表单重新连接到 SharePoint。 |
| Loop | 无法共享现有工作区，并且无法向其添加新页面。 | 没有可用的操作。 |
| Microsoft 365 存档 | 存档的网站不会重命名。 | 在重命名之前重新激活存档的网站。 避免在重命名期间存档任何站点。 |
| Microsoft Forms | 可以选择在响应中上传附件的表单不起作用。 | 删除“上传”按钮，然后在表单中再次添加。 |
| Office 应用 | 更改域名时，用户在保存位于网站或 OneDrive 中的 Word、Excel 和 PowerPoint 文档时可能会遇到错误。 | 再次尝试保存文档，如有必要，请更改“保存”位置的 URL。 |
| OneDrive | OneDrive 和 SharePoint 中的快速访问链接不起作用。 | 没有可用的操作。 |
| Teams 中的 OneDrive 应用 | 访问应用将返回 404 错误。 | 在发布修补程序之前，若要解决错误，请执行以下操作： 1. 创建与其他用户的 1：1 聊天。 2. 在消息框中，选择 “操作和应用>附加文件>从此设备上传”。 3. 选择要发送给其他用户的文件，然后选择“ 打开”。 4.按 Enter 发送文件，或选择“ 发送”。 发送文件后，导航到 Teams 中的 OneDrive 应用。 |
| 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 桌面应用 | 添加为选项卡的文档库和 SharePoint 列表不起作用。 | 删除并重新添加选项卡。 |
| Teams 网页版和 Teams 桌面应用 | 不会显示 Wiki 中的嵌入图像。 | 编辑 SharePoint 网站 Teams Wiki 数据库中的 Wiki.mht 文件，如有必要，将嵌入图像的 URL 更改为新的域名。 |
| Teams 网页版和 Teams 桌面应用 | 个人 Wiki 将不起作用。 | 在一对一聊天或群组聊天中，附加文件并将其发送到聊天。 |
| 第三方应用包含备份解决方案 | 在这些第三方应用中嵌入的绝对 URL（包括备份解决方案）不会更改。 | 向第三方应用发布者确认（包括备份解决方案）是否支持租户重命名。 |
| 独立 Web 部件和整页应用 | 独立组件不会更新，并且将停止工作。 | 包含独立组件的解决方案需要在租户应用目录中重新发布。 之后，解决方案将再次开始工作。 |
高影响
| 应用/功能 | 限制 | 必需的操作 |
|---|---|---|
| 备用 URL | 如果租户仍配置备用 URL，则无法更改域名。 | 在计划重命名之前，需要删除备用 URL。 请联系 Microsoft 以获取删除它们的支持。 |
| 商业生产力在线套件 (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 域名更改正在进行时，请勿计划任何 UPN 更改或重命名。 如果需要执行任何操作，请在域名更改完成后执行此操作。
必需 - 下载最新的 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 框架组件可以使用新域名。