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.

  • -Features hiermee geeft u de functie(s) voor adreslijstsynchronisatie op die u wilt in- of uitschakelen.
  • -Enable geeft aan of de opgegeven functies zijn ingeschakeld voor het bedrijf.
  • -Force Hiermee 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.

  • -Features hiermee geeft u de functie(s) voor adreslijstsynchronisatie op die u wilt in- of uitschakelen.
  • -Enable geeft 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.

  • -Features hiermee geeft u de functie(s) voor adreslijstsynchronisatie op die u wilt in- of uitschakelen.
  • -Enable geeft aan of de opgegeven functies zijn ingeschakeld voor het bedrijf.
  • -TenantId Hiermee 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