Skip to content

step-trigger-directory-sync.md

Latest commit

 

History

History
63 lines (42 loc) · 1.6 KB

step-trigger-directory-sync.md

File metadata and controls

63 lines (42 loc) · 1.6 KB

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:

Key Required Description
AuthSessionName Yes Name of auth session to use (optional)
PolicyType Yes Type 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