Set-EntraDirSyncEnabled

Hiermee schakelt u adreslijstsynchronisatie in of uit voor een bedrijf.

Syntax

Default (Standaard)

Set-EntraDirSyncEnabled

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

Description

De Set-EntraDirSyncEnabled cmdlet schakelt adreslijstsynchronisatie in of uit voor een bedrijf.

Er wordt een nieuwe service-principal weergegeven in uw tenant wanneer u DirSync inschakelt of opnieuw inschakelt. Deze bevat de appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 en de weergavenaam Microsoft Entra AD-synchronisatieservice.

Het deactiveren van DirSync kan tot 72 uur duren, afhankelijk van het aantal objecten in uw cloudabonnement. Als het proces is uitgeschakeld, kan het niet worden geannuleerd en moet het worden voltooid voordat u verdere actie kunt ondernemen, inclusief het opnieuw inschakelen van DirSync.

Als u DirSync opnieuw inschakelt, treedt er een volledige synchronisatie op, wat veel tijd kan duren op basis van het aantal objecten in Microsoft Entra ID.

Als BlockCloudObjectTakeoverThroughHardMatch dirSync is ingeschakeld, worden on-premises on-premises updates geblokkeerd voor alle Microsoft Entra ID-hoofdobjecten. Als u het synchroniseren van deze objecten wilt toestaan, stelt u deze in op BlockCloudObjectTakeoverThroughHardMatch onwaar.

Voorbeelden

Voorbeeld 1: Adreslijstsynchronisatie inschakelen

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

In dit voorbeeld wordt adreslijstsynchronisatie voor een bedrijf ingeschakeld.

  • -EnableDirsync Hiermee geeft u op of adreslijstsynchronisatie moet worden ingeschakeld voor uw bedrijf.
  • -Force Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Voorbeeld 2: Adreslijstsynchronisatie uitschakelen

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

In dit voorbeeld wordt adreslijstsynchronisatie voor een bedrijf uitgeschakeld.

  • -EnableDirsync Hiermee geeft u op of adreslijstsynchronisatie moet worden ingeschakeld voor uw bedrijf.
  • -Force Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.
  • -TenantId Hiermee geeft u de unieke id op van de tenant waarop de bewerking moet worden uitgevoerd.

Parameters

-EnableDirsync

Hiermee geeft u op of adreslijstsynchronisatie moet worden ingeschakeld voor uw bedrijf.

Parametereigenschappen

Type:System.Boolean
Default value:None
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

-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:None
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

Hiermee geeft u de unieke id op 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.