Update-IvantiTask
SYNOPSIS
Update a task in Ivanti ITSM.
SYNTAX
RecID (Default)
Update-IvantiTask -recID <String> -body <Hashtable> [-noteSubject <String>] [-noteBody <String>]
[<CommonParameters>]
taskNumber
Update-IvantiTask -taskNumber <Int32> -body <Hashtable> [-noteSubject <String>] [-noteBody <String>]
[<CommonParameters>]
DESCRIPTION
The `Update-Task` function allows you to update a task in Ivanti ITSM. You can specify the task using either the task number or the record ID. The function also accepts a hashtable containing the fields to be updated.
EXAMPLES
EXAMPLE 1
Updates the task with the task number 12345 and sets the status to 'Completed'.
EXAMPLE 2
Updates the task with the record ID 'abc123' and sets the priority to 'High'.
EXAMPLE 3
Update-IvantiTask -taskNumber 12345 -body @{ 'Status' = 'In Progress' } -noteSubject 'Status Update' -noteBody 'Task work started'
Updates the task and adds a note documenting the change.
PARAMETERS
-taskNumber
The task number of the task to update. This parameter is mandatory when using the 'taskNumber' parameter set.
Type: Int32
Parameter Sets: taskNumber
Aliases: task
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-recID
The record ID of the task to update. This parameter is mandatory when using the 'RecID' parameter set.
Type: String
Parameter Sets: RecID
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-body
A hashtable containing the fields to be updated. This parameter is mandatory.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-noteSubject
Optional subject for the update note. If provided, a note will be added to the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-noteBody
Optional body for the update note. If provided along with noteSubject, a detailed note will be added to the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS
OUTPUTS
NOTES
This function is useful for updating tasks in Ivanti ITSM.