New-IvantiIncident
SYNOPSIS
Creates a new incident in Ivanti ITSM.
SYNTAX
customerRecID (Default)
New-IvantiIncident -customerRecID <String> [-reportedBy <String>] -service <String> [-status <String>]
-source <String> -subject <String> -symptom <String> -ownerTeam <String> [-owner <String>] [-impact <String>]
[-urgency <String>] [-customBodyFields <Hashtable>] [-CIName <String>] [-closeIncident] [-timeSpent <Int32>]
[-resolution <String>] [<CommonParameters>]
customer
New-IvantiIncident -customer <String> [-reportedBy <String>] -service <String> [-status <String>]
-source <String> -subject <String> -symptom <String> -ownerTeam <String> [-owner <String>] [-impact <String>]
[-urgency <String>] [-customBodyFields <Hashtable>] [-CIName <String>] [-closeIncident] [-timeSpent <Int32>]
[-resolution <String>] [<CommonParameters>]
DESCRIPTION
Creates a new incident in Ivanti ITSM with the specified details such as customer, service, source, status, subject, symptom, owner team, and other optional parameters. Optionally, it can also close the incident immediately after creation if specified.
EXAMPLES
EXAMPLE 1
New-Incident -customer 'jdoe' -service 'IT Support' -source 'Email' -subject 'Cannot access email' -symptom 'Login failure' -ownerTeam 'IT Support' -status 'Active'
Creates a new incident for customer 'jdoe' with the specified details.
EXAMPLE 2
New-Incident -customerRecID 'abc123' -service 'IT Support' -source 'Phone' -subject 'Computer not starting' -symptom 'Power issue' -ownerTeam 'IT Support' -closeIncident
Creates a new incident with the specified details and closes it immediately.
PARAMETERS
-customer
The customer login ID for whom the incident is being created.
Type: String
Parameter Sets: customer
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-customerRecID
The record ID of the customer for whom the incident is being created.
Type: String
Parameter Sets: customerRecID
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-reportedBy
The user who reported the incident.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-service
The service associated with the incident.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-status
The status of the incident. Default is 'Active'.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Active
Accept pipeline input: False
Accept wildcard characters: False
-source
The source of the incident.
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 incident.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-symptom
The symptom description of the incident.
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 incident.
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 incident.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-impact
The impact level of the incident.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-urgency
The urgency level of the incident.
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 incident.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CIName
The configuration item name to be linked to the incident.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-closeIncident
Switch to indicate if the incident 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 incident 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
-resolution
The resolution description for the incident. Default is 'Closed by automation'.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Closed by automation
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.