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.
-
-EnableDirsyncOkreśla, czy włączyć synchronizację katalogów dla firmy. -
-ForceWymusza 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.
-
-EnableDirsyncOkreśla, czy włączyć synchronizację katalogów dla firmy. -
-ForceWymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika. -
-TenantIdOkreś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.