Microsoft Entra Connect Sync (eski adıyla Azure AD Connect), şirket içindeki Active Directory nesnelerini Microsoft Entra ID ile eşitlemek için kullanılan araçlardan biridir. Sistem yöneticisi olarak bazen bir kullanıcı veya grup değişikliğinin zamanlanmış döngüyü beklemeden eşitlenmesini isteyebilirsiniz. Bu kısa uygulama notunda, ADSync PowerShell modülüyle zamanlayıcıyı kontrol etmeyi, Delta ve Initial senkronizasyonu başlatmayı ve sık yapılan hatalardan kaçınmayı anlatıyorum.

Microsoft Entra Connect Sync PowerShell komutları

Komutları Microsoft Entra Connect Sync’in kurulu olduğu sunucuda, gerekli yerel yönetim izinlerine sahip bir PowerShell oturumunda çalıştırın. Bunlar Microsoft Entra Cloud Sync aracısının komutları değildir; iki ürünün yönetim modeli farklıdır.

Import-Module ADSync
Get-ADSyncScheduler

Import-Module ADSync ilgili cmdlet’leri yükler. Get-ADSyncScheduler ise zamanlayıcının durumunu, geçerli döngü aralığını, sıradaki döngü zamanını ve bir sonraki döngünün Delta mı Initial mı olacağını gösterir.

ADSync PowerShell modülünün ve senkronizasyon zamanlayıcısı durumunun görüntülenmesi
Önceki uygulama ortamımızdan ADSync komutlarının çalıştırılması.

Delta senkronizasyonu manuel başlatma

Active Directory’de bir kullanıcının özniteliğini güncellediğinizde veya var olan bir grupta değişiklik yaptığınızda, genel olarak Delta döngüsü yeterlidir. Bu işlem bağlayıcılardaki değişiklikleri içe alır, eşitleme motorunda işler ve uygun değişiklikleri dışa aktarır.

Start-ADSyncSyncCycle -PolicyType Delta

Bu komut bir senkronizasyon döngüsünü başlatma isteği gönderir; her kullanıcının bulutta anında güncellendiğini garanti etmez. Sonucu, bağlayıcı ve dışa aktarma adımlarını kontrol ederek doğrulamak gerekir. Devam eden bir döngü, hizmet sorunu veya yapılandırma hatası varsa önce bunları inceleyin.

Initial (tam) senkronizasyon ne zaman kullanılır?

Initial döngüsü bütün bağlayıcılarda Full Import, Full Synchronization ve Export adımlarını çalıştırır. Yeni eşitleme kuralları, kapsamlı filtre değişiklikleri veya tam yeniden değerlendirme gerektiren işlemler için kullanılabilir. Ancak her kullanıcı değişikliğinden sonra çalıştırılması gerekmez; büyük ortamlarda uzun sürebilir.

Start-ADSyncSyncCycle -PolicyType Initial

Microsoft, bazı kural değişikliklerinde yalnızca ilgili bağlayıcıya Full Import veya Full Sync gereksinimi tanımlanmasını da destekler. Üretim ortamında gereksiz tam döngüler yerine değişikliğin niteliğine uygun yöntemi seçin.

Microsoft Entra Connect Sync Delta ve Initial komutları örnek PowerShell çıktısı
Delta ve Initial senkronizasyon komutlarının eski uygulama örneği.

Zamanlanmış eşitlemeyi kontrol etme ve yapılandırma

Entra Connect Sync’te nesne ve öznitelik eşitleme döngüsünün varsayılan aralığı 30 dakikadır. Ortamınızın desteklenen minimum aralığını AllowedSyncCycleInterval alanından kontrol edin. Daha sık bir döngü tanımlasanız bile desteklenen minimum aralıktan daha sık çalıştırılması beklenmez.

Get-ADSyncScheduler | Format-List *

# Zamanlanmış eşitleme kapalıysa, nedeni doğruladıktan sonra yeniden açın:
Set-ADSyncScheduler -SyncCycleEnabled $true

# Örnek: 3 saatlik döngü
Set-ADSyncScheduler -CustomizedSyncCycleInterval 03:00:00

# Örnek: 24 saatlik döngü
Set-ADSyncScheduler -CustomizedSyncCycleInterval 1.0:0:0

