Set-EntraDirSyncFeature
Wordt gebruikt voor het instellen van functies voor identiteitssynchronisatie voor een tenant.
Syntax
Default (Standaard)
Set-EntraDirSyncFeature
-Features <String[]>
-Enabled <Boolean>
[-TenantId <String>]
[-Force]
[<CommonParameters>]
Description
Met de Set-EntraDirSyncFeature cmdlet worden functies voor identiteitssynchronisatie voor een tenant ingesteld.
In gedelegeerde scenario's moet de aangemelde gebruiker beschikken over een ondersteunde Microsoft Entra rol of een aangepaste rol met de benodigde machtigingen. De minimale rollen die vereist zijn voor deze bewerking zijn:
- Globale beheerder
Opmerking: U kunt de volgende synchronisatiefuncties gebruiken met deze cmdlet:
-
EnableSoftMatchOnUpn: Zachte overeenkomst is het proces dat wordt gebruikt om een object dat voor het eerst vanuit on-premises wordt gesynchroniseerd, te koppelen aan een object dat al in de cloud bestaat. Wanneer deze functie is ingeschakeld, wordt geprobeerd de standaardlogica te gebruiken op basis van het primaire SMTP-adres. Als een overeenkomst niet wordt gevonden op basis van primaire SMTP, wordt een overeenkomst geprobeerd op basis van UserPrincipalName. Zodra deze functie is ingeschakeld, kan deze niet worden uitgeschakeld. -
PasswordSync: Wordt gebruikt om on-premises wachtwoordsynchronisatie aan te geven. -
SynchronizeUpnForManagedUsers: Hiermee kunnen updates van UserPrincipalName van on-premises worden gesynchroniseerd voor beheerde (niet-federated) gebruikers waaraan een licentie is toegewezen. Deze updates worden geblokkeerd als deze functie niet is ingeschakeld. Zodra deze functie is ingeschakeld, kan deze niet worden uitgeschakeld. -
BlockSoftMatch: Wanneer deze functie is ingeschakeld, wordt de functie voor zachte overeenkomsten geblokkeerd. Klanten worden aangemoedigd om deze functie in te schakelen en ingeschakeld te houden totdat zachte overeenkomsten opnieuw vereist zijn voor hun tenancy. Deze vlag moet opnieuw worden ingeschakeld nadat eventuele zachte overeenkomsten zijn voltooid en niet meer nodig is. -
BlockCloudObjectTakeoverThroughHardMatch: Wordt gebruikt om de overname van cloudobjecten te blokkeren via een harde overeenkomst met bronanker.
Het inschakelen van functies zoals EnableSoftMatchOnUpn en SynchronizationUpnForManagedUsers is permanent en kan niet ongedaan worden gemaakt.
Voorbeelden
Voorbeeld 1: Functies inschakelen voor de tenant
Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All'
Set-EntraDirSyncFeature -Features 'BlockCloudObjectTakeoverThroughHardMatch', 'EnableSoftMatchOnUpn' -Enable $true
Met deze opdracht schakelt u de functie SoftMatchOnUpn en BlockCloudObjectTakeoverThroughHardMatch voor de tenant in.
-
-Featureshiermee geeft u de functie(s) voor adreslijstsynchronisatie op die u wilt in- of uitschakelen. -
-Enablegeeft aan of de opgegeven functies zijn ingeschakeld voor het bedrijf. -
-ForceHiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
Voorbeeld 2: Zachte overeenkomsten voor de tenant blokkeren
Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All'
Set-EntraDirSyncFeature -Features 'BlockSoftMatch' -Enable $true
Met deze opdracht schakelt u de functie BlockSoftMatch voor de tenant in. Hiermee blokkeert u de functie Soft Matching in de tenant.
-
-Featureshiermee geeft u de functie(s) voor adreslijstsynchronisatie op die u wilt in- of uitschakelen. -
-Enablegeeft aan of de opgegeven functies zijn ingeschakeld voor het bedrijf.
Voorbeeld 3: Overname van cloudobject blokkeren via vaste overeenkomsten voor de tenant
Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All'
$tenantID = (Get-EntraContext).TenantId
Set-EntraDirSyncFeature -Features 'BlockCloudObjectTakeoverThroughHardMatch' -Enable $true -TenantId $tenantID -Force
Met deze opdracht wordt de functie BlockCloudObjectTakeoverThroughHardMatch voor de tenant ingeschakeld, waardoor de overname van het object Hard Match effectief wordt geblokkeerd.
-
-Featureshiermee geeft u de functie(s) voor adreslijstsynchronisatie op die u wilt in- of uitschakelen. -
-Enablegeeft aan of de opgegeven functies zijn ingeschakeld voor het bedrijf. -
-TenantIdHiermee geeft u de unieke id van de tenant.
Parameters
-Enable
Geeft aan of de opgegeven functies zijn ingeschakeld voor het bedrijf.
Parametereigenschappen
| Type: | System.Boolean |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Features
De DirSync-functie(s) die u wilt in- of uitschakelen.
Parametereigenschappen
| Type: | System.String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Feature |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
Parametereigenschappen
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-TenantId
De unieke id van de tenant waarop de bewerking moet worden uitgevoerd. Deze parameter biedt compatibiliteit met Azure AD en MSOnline voor partnerscenario's. TenantID is de tenant-id van de aangemelde gebruiker.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Notities
- Zie Update onPremisesDirectorySynchronization voor meer informatie.
- Zie het resourcetype onPremisesDirectorySynchronizationFeature voor de lijst met functies.