Set-EntraDirSyncEnabled

Włącza lub wyłącza synchronizację katalogów dla firmy.

Składnia

Default (domyślnie)

Set-EntraDirSyncEnabled

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

Opis

Polecenie Set-EntraDirSyncEnabled cmdlet włącza lub wyłącza synchronizację katalogów dla firmy.

Nowa jednostka usługi jest wyświetlana w dzierżawie po włączeniu lub ponownym włączeniu narzędzia DirSync. Ma on identyfikator appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 i nazwę wyświetlaną Microsoft Entra usługi synchronizacji ad.

Dezaktywowanie narzędzia DirSync może potrwać do 72 godzin, w zależności od liczby obiektów w subskrypcji chmury. Po wyłączeniu nie można anulować procesu i należy go ukończyć przed podjęciem dalszych działań, w tym ponowne włączenie narzędzia DirSync.

W przypadku ponownego włączenia narzędzia DirSync zostanie wykonana pełna synchronizacja, co może zająć dużo czasu na podstawie liczby obiektów w Microsoft Entra ID.

Ponadto jeśli BlockCloudObjectTakeoverThroughHardMatch jest włączona, ponowne włączenie narzędzia DirSync spowoduje zablokowanie przejęcia/aktualizacji obiektów w chmurze na potrzeby wszystkich obiektów Microsoft Entra ID mastered. Aby zezwolić na synchronizację tych obiektów, ustaw wartość BlockCloudObjectTakeoverThroughHardMatch false.

Przykłady

Przykład 1. Włączanie synchronizacji katalogów

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

W tym przykładzie włączono synchronizację katalogów dla firmy.

  • -EnableDirsync Określa, czy włączyć synchronizację katalogów dla firmy.
  • -Force Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Przykład 2. Wyłączanie synchronizacji katalogów

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

W tym przykładzie wyłączono synchronizację katalogów dla firmy.

  • -EnableDirsync Określa, czy włączyć synchronizację katalogów dla firmy.
  • -Force Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
  • -TenantId Określa unikatowy identyfikator dzierżawy, na którym ma być wykonywana operacja.

Parametry

-EnableDirsync

Określa, czy włączyć synchronizację katalogów dla firmy.

Właściwości parametru

Typ:System.Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-TenantId

Określa unikatowy identyfikator dzierżawy, na którym ma być wykonywana operacja. Ten parametr zapewnia zgodność z usługami Azure AD i MSOnline dla scenariuszy partnerskich. TenantID to identyfikator dzierżawy zalogowanych użytkowników.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.