手順 5: ID マッピング

  • [アーティクル]

これは、クロステナント OneDrive 移行を完了するように設計されたソリューションの手順 5 です。 詳細については、「 テナント間 OneDrive 移行の概要」を参照してください。

ID マッピング ファイルを作成する

クロステナント移行プロセスのこの手順では、ソース テナント上のユーザーとグループをターゲット テナント上の対応するユーザーとグループにマッピングする 1 つの CSV (コンマ区切り値) ファイルを作成します。

ターゲット テナントへの移行を開始する前に、マッピングの検証に時間をかけて正確であることを確認することをお勧めします。

ID マッピング ファイルには 1 対 1 のリレーションシップがあります。 ターゲット テナント内の複数のユーザーに同じユーザーをマップすることはできません。 たとえば、管理者が複数の OneDrive アカウントの所有者であるインスタンスがある場合は、ソースからターゲットに移行する対応するユーザーと一致するように所有権を変更する必要があります。 そうしないと、これらのアカウント ファイルは移行されません。

例： この例では、管理者が複数の OneDrive アカウントを所有しています。

ソース テナント所有者 ターゲット テナント ユーザー
admin@source.com new.userA@target.com
admin@source.com new.userB@target.com
admin@source.com new.userC@target.com

テナント間移行では、次のシナリオがサポートされます。

例:

ソース テナント所有者 ターゲット テナント ユーザー
userA@source.com new.userA@target.com
userB@source.com new.userB@target.com
userC@source.com new.userC@target.com

CSV ファイルを作成する

CSV ファイルには 6 つの列が必要です。 最初の 3 つはソース値であり、それぞれがデータが現在配置されている場所に関する詳細を提供します。 残りの 3 つの列は、ターゲット テナントの対応する情報です。 6 つの列はすべて、ファイル内で を考慮する必要があります。 Excel でファイルを作成し、.csv ファイルとして保存します。

ユーザーとグループは、同じファイルに含まれています。 ユーザーかグループかに応じて、列に入力する内容が異なります。 各列に、例に示すように値を入力します。 列見出しは含めないでください。

Column User グループ
1 User グループ
2 SourceTenantCompanyID SourceTenantCompanyID
3 SourceUserUpn SourceGroupObjectID
4 TargetUserUpn TargetGroupObjectID
5 TargetUserEmail GroupName
6 UserType GroupType

重要

CSV ファイルに列見出しを含めないでください。 以下の例では、説明のみを目的としてそれらを含めます。

ユーザー。 [ユーザー] の次の例に示すように、値を入力します。

マッピング ユーザーに使用する形式

ユーザーの csv の例

グループ。 [グループ:
グループの csv ファイルの形式] に、次の例に示すように値を入力します

例:

csv ファイルへのグループの追加の例

ゲストユーザー ソース テナントのゲスト アカウントをターゲット テナントのメンバー アカウントにマップできます。 また、以前にゲストが作成されている場合は、ソースのゲスト アカウントをターゲットのゲスト アカウントにマップすることもできます。 ゲストの次の例に示すように、値を入力します。

ゲストをメンバーにマッピングする場合の csv の例

ゲストをゲストにマッピングする場合の csv の例

CSV ファイル内の複数のユーザーとグループ:

例:

マッピング ファイル内のユーザーとグループの両方の例

ソース テナント会社 ID を取得する

ソース テナント会社 ID を取得するには:

  1. Azure portalに管理としてサインインする
  2. [Microsoft Entra ID] を選択または検索します。
  3. 左側のパネルを下にスクロールし、[プロパティ] を選択 します。
  4. [テナント ID] フィールドを見つけます。 必要なテナント ID がそのボックスに表示されます。

ソース テナント ID の取得

