更改 SharePoint 域名

参考如下文章
https://learn.microsoft.com/zh-cn/sharepoint/change-your-sharepoint-domain-name

第 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. 在获得成功添加域的确认后,你可能会看到一条消息,表示找不到属性。 选择要刷新域引用的消息。

     警告

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