M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Entra Connect utworzył duplikat użytkownika lub pominął atrybut: dopasowanie miękkie, dopasowanie twarde i zduplikowane wartości

By ·

Nowy użytkownik lokalny utworzył drugie konto w chmurze z UPN w domenie onmicrosoft.com, albo adres e-mail nigdy się nie zaktualizował. Sprawdź, jak działa dopasowanie, jak odczytywać błędy i jak bezpiecznie ponownie powiązać konta.

Automatically translated with AI from the original post. Read the English original

Do reguł dopasowania Entra Connect prowadzą zwykle dwie sytuacje. W pierwszej nowy użytkownik lokalny pojawia się w chmurze dwukrotnie: konto, którego oczekiwano, oraz nowe zsynchronizowane konto z nazwą logowania .onmicrosoft.com. W drugiej synchronizacja przebiega bez błędów, ale atrybut mail lub proxyAddresses użytkownika w Entra ID nadal pokazuje stary adres.

Najważniejsze wnioski

  • Entra najpierw próbuje dopasowania twardego na podstawie sourceAnchor względem ImmutableId, potem dopasowania miękkiego na podstawie userPrincipalName lub głównego adresu SMTP, a w przeciwnym razie tworzy nowy obiekt.
  • Jeśli sufiks UPN z lokalnego AD nie jest zweryfikowany w dzierżawie, Entra buduje nowy UPN na podstawie mailNickName i początkowej domeny onmicrosoft.com.
  • Odporność na zduplikowane atrybuty przenosi konfliktujące wartości proxyAddresses lub UPN do kwarantanny zamiast zgłaszać błąd, więc synchronizacja może wyglądać na poprawną, mimo że jedna wartość brakuje.
  • Według Learn od 1 lipca 2026 r. dopasowanie twarde może być zablokowane dla kont w chmurze, które mają już ustawiony atrybut onPremisesObjectIdentifier, lub które posiadają albo kwalifikują się do roli uprzywilejowanej.

Oba przypadki pojawiły się w wątkach Q&A serwisu Microsoft, jeden z stycznia 2025 r., drugi z października 2025 r. W każdym z nich osoba pytająca podała, co rozwiązało problem. Techniczne podstawy sprawdziłem na aktualnych stronach Microsoft Learn. To przewodnik po rozwiązywaniu problemów, a nie oficjalna procedura Microsoft. Każdą zmianę przetestuj najpierw na jednym użytkowniku.

Jak Entra dopasowuje obiekty

Learn opisuje następującą kolejność dla nowego obiektu przychodzącego z AD:

  1. Dopasowanie twarde. Entra porównuje sourceAnchor z ImmutableId istniejących obiektów w chmurze. Domyślny sourceAnchor to postać Base64 atrybutu mS-Ds-ConsistencyGUID lub ObjectGUID, zależnie od konfiguracji.
  2. Dopasowanie miękkie. Jeśli nie ma dopasowania twardego, Entra porównuje userPrincipalName lub główną wartość SMTP: z proxyAddresses.
  3. Nowy obiekt. Jeśli żadne z dopasowań nie zadziała, Entra tworzy nowy obiekt.

Learn podaje dwa ograniczenia. Dopasowanie miękkie jest oceniane wyłącznie dla nowych obiektów. Ponadto przy dopasowaniu miękkim Entra przejmuje obiekt w chmurze i nadpisuje każdy atrybut, który ma wartość lokalnie. Atrybuty istniejące tylko w chmurze mogą zostać utracone, a przy synchronizacji hashy haseł hash hasła w chmurze zostaje zastąpiony hashem z lokalnego środowiska.

Scenariusz 1: drugi użytkownik z UPN w domenie onmicrosoft.com

Co zgłosił wątek. Administrator utworzył użytkownika w lokalnym AD. Entra Connect utworzył drugiego użytkownika Entra z UPN w domenie .onmicrosoft.com i z flagą synchronizacji lokalnej. Zamierzony użytkownik w chmurze nie miał flagi synchronizacji. Zaakceptowana odpowiedź opisywała zarówno dopasowanie miękkie, jak i twarde. Osoba pytająca później napisała, że podejście oparte na dopasowaniu twardym rozwiązało problem.

Dlaczego dopasowanie mogło się nie powieść

