共用方式為


變更您的 SharePoint 網域名稱

當您第一次註冊 Microsoft 365 時, 即建立了 onmicrosoft.com 網域。 即使您後來新增了自訂網域, 所有 SharePoint 和 OneDrive URL 也會使用原始的 onmicrosoft.com 網域。

如果您的組織正在進行品牌化、合併或收購,而且需要變更 SharePoint 和 OneDrive URL 中的網域,您可以使用 PowerShell 來執行此動作。 例如,如果您的組織名稱從 Contoso 變更為 Fabrikam,您可以將 SharePoint URL 從 contoso.sharepoint.com 變更為 fabrikam.sharepoint.com

重要事項

  • 這項功能的標準版本目前可供網站總數不超過 10,000 個的組織使用,其中包括 SharePoint 網站、OneDrive 帳戶和 SharePoint Embedded 容器的合併。
  • 進階租使用者重新命名可供網站總數少於 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) 的相對路徑不會變更。
OneDrive 同步處理應用程式 (OneDrive.exe) 所有使用者都需要版本 17.3.6943.0625 或更高版本。 請確定不會封鎖「oneclient.sfx.ms」和「g.live.com」URL,而且您組織中的所有計算機都可以連線到這些 URL 來套用更新。
OneDrive 同步處理應用程式 (OneDrive.exe) 不會變更 Office 應用程式中顯示的組織名稱。 (例如,應用程式會顯示舊版資料夾名稱 C:\Users\Sophia\OneDrive – Contoso) 使用者可以在 Office 應用程式中中斷他們帳戶的連線再重新連線。
OneNote 需要 OneNote 的最新版本。 請確認所有使用者已安裝下列版本:
OneNote 桌面應用程式: 版本 16.0.8326.2096 或更新版本。
Windows 10 版 OneNote: 版本 16.0.8431.1006 或更新版本。
OneNote 行動裝置應用程式: 版本 16.0.8431.1011 或更新版本。
OneNote 變更網域名稱時,使用者可能會收到筆記本同步處理錯誤。
SharePoint 行動裝置應用程式 需要行動裝置應用程式的最新版本。 請確認所有使用者已安裝下列版本:
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。
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 作為連線的要求註銷流程無法運作。 移除並重新建立要求的登出流程。
電源自動化 使用 SharePoint 作為連線的受控層部署為解決方案的任何流程都無法運作。 移除並重新建立流程。
Power Automate 某些一般流程在重新命名之後無法運作。 在重新命名作業中,會嘗試更新Power Automate,但小型子集可能會因為服務問題而失敗。 針對任何識別為無法運作的流程,請手動更新 URL。
Power BI 使用 SharePoint 連線作為數據源的 Power BI 報表無法運作。 變更網域名稱之前,請將使用 SharePoint 連線做為資料來源的 Power BI 報表,下載為 .pbix 檔案。 變更網域名稱之後,請在 Power BI Desktop 應用程式中編輯連線,然後重新發佈報表。
您必須重新建立未在 Power BI Desktop 應用程式中建立或維護的Power BI報表。
Project Online 「進行中」的工作流程未完成,而且會遭到孤立。
無法初始化新的工作流程執行個體。
無法與先前的工作流程實例建立關聯,而且會遭到孤立。
變更網域名稱之前,請確定已完成所有「執行中」的工作流程。 變更網域名稱之後,請重新發佈工作流程。 接著,您可以移至 [PWA 設定>變更] 或 [重新啟動工作流程],在 Project Web App 中將它們重設為「進行中」。
Microsoft Project Online 不會變更內嵌在工作流程中的 URL。 例如,如果工作流程包含內嵌 URL contoso.sharepoint.com,便不會變更。 這可能會影響工作流程的功能。 可能需要將包含參照原始網域名稱之 URL 的工作流程更新為新名稱。
Microsoft 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 網頁組件 某些網頁元件可能無法如預期般運作。 網頁元件可能依賴直接 URL 參考。 使用新的 URL 更新網頁元件。
網站自訂和內嵌程式碼 內嵌在 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 (包括備份解決方案) 不會變更。 請確認協力廠商應用程式發行者 (包括備份解決方案) 支援租用戶重新命名。
隔離的網頁元件和完整頁面應用程式 隔離元件不會更新,且會停止運作。 包含隔離元件的解決方案必須在租使用者應用程式目錄中重新發佈。 之後,解決方案會再次開始運作。

影響度高

