IdLE.Step.CreateIdentity

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

Summary

• Step Type: IdLE.Step.CreateIdentity
• Module: IdLE.Steps.Common
• Implementation: Invoke-IdleStepCreateIdentity
• Idempotent: Yes
• Required Capabilities: IdLE.Identity.Create

Synopsis

Creates a new identity in the target system.

Description

The engine passes the provider resolved from With.Provider (default 'Identity') as -Provider. The provider implements CreateIdentity(identityKey, attributes) and returns an object with properties 'IdentityKey' and 'Changed'.

The step is idempotent by design: if the identity already exists, the provider should return Changed = $false without creating a duplicate.

Authentication is handled by the engine: With.AuthSessionName and With.AuthSessionOptions select the auth session passed to provider methods that declare an AuthSession parameter.

Inputs (With.*)

Validated at plan time against the step's WithSchema (see Step metadata contract).

Key	Type	Required	Default	Notes
Attributes	Hashtable	Yes
IdentityKey	String	Yes
AuthSessionName	String	No	broker default session	Auth session routing key for the AuthSessionBroker.
AuthSessionOptions	Hashtable	No		Data-only options passed to the AuthSessionBroker.
Provider	String	No	Identity	Provider alias in Providers.

Example

@{
  Name = 'IdLE.Step.CreateIdentity Example'
  Type = 'IdLE.Step.CreateIdentity'
  With = @{
    Attributes           = @{ GivenName = 'First'; Surname = 'Last' }
    IdentityKey          = 'user.name'
  }
}

See Also

• Capabilities Reference - Details on required capabilities
• Providers - Available provider implementations