Entra Connect で重複ユーザーが作成される、または属性がスキップされる: ソフトマッチ、ハードマッチ、重複する値
By Mirko Peters ·
オンプレミスで新しく作成したユーザーに対して、onmicrosoft.com の UPN を持つクラウドアカウントが 2 つ目に作られる、あるいはメールアドレスが更新されないことがあります。本記事では、マッチングの仕組み、エラーの読み方、安全な再リンク方法を解説します。
Automatically translated with AI from the original post. Read the English original
Entra Connect のマッチングルールを調べることになるケースは、主に 2 つあります。1 つ目は、オンプレミスの新しいユーザーがクラウドに 2 つ作成されるケースです。意図したアカウントに加えて、.onmicrosoft.com のサインイン名を持つ新しい同期アカウントが作られます。2 つ目は、同期はエラーなく完了するものの、Entra ID 上のユーザーの mail または proxyAddresses が古いアドレスのままになるケースです。
重要なポイント
- Entra はまず、sourceAnchor と ImmutableId のハードマッチを試みます。次に、userPrincipalName または基本 SMTP アドレスによるソフトマッチを試み、それでも一致しない場合は新しいオブジェクトを作成します。
- オンプレミスの UPN サフィックスがテナントで検証されていない場合、Entra は mailNickName と初期の onmicrosoft.com ドメインから新しい UPN を作成します。
- 重複属性の回復性機能は、競合する proxyAddresses や UPN の値を失敗させるのではなく隔離します。そのため、同期は正常に見えても、ある値が欠けている場合があります。
- Learn によると、2026 年 7 月 1 日以降は、onPremisesObjectIdentifier がすでに設定されているクラウドアカウント、または特権ロールを保持している、もしくは対象となるクラウドアカウントについて、ハードマッチがブロックされる場合があります。
どちらも Microsoft Q&A のスレッドで取り上げられたもので、1 つは 2025 年 1 月、もう 1 つは 2025 年 10 月のものです。それぞれのスレッドでは、質問者が解決方法を報告しています。技術的な背景は、現在の Microsoft Learn のページで確認しました。本記事はトラブルシューティングのガイドであり、Microsoft の公式手順ではありません。変更は必ず 1 人のユーザーでテストしてから適用してください。
Entra によるオブジェクトのマッチング方法
AD から新しいオブジェクトが到着した場合の順序は、Learn によると次のとおりです。
- ハードマッチ。 Entra は
sourceAnchorを既存のクラウドオブジェクトのImmutableIdと比較します。既定のsourceAnchorは、構成に応じてmS-Ds-ConsistencyGUIDまたはObjectGUIDを Base64 形式にしたものです。 - ソフトマッチ。 ハードマッチがない場合、Entra は
userPrincipalNameまたはproxyAddressesの基本SMTP:値を比較します。 - 新しいオブジェクト。 どちらも一致しない場合、Entra は新しいオブジェクトを作成します。
Learn では、さらに 2 つの制限が挙げられています。ソフトマッチは新しいオブジェクトに対してのみ評価されます。また、ソフトマッチが成立すると、Entra はクラウドオブジェクトを引き継ぎ、オンプレミスで値を持つすべての属性を上書きします。クラウド専用の属性は失われる可能性があり、パスワード ハッシュ同期を使用している場合は、クラウドのパスワード ハッシュがオンプレミスのものに置き換えられます。
シナリオ 1: onmicrosoft.com の UPN を持つ 2 人目のユーザー
スレッドで報告された内容。 管理者がオンプレミスの AD にユーザーを作成しました。Entra Connect により、.onmicrosoft.com の UPN と、オンプレミス同期フラグを持つ 2 人目の Entra ユーザーが作成されました。意図したクラウドユーザーには同期フラグがありませんでした。採用された回答では、ソフトマッチとハードマッチの両方が説明されていました。質問者はその後、ハードマッチのアプローチで問題が解決したと書いています。
マッチが失敗した理由として考えられること
そのスレッドでは理由は示されていませんでした。Learnには onmicrosoft.com 名が付く理由として、ひとつだけ文書化された説明があります。オンプレミスの UPN サフィックスがテナントで検証されていない場合、Entra は MailNickName と初期ドメインから新しい UPN を計算します。つまり、UPN がクラウドのユーザーと一致しない可能性があります。これは原因の特定ではなく、手がかりとして考えてください。両方のアカウントで次の項目を比較してください。
- UPN サフィックスと、そのドメインがテナントで検証済みかどうか
- プライマリ SMTP アドレス(
proxyAddresses内のSMTP:エントリ) - クラウドユーザーにオンプレミスとのリンクがすでに表示されているかどうか
オプション A:ソフトマッチを機能させる
スレッドで最初に提示された回避策は、オンプレミスの UPN とプロキシアドレスをクラウドユーザーに合わせ、重複したオブジェクトを削除してから再同期するというものでした。Learnによると、ソフトマッチは新しいオブジェクトに対してのみ評価されます。また、重複オブジェクトを削除した後に、すでにリンクされているオブジェクトが再評価されるかどうかについては触れられていません。質問者は最終的にオプション B を採用しているため、オプション A は検証されていない方法として扱ってください。
オプション B:ハードマッチ
- Entra Connect がどの属性を
sourceAnchorとして使用しているかを確認してください。LearnではmS-Ds-ConsistencyGUIDまたはObjectGUIDが挙げられています。 - オンプレミスの GUID を Base64 に変換します。スレッドの返信では次のパターンが使われていました。
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- 得られた値を、クラウドユーザーの
ImmutableIdに設定します。スレッドの返信では、古い MSOnline モジュールのSet-MsolUserが使われていました。現在のLearnのページでは Microsoft Graph PowerShell が案内されています。Update-MgUserのページには-OnPremisesImmutableIdパラメーターが記載されており、更新できるのは特定の特権管理者ロールのみであると説明されています。実行前に、そのページのパラメーターの注意事項を確認してください。 - デルタ同期を実行します。
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- 対象のクラウドユーザーに同期フラグが表示されたことを確認してから、残った重複オブジェクトを処理します。
Learnには、このケース固有の後片付けの順序は記載されていません。スレッドの返信では、先に ImmutableId を設定して同期と確認を行い、その後に重複オブジェクトを削除していました。何かを削除する前に、重複オブジェクトのライセンスとメールボックスのデータを確認してください。
Learnには関連するエラー InvalidSoftMatch が記載されています。これは、ハードマッチで該当が見つからず、ソフトマッチでクラウドオブジェクトは見つかったものの、そのオブジェクトの ImmutableId が受信した sourceAnchor と異なる場合に発生します。これは、そのクラウドオブジェクトが別のオンプレミスオブジェクトから同期されたことを示唆しています。Learnの対処法は AttributeValueMustBeUnique の場合と同じです。重複している値と関係するオブジェクトを特定し、どちらのオブジェクトがその値を保持するかを決めたうえで、そのソースとなるディレクトリから、もう一方のオブジェクトの値を削除してください。
2026年7月以降に追加された保護機能
Learnによると、2026年7月1日以降、対象のクラウドアカウントが次のいずれかに該当する場合、ハードマッチがブロックされることがあります。
- すでに
onPremisesObjectIdentifierが設定されている - 特権の Microsoft Entra ロールが割り当てられている、または
- 特権の Microsoft Entra ロールの対象になっている
書き戻しが有効なクラウド管理アカウントは対象外です。Learnでは、これらの保護機能によって安全な対象に対するハードマッチが無効になることはないと説明されています。また、テナント全体に適用されるフラグ BlockSoftMatchEnabled と BlockCloudObjectTakeoverThroughHardMatchEnabled、および一時的なバイパス設定 AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled についても解説されています。このバイパスは既定でオフになっています。Learnでは、バイパスを有効にすると保護が弱まるため、使用後はオフに戻すべきだと警告しています。既定では、Entra は管理者ロールを持つクラウドユーザーとオンプレミスユーザーをソフトマッチさせません。また、Microsoft は既存の管理者アカウントとオンプレミスアカウントを同期させないよう強く推奨しています。
そのため、2025年のスレッドのハードマッチが今日失敗する場合、これらの保護機能のいずれかが原因である可能性があります。
シナリオ 2:同期は正常だが、アドレスが変わらない
スレッドで報告された内容。協力会社のメンバーには、会社のアドレスではなく、自分の外部メールアドレスが必要でした。ADUC上のオンプレミスアカウントには正しいアドレスが表示されていましたが、Entra上の mail と proxyAddresses にはまだ会社のアドレスが残っていました。質問者は、SharePointへのアクセス用に作成されたクラウドのみのゲストアカウントが、新しいオンプレミスアカウントと同じ外部アドレスを使用していたことを単独で突き止めました。質問者は、これが競合の原因だと書いていました。
そのスレッドで承認された返信は一般的な内容であり、診断を示したのは質問者本人であった点に注意してください。
Learn が追加する内容
- Entra ID では、
mail、proxyAddresses、signInName、userPrincipalNameの値が一意である必要があります。別のオブジェクトがすでに保持している値を追加または更新すると、AttributeValueMustBeUniqueが発生します。 - 重複属性の耐性は既定の動作であり、無効にはできません。対象は UPN と SMTP の
proxyAddresses値のみです。重複した値は、エクスポートを失敗させる代わりに Entra が隔離します。ただし、データ自体は修正されません。また、Learn のページではmailが対象の属性として記載されていません。 - UPN が重複している場合は、
<OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.comの形式でプレースホルダーが割り当てられます。隔離された SMTP プロキシ アドレスは、オブジェクトの作成または更新が行われている間、保留されます。 - エクスポート自体は成功するため、同期クライアントはエラーを記録せず、再試行もしません。
これはスレッドで報告されていた内容と一致します。目に見える失敗はなく、値が 1 つ欠けている状態です。承認された返信では重複属性の耐性について一般的に触れているonly で、それが適用されたかどうかは誰も確認していません。したがって、これは妥当な説明ではありますが、確定した原因ではありません。
競合を見つける方法
- Microsoft Entra 管理センターで、Microsoft Entra Connect Health の同期エラー レポートを開きます。Learn によると、約 30 分ごとに更新され、直近の同期試行によるエラーが表示されます。
- 隔離された値については、Learn では次のように案内されています。
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
AttributeValueMustBeUniqueとInvalidSoftMatchに対する Learn の対処方法は同じです。重複している値と関係するオブジェクトを特定し、どのオブジェクトがその値を保持するかを決めます。そのうえで、もう一方のオブジェクトからは、そのオブジェクトの同期元であるディレクトリで値を削除し、Entra Connect による同期を待ちます。場合によっては、競合している片方のオブジェクトを削除する必要があります。- 競合が解消されると、バックグラウンド ジョブによって隔離された属性が削除されます。Learn によると、このジョブは 1 時間ごとに実行されます。
クラウドのみのゲスト ユーザーの場合は、そのゲスト ユーザーのアドレスを変更または削除し、次回の同期を待つことになります。
確認
- Entra ID でユーザーを検索し、
mail、proxyAddresses、UPN を AD と比較します。 Start-ADSyncSyncCycle -PolicyType Deltaを実行し、再度確認します。- エラー レポートにそのオブジェクトが表示されなくなったことを確認します。
一括変更を行う場合は、ステージング サーバーに関する Learn の記事に、アクティブ モードに切り替える前に csexport と CSExportAnalyzer で保留中のエクスポートをプレビューする方法が記載されています。
制限事項
- スレッドの内容だけでは、どの手順で問題が解決したのかは証明できません。
- スレッド内のハードマッチ用コマンドは古いモジュールを使用しています。最新の Learn のガイダンスを参照してください。
- Learn では、誤って作成された重複オブジェクトを削除する際の手順順序は説明されていません。まず 1 ユーザーで検証してください。
関連情報
データソース
- Microsoft Learn: ソフトマッチとハードマッチ、既存テナント向けの Entra Connect
- Microsoft Learn: 同期中のエラーのトラブルシューティング
- Microsoft Learn: ID 同期と重複属性の耐性
- Microsoft Learn: UserPrincipalName と代替ログイン ID の計画
- Microsoft Learn: ステージング サーバー
- Microsoft Learn: Update-MgUser
- Microsoft Q&A: Entra Connect Sync により onmicrosoft.com ドメインのユーザーが 2 つ作成される(2025 年 10 月)
- Microsoft Q&A: AD Connect の同期で mail と proxyAddresses が更新されない(2025 年 1 月)