Skip to main content

IdLE.Step.TriggerDirectorySync

Generated file. Do not edit by hand. Source: tools/Generate-IdleStepReference.ps1

Summary​

  • Step Type: IdLE.Step.TriggerDirectorySync
  • Module: IdLE.Steps.DirectorySync
  • Implementation: Invoke-IdleStepTriggerDirectorySync
  • Idempotent: Unknown

Synopsis​

Triggers a directory sync cycle and optionally waits for completion.

Description​

The host must supply a provider instance via Context.Providers[<ProviderAlias>] that implements:

  • StartSyncCycle(PolicyType, AuthSession)

  • GetSyncCycleState(AuthSession)

The step is designed for remote execution and requires an elevated auth session provided by the host's AuthSessionBroker.

Authentication:

  • With.AuthSessionName (required): routing key for AuthSessionBroker

  • With.AuthSessionOptions (optional, hashtable): forwarded to broker for session selection

  • ScriptBlocks in AuthSessionOptions are rejected (security boundary)

Inputs (With.*)​

The following keys are required in the step's With configuration:

KeyRequiredDescription
AuthSessionNameYesName of auth session to use (optional)
PolicyTypeYesType of policy (e.g., Delta, Initial)

Example​

$step = @{
    Name = 'Trigger directory sync'
    Type = 'IdLE.Step.TriggerDirectorySync'
    With = @{
        AuthSessionName = 'DirectorySync'
        PolicyType = 'Delta'
        Wait = $true
    }
}

See Also​