# Değişikliği kontrol edin:
Get-ADSyncScheduler

Bu iki aralık yalnızca yapılandırma örneğidir; sırf daha az yük oluşturmak için varsayılan 30 dakikalık döngüyü uzatmanızı önermiyorum. Microsoft, son Delta veya tam eşitlemenin ardından en fazla yedi gün içinde Delta eşitlemesi yapılması gerektiğini belirtiyor. Aksi halde sorunları gidermek için tam eşitleme gerekebilir. Bakım süreçlerini yöneten MaintenanceEnabled alanını da gereksiz yere kapatmayın.

Zamanlayıcıyı geçici olarak durdurmanız gereken bir kural/filtre değişikliği yapıyorsanız bakım planı oluşturun. İşlem bittiğinde Set-ADSyncScheduler -SyncCycleEnabled $true ile yeniden açmayı ve durumunu kontrol etmeyi unutmayın. Yükseltme sırasında Connect’in kullandığı SchedulerSuspended alanını elle değiştirmek desteklenen bir yöntem değildir.

Senkronizasyon sonucunu nereden takip edebiliriz?

Komutun ardından sunucudaki Synchronization Service Manager (miisclient.exe) uygulamasını açarak Operations bölümündeki Import, Synchronization ve Export adımlarını inceleyebilirsiniz. Özellikle hata veya karantinaya alınmış dışa aktarma işlemlerini kontrol edin. Yalnızca PowerShell komutunun çalışması, değişikliğin Entra ID tarafına başarıyla yazıldığını göstermez.

Microsoft Entra Connect Synchronization Service Manager üzerinde eşitleme adımlarını inceleme
Synchronization Service Manager üzerinden çalıştırılan işlemleri takip edebilirsiniz.

Üretim ortamlarında dikkat edilmesi gerekenler

  • Staging Mode: Yedek Entra Connect sunucusunda içe alma ve eşitleme yapılabilir; ancak staging mode, dışa aktarma işlemlerini baskılar. Bu nedenle staging sunucusunda başlatılan bir döngüden buluta değişiklik yazılmasını beklemeyin.
  • Komut yetkisi: Gerekli haklara sahip bir oturum kullanın; komutları rastgele istemci bilgisayarında değil Connect sunucusunda çalıştırın.
  • Delta / Initial seçimi: Günlük nesne değişiklikleri için genellikle Delta; kapsamlı kural ve bağlayıcı değişiklikleri için gereksinime göre Initial veya bağlayıcıya özel Full adımlar tercih edilir.
  • Ürün ayrımı: Microsoft Entra Cloud Sync kullanıyorsanız bu ADSync komutlarını Cloud Sync aracısına uygulamayın.
  • Sürüm ve kimlik doğrulama: Microsoft’un 2027 yılına ilişkin Connect Sync yükseltme ve uygulama tabanlı kimlik doğrulama zorunluluğunu içeren güncel duyurularını takip edin; geçerli destek koşullarını yayın tarihinden sonra yeniden kontrol edin.

Kısa komut özeti

Komutİşlevi
Import-Module ADSyncADSync komutlarını kullanıma hazırlar.
Get-ADSyncSchedulerZamanlayıcı ve döngü durumunu gösterir.
Start-ADSyncSyncCycle -PolicyType DeltaDeğişiklik bazlı döngüyü başlatır.
Start-ADSyncSyncCycle -PolicyType InitialTam döngüyü başlatır.
Set-ADSyncScheduler -SyncCycleEnabled $trueZamanlanmış eşitlemeyi etkinleştirir.

Özetle, Microsoft Entra Connect Sync’te en çok kullanacağınız komut çoğu zaman Start-ADSyncSyncCycle -PolicyType Delta olacaktır. Fakat bir senkronizasyon sorununu çözerken yalnızca döngüyü yeniden başlatmak yerine Operations ekranındaki gerçek hata adımlarını incelemek gerekir. Umarım bu not günlük yönetim çalışmalarınızda faydalı olur.

Microsoft teknik kaynakları

Published On: 28 Ocak 2020 / Categories: Microsoft Azure / 5,5 min read /

Bilgiyi Paylaşın!