2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

SharePoint Online テナント名(sharepoint.com)を変更する手順とハマりどころ

2
Posted at

この記事はZennからのお引越し記事です。

はじめに

Microsoft 365(SharePoint Online)を使っていると、

  • xxx.sharepoint.comxxx 部分を変えたい
  • テナント作成時の名前がダサい
  • 屋号変更・ブランド変更した

といった理由で SharePoint のテナント名変更(Tenant Rename) をしたくなることがあります。

この記事では、実際に SharePoint Online のテナント名を変更したときの、

  • 全体の流れ
  • 必須手順
  • PowerShell 実行例
  • 実際にハマったエラー(-757 / -756)
  • 成功後の確認方法

実体験ベース でまとめます。

この記事のゴール

以下の変更を 公式サポート範囲内で安全に完了 させることです。

変更前:https://fabricamev.sharepoint.com
変更後:https://unfoldry.sharepoint.com

メールアドレス(Exchange Online)や Entra ID の UPN 変更とは 別の操作 です。
この記事で扱うのは SharePoint / OneDrive の URL プレフィックス変更のみです。

全体の流れ(概要)

  1. M365 テナントに *.onmicrosoft.com ドメインを追加
  2. SharePoint Online PowerShell で Tenant Rename をスケジュール
  3. 進捗・完了確認
  4. 成功後チェック

📘 公式ドキュメント(全体概要)

前提条件・制約

項目 内容
必要な権限 グローバル管理者 または SharePoint 管理者
Multi-Geo 未使用であること
変更回数 原則1回のみ(元に戻せない)
旧URLリダイレクト 変更後 1年間 のみ有効
GCC / GCC High / DoD 対象外

📘 制限事項の公式説明


*.onmicrosoft.com ドメインを追加する

Tenant Rename では、変更先の名前に対応する *.onmicrosoft.com ドメインが「検証済み(Verified)」で存在していることが必須です。

既にカスタムドメイン(例:unfoldry.com)を追加していても、それだけでは Tenant Rename の条件を満たしません。
必ず unfoldry.onmicrosoft.com を追加する必要があります。

追加手順

必ず以下の専用リンクから追加してください。
通常の「ドメイン追加」画面から入れると、後続の PowerShell 実行で -757 エラー になります。

👉 https://aka.ms/SPORenameAddDomain

追加するドメイン

unfoldry.onmicrosoft.com

追加時の注意点

  • DNS 設定は 不要(即座に Verified になります)
  • 既定(fallback)ドメインには設定しないこと

確認

Microsoft 365 管理センター または Entra ID のドメイン一覧で、
unfoldry.onmicrosoft.com の Status が Verified になっていることを確認します。

📘 onmicrosoft.com ドメインの追加


② PowerShell で Tenant Rename をスケジュール

モジュールのインストール

PowerShell
Install-Module Microsoft.Online.SharePoint.PowerShell -Force

📘 SharePoint Online Management Shell

管理センターに接続

PowerShell
Connect-SPOService -Url https://fabricamev-admin.sharepoint.com

接続先は https://fabricamev.sharepoint.com ではなく、必ず -admin.sharepoint.com です。

実行前:状態確認(重要)

PowerShell
Get-SPOTenantRenameStatus

初回は以下のような all-zero の出力になりますが、正常 です。

RenameJobId        : 00000000-0000-0000-0000-000000000000
Status             :
Requested at       : 0001/01/01 0:00:00 (UTC)
Requested by       :
Scheduled at       : 0001/01/01 0:00:00 (UTC)
New domain name    :
Total sites        : 0
In progress        : 0
Renamed            : 0
Attention required : 0

これは「Rename ジョブがまだ1度も作成されていない」ことを意味します。

📘 Get-SPOTenantRenameStatus

Tenant Rename の実行

PowerShell
Start-SPOTenantRename `
  -DomainName "unfoldry" `
  -ScheduledDateTime "2026-05-04T19:40:00"

パラメータの注意点

パラメータ 注意
-DomainName unfoldry のみ.sharepoint.com.onmicrosoft.com は付けない
-ScheduledDateTime 必須(省略不可)。現在時刻から 24時間以上未来〜30日以内 を指定。JST でOK

-ScheduledDateTime は省略できません。
Tenant Rename は「即時実行」に対応しておらず、必ず未来の日時をスケジュールする仕様です。

