特定サイトのみを対象とした SharePoint / Teams 移行における Sites.Selected 権限の設定方法 (4378526)

その手順や注意・制限事項などをこの技術情報で紹介します。

Sites.Selected 権限の制限事項

Sites.Selected が有効な場合、Graph API を通じたアクセスが許可されたサイトのみが検出可能となります。
そのため、適切なアクセス権が付与されていないサイトは Discovery Task でも検出されません。
また、移行先の場合は、権限付与のため事前にプロビジョニングが必要です。

• SharePoint ハブ サイトは移行対象外
• タームストアはサポート対象外
• Multi-Geo 環境では中央地域に移行
• テナント レベルのサイト設定で以下の内容は検出および移行対象外
  • 外部共有設定
  • サイト リソースの割り当て設定
  • サイト ストレージ クォータ  
  • サイトの種類に関する情報 (Microsoft 365 グループ サイトや Teams に接続されたサイトなど) 

移行元テナントの Discovery Task の注意事項

対象サイトを記載した CSV ファイルを予め用意し、DISCOVER SITES FROM FILE で検出する必要があります。

移行先テナントの Discovery Task の注意事項

対象サイトは事前にプロビジョニングする必要があります。

また ODM では SharePoint サイトにおけるカスタム スクリプトの設定を自動的に管理することはできません。サイト ページの移行を行うには、対象の SharePoint サイトでカスタム スクリプトを 許可 (Allowed) に構成する必要があります。

Teams 移行の注意事項

Teams チャット のアーカイブ データはユーザーの OneDrive に HTML で出力されるため、Sites.Selected により OneDrive へのアクセスが制限されると、チャット アーカイブの移行は実行できません。

本機能は申請制です。有効化を望まれる場合、お手数ですが "migration.sharepoint.siteselected.allow" 機能フラグの有効化依頼と共にその理由を記述してテクニカルサポートケースを作成してください。
申請時には、対象の Organization ID および Region Name が必要です。それらの確認方法はビデオ チュートリアルをご参照ください。

"migration.sharepoint.siteselected.allow" の申請許可が下りたらサポート担当者からその旨を通知いたします。
その後、ODM のテナント ページで設定する前に次の前提条件を満たしているかご確認ください。

前提条件:

• ユーザー アカウントは、グローバル管理者ロールのメンバーである必要があります  
• ユーザー アカウントには、Sites.Selected に追加する対象サイトに対して、少なくとも SharePoint の閲覧 (閲覧者) 権限が付与されている必要があります  
• Teams の移行を実施する場合は、Teams モジュールで定義されたユーザーの前提条件を満たす必要があります

これらの条件を満たしている場合、サイト制限のための共通手順を実施したうえで、各対象ごとに手順を実施してください。

サイト制限のための共通手順概要:

1. ODM テナント ページで Sites.Selected 設定を有効化  
2. 対象サイトを Sites.Selected の対象として追加   

各項目ごとの手順は以下を参照ください。

1. 移行元 SharePoint サイトを制限する場合
2. 移行先 SharePoint サイトを制限する場合
3. Teams サイトを制限する場合

共通手順 1 ODM テナント ページで Sites.Selected 設定を有効化

以下の手順で ODM 上で Sites.Selected 設定を有効化してください。

1. ODM ポータルサイトにサインインし、左側のメニューより Tenants をクリックし、制限したいテナントを選択します。
2. ユーザー アカウント管理およびマッピングに必要な Migration Basic アプリケーションの [Grant Consent] をクリック、同意を付与します。
3. Migration SharePoint - の [Grant Consent] をクリック、同意を付与します。

共通手順 2 対象サイトを Sites.Selected の対象として追加

以下の手順で今回の移行で対象としたいサイトの id を確認し、id を対象に Sites.Selected の対象として追加します。今回は Microsoft  Graph Explorer を利用した例をご案内しますが、Microsoft Graph PowerShell などを使ってご確認いただくことも可能です。 

1. 制限対象のサイト名を確認し、メモします。例として今回は SharePoint ホスト名プレフィックスを targethost, 制限対象サイトを Selected01 とします。
2. Microsoft  Graph Explorer を開きます
3. Selected Sites アプリケーションを同意した管理者権限でサインインします
4. サイトの ID を取得するために以下の内容で [Run query] を実行します。
   GET https://graph.microsoft.com/v1.0/sites/<SharePoint サイト>:/sites/<制限対象サイト>?$select=id
   (例) GET https://graph.microsoft.com/v1.0/sites/targethost.sharepoint.com:/sites/Selected01?$select=id
5. 応答があったサイト ID をコピーします。
   (例) Id : targethost.sharepoint.com,12345abcde-0000-1111-2222-333344445555,67890fghij-aaaa-bbbb-cccc-ddddeeeeffff
   
   以下の POST コマンドで制限対象サイトととして追加します。
   

   POST https://graph.microsoft.com/v1.0/sites/<サイト ID>/permissions
Request Body には次の内容を記載します:


   {
  "roles": ["fullcontrol"],
  "grantedToIdentities": [
    {
      "application": {
        "id": "8990c8ce-4afb-48f0-9e30-f1338ef249db",
        "displayName": "Quest On Demand - Migration - SharePoint – Selected Sites"
      }
    }
  ]
}

   
   (例) POST https://graph.microsoft.com/v1.0/sites/targethost.sharepoint.com,12345abcde-0000-1111-2222-333344445555,67890fghij-aaaa-bbbb-cccc-ddddeeeeffff/permissions

   {
     "roles": ["fullcontrol"],
     "grantedToIdentities": [
       {
         "application": {
           "id": "8990c8ce-4afb-48f0-9e30-f1338ef249db",
           "displayName": "Quest On Demand - Migration - SharePoint – Selected Sites"
         }
       }
     ]
   }

移行元 SharePoint サイトを制限する場合

1. 共通手順を実行し、移行したいサイトに Sites.Selected の権限を付与します。
2. DISCOVER SITES FROM FILE で移行対象サイトを検出します
3. あとはいつも通りに移行してください

移行先 SharePoint サイトを制限する場合

1. 対象サイトを事前にプロビジョニングします
2. 共通手順を実施し、移行先サイトに Sites.Selected の権限を付与します。
3. 対象サイトの カスタム スクリプトを許可します。
   注意: カスタム スクリプトの設定は一定時間後に自動的に無効化される場合があります（通常は約 24 時間）。長時間の移行が必要な場合は、再設定を行ってください。
4. あとはいつも通りに移行してください。

Teams サイトを制限する場合

移行元および移行先ともに基本的に SharePoint サイトと同様です。

ただし、検出対象が Teams チームや M365 グループになり、移行対象も Teams チームや M365 グループになります。