New-IvantiTask
SYNOPSIS
Creates a new task in Ivanti ITSM.
SYNTAX
ParentRecID (Default)
New-IvantiTask -parentRecID <String> -ObjectType <String> -service <String> -subject <String> -details <String>
-ownerTeam <String> [-owner <String>] [-customBodyFields <Hashtable>] [-closeTask] [-timeSpent <Int32>]
[<CommonParameters>]
serviceReqNumber
New-IvantiTask -serviceReqNumber <Int32> -service <String> -subject <String> -details <String>
-ownerTeam <String> [-owner <String>] [-customBodyFields <Hashtable>] [-closeTask] [-timeSpent <Int32>]
[<CommonParameters>]
incidentNumber
New-IvantiTask -incidentNumber <Int32> -service <String> -subject <String> -details <String>
-ownerTeam <String> [-owner <String>] [-customBodyFields <Hashtable>] [-closeTask] [-timeSpent <Int32>]
[<CommonParameters>]
changeNumber
New-IvantiTask -changeNumber <Int32> -service <String> -subject <String> -details <String> -ownerTeam <String>
[-owner <String>] [-customBodyFields <Hashtable>] [-closeTask] [-timeSpent <Int32>] [<CommonParameters>]
DESCRIPTION
Creates a new task in Ivanti ITSM with the specified details such as service, subject, details, owner team, and other optional parameters. Optionally, it can also close the task immediately after creation if specified.
EXAMPLES
EXAMPLE 1
New-Task -serviceReqNumber 12345 -service 'IT Support' -subject 'Setup new workstation' -details 'Setup a new workstation for the new employee' -ownerTeam 'IT Support'
Creates a new task for service request number 12345 with the specified details.
EXAMPLE 2
New-Task -incidentNumber 67890 -service 'IT Support' -subject 'Resolve login issue' -details 'Resolve the login issue for the user' -ownerTeam 'IT Support' -closeTask
Creates a new task for incident number 67890 with the specified details and closes it immediately.
PARAMETERS
-serviceReqNumber
The service request number to which the task is related.
Type: Int32
Parameter Sets: serviceReqNumber
Aliases: SR
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-incidentNumber
The incident number to which the task is related.
Type: Int32
Parameter Sets: incidentNumber
Aliases: Incident
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-changeNumber
The change number to which the task is related.
Type: Int32
Parameter Sets: changeNumber
Aliases: Change
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-parentRecID
The record ID of the parent item to which the task is related.
Type: String
Parameter Sets: ParentRecID
Aliases: RecID
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ObjectType
{{ Fill ObjectType Description }}
Type: String
Parameter Sets: ParentRecID
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-service
The service associated with the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-subject
The subject of the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-details
The details of the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ownerTeam
The team that owns the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-owner
The owner of the task.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-customBodyFields
A hashtable of custom fields to be added to the task.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-closeTask
Switch to indicate if the task should be closed immediately after creation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-timeSpent
The time spent on the task in minutes. Default is 1 minute.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 1
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.