24時間ちょうどの指定は、内部時刻のズレで「24時間未満」と判定されることがあります。
10〜15分の余裕を持たせるのが実務的に安全です。

📘 Start-SPOTenantRename


実際にハマったエラーと対処

Error Code -757:ドメイン名は有効ではありません

Start-SPOTenantRename : Error Code: -757,ドメイン名は有効ではありません。

原因
unfoldry.onmicrosoft.com未追加 または 未検証(Verified でない) 状態。

対処
https://aka.ms/SPORenameAddDomain から onmicrosoft.com ドメインを追加し、Verified になっていることを確認してから再実行する。


Error Code -756:予期しないエラーが発生しました

Start-SPOTenantRename : Error Code: -756,予期しないエラーが発生しました。

原因
Microsoft 側の バックエンド準備が完了していない
onmicrosoft.com ドメイン追加直後に発生しやすい。

特徴

  • Get-SPOTenantRenameStatusall-zero のまま
  • Rename ジョブが1度も作成されていない

対処

  • 半日〜1日時間を空ける
  • -ScheduledDateTime を変えて再実行
  • ❌ 連続リトライしない(固定化しやすい)
  • ❌ onmicrosoft.com ドメインを削除・再追加しない

半日〜1日空けても毎回 -756 になる場合は、Microsoft 側で Tenant Rename フラグが未解放の可能性があります。
Microsoft 365 管理センターからサポートリクエストを作成してください。

伝えるべき内容(テンプレート):

We have completed all prerequisites for SharePoint Tenant Rename.
Domain unfoldry.onmicrosoft.com is verified.
Start-SPOTenantRename consistently fails with Error Code -756.
Get-SPOTenantRenameStatus shows no rename job created (all zero values).
Please check backend tenant rename readiness and unblock if needed.

📘 エラーコード一覧


③ 成功確認

ステータスの確認

PowerShell
Get-SPOTenantRenameStatus

成功ルートに乗った場合の出力例

RenameJobId        : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Status             : Queued
Scheduled at       : 2026/05/04 19:40:00
New domain name    : unfoldry
Total sites        : 12

成功ルートに乗った場合の通知メール

PowerShellよりリクエストが通った場合、以下のようにメールでも通知を受け取ります。

Status の遷移

Queued → InProgress → Completed

Status が Queued または InProgress になったら、絶対に Start-SPOTenantRename を再実行しないでください

実行開始/終了時の通知メール

ドメイン名の変更が開始されると、変更作業を実行開始するメールを受け取ります。

実行完了した際も同様に完了通知メールを受け取ります。実行開始から完了まで約5分ほどで終わりました。

完了時の出力例

Status             : Completed
Renamed            : 12  ← Total sites と同数なら全サイト成功
Attention required : 0

URL の動作確認

確認項目 URL 期待する挙動
新 SharePoint https://unfoldry.sharepoint.com サイトが表示される
新 OneDrive https://unfoldry-my.sharepoint.com マイファイルが開く
旧URL リダイレクト https://fabricamev.sharepoint.com 新URLへ自動転送される

旧URLからのリダイレクトは 1年間のみ 有効です。
社内資料・Power Automate・スクリプト等に旧URLが残っていないか、早めに確認しましょう。

Attention required が 1 以上の場合

PowerShell
Get-SPOSiteRenameState -State Failed

多くの場合、削除済みサイトや古いリダイレクトサイトなど、実害のないものです。


④ 成功後のチェックリスト

  • SharePoint に新URLでアクセスできる
  • OneDrive に新URLでアクセスできる
  • 旧URLが新URLへリダイレクトされる
  • Teams の「ファイル」タブが正常に開ける
  • OneDrive 同期クライアントが正常動作している
  • Power Automate / Power Apps に旧URL直書きがないか確認
  • カスタムスクリプト・Webhook 等の外部連携を確認
  • Copilot がドキュメントを正常に参照できる

📘 影響を受ける機能


まとめ

  • SharePoint テナント名変更は 公式サポート済み の機能
  • 最大の落とし穴は *.onmicrosoft.com ドメインの追加漏れ(-757)
  • 追加直後のバックエンド未同期で -756 も踏みやすい
  • Get-SPOTenantRenameStatus が all-zero でも 失敗ではない
  • 焦らず時間を空けて再実行すればOK

参考リンク(Microsoft Learn)

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?