Set-EntraDirSyncEnabled

Aktiverar eller inaktiverar katalogsynkronisering för ett företag.

Syntax

Default (Standard)

Set-EntraDirSyncEnabled

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

Description

Cmdleten Set-EntraDirSyncEnabled aktiverar eller inaktiverar katalogsynkronisering för ett företag.

Ett nytt huvudnamn för tjänsten visas i klientorganisationen när du aktiverar eller återaktiverar DirSync. Det har appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016 och visningsnamnet Microsoft Entra AD Synchronization Service.

Det kan ta upp till 72 timmar att inaktivera DirSync, beroende på antalet objekt i din molnprenumeration. När processen har inaktiverats kan den inte avbrytas och måste slutföras innan du kan vidta ytterligare åtgärder, inklusive återaktivering av DirSync.

Om du återaktiverar DirSync sker en fullständig synkronisering, vilket kan ta betydande tid baserat på antalet objekt i Microsoft Entra ID.

Om BlockCloudObjectTakeoverThroughHardMatch det är aktiverat blockerar återaktivering av DirSync dessutom on-prem till molnobjektövertagande/uppdateringar för alla Microsoft Entra ID-mastered-objekt. Om du vill tillåta synkronisering av dessa objekt anger du BlockCloudObjectTakeoverThroughHardMatch till false.

Exempel

Exempel 1: Aktivera katalogsynkronisering

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

Det här exemplet aktiverar katalogsynkronisering för ett företag.

  • -EnableDirsync Anger om katalogsynkronisering ska aktiveras för ditt företag.
  • -Force Tvingar kommandot att köras utan att be om användarbekräftelse.

Exempel 2: Inaktivera katalogsynkronisering

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

Det här exemplet inaktiverar katalogsynkronisering för ett företag.

  • -EnableDirsync Anger om katalogsynkronisering ska aktiveras för ditt företag.
  • -Force Tvingar kommandot att köras utan att be om användarbekräftelse.
  • -TenantId Anger det unika ID för klientorganisationen som åtgärden ska utföras på.

Parametrar

-EnableDirsync

Anger om katalogsynkronisering ska aktiveras för ditt företag.

Parameteregenskaper

Typ:System.Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TenantId

Anger det unika ID för klientorganisationen som åtgärden ska utföras på. Den här parametern ger kompatibilitet med Azure AD och MSOnline för partnerscenarier. TenantID är den inloggade användarens klientorganisations-ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.