應用程式/功能 限制 必須採取動作
替代 URL 如果您的租使用者仍然已設定替代 URL,則無法變更您的功能變數名稱。 您必須先移除替代 URL,才能排程重新命名。 請連絡Microsoft以取得移除的支援。
Business Productivity Online Suite (BPOS) 網站 如果您的租用戶仍有 Microsoft Business Productivity Online Suite (BPOS) 其中剩餘的網站,則無法變更您的網域名稱。 在嘗試排程租使用者重新命名之前,必須先移除 BPOS 月臺及其設定。 選取 [ 使用 BPOS 網站重新命名 SharePoint 租使用者],以提交支援要求。
已刪除的網站 無法在變更後還原任何已刪除的網站。 變更網域名稱之前,請檢閱 SharePoint 系統管理中心的刪除網站頁面,並還原任何您可能想要保留的網站。
德國歷史雲端 (.de) 租使用者 如果您的租使用者原本位於具有 .de 網域的德國雲端,則無法變更您的功能變數名稱。 即使您的租使用者稍後已移轉至一般雲端,但仍保留 .de 網域,這仍然適用。 沒有可用的動作。
鎖定的網站和 OneDrive 帳戶 在LockState (鎖定的任何網站或 OneDrive 都是 NoAccess) 無法重新命名。 變更功能變數名稱之前,請檢閱鎖定的任何網站和 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。

排程租使用者重新命名之後,應該使用優先順序的 PowerShell Cmdlet。 在重新命名的排程開始時間之前,最多可支援 2 小時對優先順序網站清單所做的變更。 重新命名開始后,將不會接受進一步的變更。

步驟 1: 驗證新網域名稱

  1. 檢查您想要的新網域狀態。 例如, 如果您想要 SharePoint 和 OneDrive URLs 開始 fabrikam.sharepoint.com,請在瀏覽器中輸入 https://fabrikam.sharepoint.com。 如果您收到無法找到位址的訊息 (404), 它可能是可用的。 如果您收到登入畫面或在 fabrikam.sharepoint.com 目錄中找不到使用者名稱的訊息,則會取得網域,而您需要嘗試不同的網域。 如果網域已由其他客戶註冊,我們無法提供任何資訊或連絡該客戶。

    -或-

    如果您擁有另一個訂用帳戶的網域,則必須在 Microsoft Entra ID 中刪除該租使用者。 刪除租用戶通常需要三天才能完成,並且讓網域可供使用。

    警告

    請勿先在測試環境中使用該網域來測試此程序。 如果您這麼做,便無法在您的生產環境中使用該網域。

  2. 使用 M365 管理員 中心的 [網域] 頁面,新增新的 .onmicrosoft.com 網域

    • 請勿直接在 [網域] 頁面中使用 [新增網域] 選項,因為這不會建立 .onmicrosoft.com 網域。 使用上述連結中的步驟,正確地建立一個。
    • 請勿將此網域設為後援網域。
  3. 返回 至 [網域] 頁面,並檢查新新增的 .onmicrosoft.com 網域是否顯示為「狀況良好」狀態。

步驟 2: 使用 Microsoft PowerShell 重新命名您的網域

警告

  • 根據您擁有的網站和 OneDrive 使用者數目的不同,變更 SharePoint 網域名稱可能需要數小時到數天的時間。 我們強烈建議您在低使用期間 (例如週末) 進行這項變更,並告知使用者在變更期間避免存取 SharePoint 和 OneDrive 內容。 此外,在重新命名期間,會暫時封鎖任何建立新 OneDrive 和網站的動作 (例如在 Microsoft Teams 中建立新團隊或私人頻道)。
  • 在 SharePoint 功能變數名稱變更進行中時,請勿規劃任何 UPN 變更或重新命名。 如果您需要執行任何動作,請在功能變數名稱變更完成後執行。
  1. 必要 - 下載最新的 SharePoint 線上管理命令介面。 如果您已安裝舊版的 SharePoint 線上管理命令介面, 請移至 [新增或移除程式], 並解除安裝「SharePoint 線上管理命令介面」。 請務必檢閱系統需求及安裝指示。 Mac 不支援此應用程式。

  2. 在 Microsoft 365 中至少以 SharePoint 系統管理員 身分連線到 SharePoint。 若要了解如何進行,請參閱開始使用 SharePoint Online 管理命令介面

    範例:

    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 線上管理命令介面。 安裝最新版本之前, 您可能需要執行 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

如果您已經識別出您想要設定優先順序的網站清單,並想要大量執行設定作業,您可以將它們填入 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,以及所需的狀態 (成功/失敗/暫停)。 如果您想要將這些結果匯出至 CSV 檔案,可以使用 Export-Csv Cmdlet。

Get-SPOSiteRenameState -ParentOperationID <RenameJobID> -State Failed | Export-Csv -Path <Path>

步驟 5:重新命名之後檢閱功能和設定

  1. 檢閱任何可能會封鎖新網域存取的防火牆規則。

  2. 檢閱組織瀏覽器設定,以確定新網域是信任的位置。 這包括檢查任何可能控制瀏覽器設定的 [群組原則] 設定。

  3. 檢閱任何存取 SharePoint 的協力廠商應用程式、自訂應用程式和指令碼。 您可能需要修改它們才能使用新網域。

  4. 如果您有要求存取 API 的自訂 SharePoint 架構解決方案,請檢查 SharePoint 系統管理中心中的 API 資料頁,以確保 SharePoint 架構元件可以使用新網域名稱。

疑難排解