Skip to content

Assign-IvantiTask

SYNOPSIS

Assigns a task to a user or team in Ivanti ITSM.

SYNTAX

taskNumber (Default)

Assign-IvantiTask -taskNumber <Int32> [-owner <String>] [-ownerTeam <String>] [-noteSubject <String>]
 [-noteBody <String>] [-timeSpent <Int32>] [<CommonParameters>]

recID

Assign-IvantiTask -recID <String> [-owner <String>] [-ownerTeam <String>] [-noteSubject <String>]
 [-noteBody <String>] [-timeSpent <Int32>] [<CommonParameters>]

DESCRIPTION

Assigns a task to a user or team in Ivanti ITSM. If a user is specified, their team will be automatically determined. An optional note can be added documenting the assignment.

EXAMPLES

EXAMPLE 1

Assign-IvantiTask -taskNumber 12345 -owner 'jdoe'

Assigns task 12345 to user jdoe and their team.

EXAMPLE 2

Assign-IvantiTask -taskNumber 12345 -ownerTeam 'IT Support' -noteSubject 'Task assigned' -noteBody 'Assigned to IT Support team'

Assigns task 12345 to IT Support team with a note.

PARAMETERS

-taskNumber

The task number to assign.

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 assign (alternative to taskNumber).

Type: String
Parameter Sets: recID
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-owner

Optional Login ID of the user to assign the task to.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ownerTeam

Team to assign the task to (required if owner not provided).

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-noteSubject

Optional subject for the assignment note.

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 assignment note.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-timeSpent

Time spent on assignment (default: 0).

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 0
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

https://help.ivanti.com/ht/help/en_US/ISM/2022/admin/Content/Configure/API/Update-a-Business-Object.htm