Set-EntraDirSyncEnabled

Set-EntraDirSyncEnabled

    -EnableDirSync <Boolean>
    [-Force]
    [-TenantId <String>]
    [<CommonParameters>]

Das Set-EntraDirSyncEnabled Cmdlet aktiviert oder deaktiviert die Verzeichnissynchronisierung für ein Unternehmen.

Ein neuer Dienstprinzipal wird in Ihrem Mandanten angezeigt, wenn Sie DirSync aktivieren oder erneut aktivieren. Sie verfügt über die appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 und den Anzeigenamen Microsoft Entra AD-Synchronisierungsdienst.

Die Deaktivierung von DirSync kann je nach Anzahl der Objekte in Ihrem Cloudabonnement bis zu 72 Stunden dauern. Nach der Deaktivierung kann der Vorgang nicht abgebrochen werden und muss abgeschlossen werden, bevor Sie weitere Maßnahmen ergreifen können, einschließlich der erneuten Aktivierung von DirSync.

Wenn Sie DirSync erneut aktivieren, tritt eine vollständige Synchronisierung auf, was je nach Anzahl der Objekte in Microsoft Entra ID erhebliche Zeit in Anspruch nehmen kann.

Wenn BlockCloudObjectTakeoverThroughHardMatch diese Option aktiviert ist, blockiert die erneute Aktivierung von DirSync on-Prem die Übernahme/Aktualisierung von Cloudobjekten für alle Microsoft Entra ID mastered-Objekte. Um die Synchronisierung dieser Objekte zuzulassen, legen Sie diesen Wert auf "false" fest BlockCloudObjectTakeoverThroughHardMatch .

Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All', 'Organization.ReadWrite.All'
Set-EntraDirSyncEnabled -EnableDirsync $true -Force $true

In diesem Beispiel wird die Verzeichnissynchronisierung für ein Unternehmen aktiviert.

• -EnableDirsync Gibt an, ob die Verzeichnissynchronisierung für Ihr Unternehmen aktiviert werden soll.
• -Force Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All', 'Organization.ReadWrite.All'
$tenantID = (Get-EntraContext).TenantId
Set-EntraDirSyncEnabled -EnableDirsync $false -TenantId $tenantID -Force

In diesem Beispiel wird die Verzeichnissynchronisierung für ein Unternehmen deaktiviert.

• -EnableDirsync Gibt an, ob die Verzeichnissynchronisierung für Ihr Unternehmen aktiviert werden soll.
• -Force Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.
• -TenantId Gibt die eindeutige ID des Mandanten an, für den der Vorgang ausgeführt werden soll.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.