Wątek nie podawał powodu. Learn podaje jeden udokumentowany powód dla nazwy onmicrosoft.com: jeśli sufiks UPN lokalnego katalogu nie jest zweryfikowany w dzierżawie, Entra oblicza nowy UPN na podstawie MailNickName i domeny początkowej. Oznacza to także, że UPN nie może być zgodny z kontem użytkownika w chmurze. To jest trop, a nie diagnoza. Porównaj następujące elementy w obu kontach:

  • sufiks UPN oraz to, czy jest to zweryfikowana domena w Twojej dzierżawie
  • główny adres SMTP (wpis SMTP: w proxyAddresses)
  • to, czy konto użytkownika w chmurze już wskazuje na powiązanie z katalogiem lokalnym

Opcja A: próba dopasowania miękkiego

Pierwsze obejście proponowane w wątku polegało na tym, by dopasować lokalny UPN i adresy proxy do konta w chmurze, usunąć duplikat i ponownie uruchomić synchronizację. Learn podaje, że dopasowanie miękkie jest oceniane tylko dla nowych obiektów i nie obejmuje ponownej oceny obiektu, który jest już powiązany, po usunięciu duplikatu. Osoba zadająca pytanie ostatecznie zastosowała opcję B, więc opcję A traktuj jako niepotwierdzoną.

Opcja B: dopasowanie twarde

  1. Ustal, którego atrybutu Entra Connect używa jako sourceAnchor. Learn wymienia mS-Ds-ConsistencyGUID lub ObjectGUID.
  2. Przekonwertuj lokalny GUID na Base64. Odpowiedź w wątku używała następującego wzorca:

``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``

  1. Ustaw wynik jako ImmutableId konta użytkownika w chmurze. Odpowiedź w wątku używała polecenia Set-MsolUser, które pochodzi ze starszego modułu MSOnline. Aktualne strony Learn korzystają z Microsoft Graph PowerShell. Strona Update-MgUser dokumentuje parametr -OnPremisesImmutableId i informuje, że tylko określone uprzywilejowane role administratora mogą go aktualizować. Przed uruchomieniem sprawdź uwagi dotyczące parametrów na tej stronie.
  2. Uruchom synchronizację deltą:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. Potwierdź, że docelowe konto użytkownika w chmurze pokazuje teraz flagę synchronizacji, a następnie zajmij się pozostałym duplikatem.

Learn nie opisuje kolejności czynności porządkowych dla tego dokładnego przypadku. Odpowiedź w wątku najpierw ustawiła ImmutableId, potem wykonała synchronizację i sprawdzenie, a dopiero na końcu usunęła duplikat. Przed usunięciem czegokolwiek sprawdź licencje i dane skrzynki pocztowej na duplikacie.

Learn dokumentuje powiązany błąd InvalidSoftMatch. Pojawia się on wtedy, gdy dopasowanie twarde nic nie znajduje, dopasowanie miękkie znajduje obiekt w chmurze, ale ten obiekt ma inny ImmutableId niż przychodzący sourceAnchor. Sugeruje to, że obiekt w chmurze został zsynchronizowany z innym obiektem lokalnym. Rozwiązanie podane przez Learn jest takie samo jak dla AttributeValueMustBeUnique: zidentyfikuj zduplikowaną wartość oraz powiązane obiekty, zdecyduj, który obiekt ją zachowa, a następnie usuń wartość z drugiego obiektu w katalogu, w którym jest ona pochodzi.

Nowe zabezpieczenia od lipca 2026 roku

Learn podaje, że od 1 lipca 2026 roku dopasowanie twarde może zostać zablokowane, gdy docelowe konto w chmurze:

  • ma już ustawiony onPremisesObjectIdentifier,
  • ma przypisaną uprzywilejowaną rolę Microsoft Entra lub
  • kwalifikuje się do uprzywilejowanej roli Microsoft Entra.

Konta zarządzane w chmurze z włączonym zapisem zwrotnym są wyłączone spod tych zasad. Learn podaje, że te zabezpieczenia nie wyłączają dopasowania twardego dla bezpiecznych celów. Opisuje też flagi obejmujące całą dzierżawę, BlockSoftMatchEnabled i BlockCloudObjectTakeoverThroughHardMatchEnabled, oraz tymczasowe obejście, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, które domyślnie jest wyłączone. Learn ostrzega, że obejście osłabia ochronę i po jego użyciu należy je wyłączyć. Domyślnie Entra nie dokonuje też dopasowania miękkiego użytkowników lokalnych do kont w chmurze, które mają rolę administratora, a Microsoft zdecydowanie odradza synchronizowanie kont lokalnych z istniejącymi kontami administracyjnymi.

Jeśli więc dopasowanie twarde z wątku z 2025 roku dziś się nie udaje, przyczyną może być jedno z tych zabezpieczeń.