ソース グループ オブジェクト ID を取得するには:

  1. Azure グループに管理としてソース テナントにサインインします。
  2. 必要なグループを検索します。
  3. 必要なグループ インスタンスを選択し、[ クリップボードにコピー] を選択します。 マッピング CSV ファイルの sourceGroupObjectId 列にこの値を貼り付けます。
  4. マップするグループが複数ある場合は、グループごとにこれらの手順を繰り返します。

ソース グループ オブジェクト ID の取得

ターゲット グループ オブジェクト ID を取得するには:

  1. Azure グループへの管理としてターゲット テナントにサインインする
  2. 必要なグループを検索します。
  3. 必要なグループ インスタンスを選択し、[ クリップボードにコピー] を選択します。 マッピング CSV ファイルの targetGroupObjectId 列にこの値を貼り付けます。
  4. マップするグループが複数ある場合は、上記のプロセスを繰り返して、それらの特定の targetGroupObjectId を取得します。
  5. GroupName には、取得した TargetGroupObjectId と同じ ID を使用します。

ターゲット オブジェクト ID を取得する方法

ID マップをアップロードする

ID マッピング ファイルが準備されると、ターゲット テナントの SharePoint 管理者がファイルを SharePoint にアップロードします。 これにより、テナント間移行の一環として ID マッピングが自動的に実行されます。

重要

Add-SPOTenantIdentityMap -IdentityMapPath コマンドを実行する前に、デスクトップ/OneDrive/SharePoint の identitymap.csv ファイルを保存して閉じます。 ファイルが開いたままの場合は、次のエラーが表示されます。

Add-SPOTenantIdentityMap: プロセスは別のプロセスで使用されているため、ファイル 'C:\Users\myuser\Test-Identity-Map.csv' にアクセスできません。

  1. ターゲット テナントに ID マップをアップロードするには、次のコマンドを実行します。 -IdentityMapPath の場合は、ID マッピング CSV ファイルの完全なパスとファイル名を指定します。
Add-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv>

重要

移行のライフサイクル中に ID マップに変更を加える必要がある場合は、変更が行われるたびにコマンドをAdd-SPOTenantIdentityMap -IdentityMapPath <identitymap.csv>実行して、それらの変更が移行に確実に適用されるようにする必要があります。

新しい ID マップをアップロードすると、現在の ID マップが上書きされます。 すべてのリビジョンまたは追加に、完全な移行のすべてのユーザーとグループが含まれていることを確認します。 ID マップには、移行するすべてのユーザーを常に含める必要があります。

特定のユーザーの ID マッピング ファイル内のマッピング エントリを確認するには、 Get-SPOTenantIdentityMappingUser コマンドを使用し、移動するユーザーの UPN として Field を SourceUserKey 、Value を使用します。

例:

get-spoTenantIdentityMappingUser -Field SourceUserKey -Value usera@Contoso.onmicrosoft.com

テナント間の互換性の状態を確認する

テナント間の移行を開始する前に、両方の SharePoint データベース スキーマが最新で、ソースとターゲットの間で互換性があることを確認してください。

このチェックを実行するには、ソース テナントで次のコマンドレットを実行します。

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL [Target tenant hostname]

Get-SPOCrossTenantCompatibilityStatus -PartnerCrossTenantHostURL https://m365x12395529-my.sharepoint.com
  • テナントの状態が [互換性] または [警告] と表示されている場合は、テナント間の移行を開始する次の手順に進むことができます。
  • テナントの状態が [互換性がありません] と表示される場合は、互換性を確保するために、テナントにパッチを適用または更新する必要があります。
状態 移行を続行できます
互換性 はい
警告 はい
Incompatible いいえ

注:

48 時間待機することをお勧めします。 テナントが 互換性のないレポートを残している場合は、サポートにお問い合わせください。

テナント間移行の任意のインスタンスを開始する前に、互換性状態チェックを頻繁に実行することをお勧めします。 テナントに互換性がない場合は、テナント間の移行が失敗する可能性があります。

手順 6: OneDrive のテナント間移行を開始する