New-HeatIncident
SYNOPSIS
Create a new HEAT incident.
SYNTAX
IncidentOwnerTeamGetsTask (Default)
New-HeatIncident -SamAccountName <String> -Summary <String> -service <String> -Category <String>
-Symptom <String> [-IncidentOwnerTeam <String>] [-IncidentOwner <String>] [-Subcategory <String>]
[-Urgency <String>] [-Impact <String>] [-Source <String>] [-LinkedCI <String[]>] [-Security] [-PassThru]
[<CommonParameters>]
IncidentOwnerGetsTask
New-HeatIncident -SamAccountName <String> -Summary <String> -service <String> -Category <String>
-Symptom <String> [-IncidentOwnerTeam <String>] [-IncidentOwner <String>] [-Subcategory <String>]
[-Urgency <String>] [-Impact <String>] [-Source <String>] [-LinkedCI <String[]>] [-AssignTaskToOwner]
[-Security] [-PassThru] [<CommonParameters>]
TaskOwnerGetsTask
New-HeatIncident -SamAccountName <String> -Summary <String> -service <String> -Category <String>
-Symptom <String> [-IncidentOwnerTeam <String>] [-IncidentOwner <String>] [-Subcategory <String>]
[-Urgency <String>] [-Impact <String>] [-Source <String>] [-LinkedCI <String[]>] [-TaskOwnerteam <String>]
-TaskOwner <String> [-Security] [-PassThru] [<CommonParameters>]
TaskOwnerTeamGetsTask
New-HeatIncident -SamAccountName <String> -Summary <String> -service <String> -Category <String>
-Symptom <String> [-IncidentOwnerTeam <String>] [-IncidentOwner <String>] [-Subcategory <String>]
[-Urgency <String>] [-Impact <String>] [-Source <String>] [-LinkedCI <String[]>] -TaskOwnerteam <String>
[-Security] [-PassThru] [<CommonParameters>]
DESCRIPTION
Add an incident to HEAT, optionally adding a task and assigning it to the correct team or owner.
EXAMPLES
Example 1
{{ Add example description here }}
PARAMETERS
-SamAccountName
Accountname of the task owner
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Summary
Incident summary (title).
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-service
Service (this should be one of the available services in HEAT).
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Category
Category (this should be one of the available categories for the given service in HEAT).
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Symptom
Incident symptom (= body)
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncidentOwnerTeam
Owner Team for the incident (either this or IncidentOwner must be specified)
Type: String
Parameter Sets: (All)
Aliases: OwnerTeam
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IncidentOwner
Owner of the incident. If this is specified, the ownerteam is automatically detected.
Type: String
Parameter Sets: (All)
Aliases: Owner
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Subcategory
Optional subcategory.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Urgency
Incident urgency
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Medium
Accept pipeline input: False
Accept wildcard characters: False
-Impact
Incident impact
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Medium
Accept pipeline input: False
Accept wildcard characters: False
-Source
Source of the incident
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Network Monitor
Accept pipeline input: False
Accept wildcard characters: False
-LinkedCI
Array of CI names. When specified, these are automatically linked to the CI.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AssignTaskToOwner
Create a task and assign it to the Incident owner
Type: SwitchParameter
Parameter Sets: IncidentOwnerGetsTask
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-TaskOwnerteam
When specified, a task is created and assigned to this team instead of the incident's team.
Type: String
Parameter Sets: TaskOwnerGetsTask
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: String
Parameter Sets: TaskOwnerTeamGetsTask
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskOwner
When specified, a task is created and assigned to this owner instead of the incident's owner.
Type: String
Parameter Sets: TaskOwnerGetsTask
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Security
When specified, this is created as a security incident.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returns the API response to the caller for further processing (otherwise return $null on success or throws an error on failure)
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
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.