Scenariusz 2: synchronizacja działa, ale adres się nie zmienia

Co zgłoszono w wątku. Współpracownicy zewnętrzni potrzebowali własnych zewnętrznych adresów e-mail zamiast adresu firmowego. Konta lokalne pokazywały właściwe adresy w ADUC, ale mail i proxyAddresses w Entra nadal zawierały adres firmowy. Osoba zadająca pytanie sama znalazła przyczynę: konta gości utworzone wyłącznie w chmurze, założone na potrzeby dostępu do SharePoint, używały tych samych zewnętrznych adresów co nowe konta lokalne. Autor napisał, że to właśnie był konflikt.

Zwróć uwagę, że zaakceptowana odpowiedź w tym wątku była ogólna, a diagnozę postawiła osoba zadająca pytanie.

Co dodaje Learn

  • Entra ID wymaga unikalnych wartości dla mail, proxyAddresses, signInName i userPrincipalName. Dodanie lub aktualizacja wartości, którą już posiada inny obiekt, powoduje błąd AttributeValueMustBeUnique.
  • Odporność na zduplikowane atrybuty to domyślne zachowanie, którego nie można wyłączyć. Obejmuje ona wyłącznie wartości UPN oraz SMTP w proxyAddresses: Entra umieszcza zduplikowaną wartość w kwarantannie zamiast przerywać eksport. Nie naprawia ona danych, a strona Learn nie wymienia mail wśród atrybutów, które obejmuje.
  • W przypadku zduplikowanego UPN przypisywany jest symbol zastępczy o postaci <OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Adres proxy SMTP objęty kwarantanną jest wstrzymywany, a obiekt mimo to zostaje utworzony lub zaktualizowany.
  • Ponieważ eksport kończy się sukcesem, klient synchronizacji nie zapisuje żadnego błędu i nie ponawia próby.

To zgadza się z tym, co opisano w wątku: brak widocznego błędu i jedna brakująca wartość. Zaakceptowana odpowiedź wspominała o odporności na zduplikowane atrybuty tylko ogólnie, a nikt nie potwierdził, że miała ona zastosowanie. Jest to więc prawdopodobne wyjaśnienie, ale nie potwierdzone.

Jak znaleźć konflikty

  1. W centrum administracyjnym Microsoft Entra otwórz raport Błędy synchronizacji w usłudze Microsoft Entra Connect Health. Według Learn raport odświeża się mniej więcej co 30 minut i pokazuje błędy z ostatniej próby synchronizacji.
  2. W przypadku wartości objętych kwarantanną Learn pokazuje:

``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``

  1. Rozwiązanie wskazane przez Learn jest takie samo dla AttributeValueMustBeUnique i InvalidSoftMatch: ustal zduplikowaną wartość i zaangażowane obiekty, zdecyduj, który obiekt ją zachowa, usuń ją z drugiego obiektu w katalogu, z którego ten obiekt pochodzi, a następnie pozwól programowi Entra Connect przeprowadzić synchronizację. W niektórych przypadkach może być konieczne usunięcie jednego z konfliktujących obiektów.
  2. Zadanie w tle usuwa atrybuty objęte kwarantanną, gdy konflikt zostanie usunięty. Według Learn działa ono co godzinę.

W przypadku gościa oznacza to zmianę lub usunięcie adresu w koncie gościa istniejącym wyłącznie w chmurze, a następnie oczekiwanie na kolejną synchronizację.

Weryfikacja

  1. Wyszukaj użytkownika w usłudze Entra ID i porównaj mail, proxyAddresses oraz UPN z AD.
  2. Uruchom Start-ADSyncSyncCycle -PolicyType Delta, a następnie sprawdź ponownie.
  3. Upewnij się, że raport błędów nie wymienia już tego obiektu.

W przypadku zmian zbiorczych artykuł Learn o serwerze przejściowym opisuje sposób podglądu oczekujących eksportów za pomocą csexport i CSExportAnalyzer, zanim przełączysz się w tryb aktywny.

Ograniczenia

  • Wątki nie dowodzą, który krok rozwiązał Twój przypadek.
  • Polecenia dopasowania twardego (hard match) z wątku używają starszego modułu. Stosuj aktualne wskazówki Learn.
  • Learn nie dokumentuje kolejności czyszczenia po błędnie utworzonym duplikacie. Przetestuj to na jednym użytkowniku.

Powiązane

Źródła

Obserwuj podcastSpotify

Entities in this article

Microsoft Entra Connect Microsoft Entra ID Microsoft Entra Connect Health Microsoft Graph PowerShell

Related articles

RSS