更改 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 步:验证新域名

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

    • 或者 -

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

    警告

    请勿先使用域在测试环境中测试此过程。 如果这样做,将无法将域用于生产环境。

  2. 转到 https://aka.ms/SPORenameAddDomain

    重要

    必须使用链接 https://aka.ms/SPORenameAddDomain 转到 Azure AD 管理中心的自定义域名页面。 如果浏览页面而不是使用链接,则你将无法成功添加自定义 onmicrosoft.com 域。

  3. 选择 添加自定义域

  4. 在“自定义域名”框中,输入完整的新“.onmicrosoft.com”域,然后选择“添加域”。

    自定义域名窗格

    重要

    添加域时,该域必须是“onmicrosoft.com”域。 例如,如果要将租户重命名为 fabrikam.sharepoint.com,则输入的域应为 fabrikam.onmicrosoft.com。 无需购买“onmicrosoft.com”域以进行添加,也无需任何公共 DNS 注册。

  5. 如果收到域不可用的消息,请尝试其他域。

  6. 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。

  7. 在页面顶部的导航中,选择租户名称以返回到自定义域名页面。 确保添加的 onmicrosoft.com 域在列表中,并且状态显示为“已验证”。

    已验证域状态

    重要

    如果状态不是“已验证”,则你将无法执行重命名操作。

第 2 步:使用 Microsoft PowerShell 重命名域

警告

更改 SharePoint 域名可能需要几个小时到几天的时间,具体取决于你拥有的网站数量和 OneDrive 用户数。 强烈建议你在低使用率期间(如周末)进行此更改,并告知用户避免在更改期间访问 SharePoint 和 OneDrive 内容。 此外,在重命名过程中,将暂时阻止创建新 OneDrives 和网站(例如在 Microsoft Teams 中创建新团队或专用频道)的任何操作。

  1. 必需 - 下载最新的 SharePoint Online 命令行管理程序

    重要

    如果已安装早期版本的 SharePoint Online 命令行管理程序,请转到“添加或删除程序”并卸载“SharePoint Online 命令行管理程序”。

    请务必查看系统要求和安装说明。 Mac 不支持该应用。

  2. 在 Microsoft 365 中以全局管理员或 SharePoint 管理员 身份连接到 SharePoint。 若要了解具体操作步骤,请参阅 SharePoint 在线管理壳入门

    示例:

    Connect-SPOService -Url "https://contoso-admin.sharepoint.com"

  3. 运行以下命令,指定新域名:

    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 步:重命名后查看功能和设置

  1. 查看可能阻止访问新域的任何防火墙规则。

  2. 查看组织浏览器设置,确保新域是受信任的位置。 这包括查看可能控制浏览器设置的任何组策略设置。

  3. 查看访问 SharePoint 的任何第三方应用、自定义应用和脚本。 可能需要对其进行修改才能使用新域。

重要

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

疑难解答