| external help file | IdLE-help.xml |
|---|---|
| Module Name | IdLE |
| online version | |
| schema | 2.0.0 |
Creates a lifecycle request object.
New-IdleRequest [-LifecycleEvent] <String> [[-CorrelationId] <String>] [[-Actor] <String>]
[[-IdentityKeys] <Hashtable>] [[-Intent] <Hashtable>] [[-Context] <Hashtable>]
[-ProgressAction <ActionPreference>] [<CommonParameters>]
Creates and normalizes an IdLE LifecycleRequest representing business intent (e.g. Joiner/Mover/Leaver). CorrelationId is generated if missing. Actor is optional.
# Minimal Joiner request - CorrelationId is auto-generated, Intent/Context default to empty
New-IdleRequest -LifecycleEvent Joiner -CorrelationId (New-Guid) -IdentityKeys @{ EmployeeId = '12345' }
# Joiner request with caller-provided action inputs (Intent) and read-only associated context (Context)
New-IdleRequest -LifecycleEvent Joiner -CorrelationId (New-Guid) -IdentityKeys @{ EmployeeId = '12345' } -Intent @{ Department = 'Engineering'; Title = 'Engineer' } -Context @{ Identity = @{ ObjectId = 'abc-123' } }
The lifecycle event name (e.g. Joiner, Mover, Leaver).
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseCorrelation identifier for audit/event correlation. Generated if missing.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseOptional actor claim who initiated the request. Not required by the core engine in V1.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseA hashtable of system-neutral identity keys (e.g. EmployeeId, UPN, ObjectId).
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: @{}
Accept pipeline input: False
Accept wildcard characters: FalseA hashtable containing the caller-provided action inputs for the workflow (attributes, entitlements, operator flags, etc.).
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: @{}
Accept pipeline input: False
Accept wildcard characters: FalseA hashtable containing read-only associated context provided by the host or resolvers (e.g. identity snapshots, device hints). Must not be treated as mutable state within IdLE.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: @{}
Accept pipeline input: False
Accept wildcard characters: FalseTODO: ProgressAction Description
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.