New-IvantiServiceRequest
SYNOPSIS
Creates a new service request in Ivanti ITSM.
SYNTAX
customerRecID (Default)
New-IvantiServiceRequest -serviceRequestTemplate <String> -customerRecID <String> [-createdBy <String>]
-service <String> [-status <String>] -source <String> -ownerTeam <String> [-owner <String>]
[-urgency <String>] [-customBodyFields <Hashtable>] -serviceReqParams <Hashtable> [<CommonParameters>]
customer
New-IvantiServiceRequest -serviceRequestTemplate <String> -customer <String> [-createdBy <String>]
-service <String> [-status <String>] -source <String> -ownerTeam <String> [-owner <String>]
[-urgency <String>] [-customBodyFields <Hashtable>] -serviceReqParams <Hashtable> [<CommonParameters>]
DESCRIPTION
Creates a new service request in Ivanti ITSM using a specified service request template and parameters. The function sets the initial status to 'Draft' and updates it to the specified status after creation.
EXAMPLES
EXAMPLE 1
New-ServiceRequest -serviceRequestTemplate 'Standard Request' -customer 'jdoe' -service 'IT Support' -source 'Email' -ownerTeam 'IT Support' -serviceReqParams @{ 'Param1' = 'Value1'; 'Param2' = 'Value2' }
Creates a new service request for customer 'jdoe' using the 'Standard Request' template with the specified details.
EXAMPLE 2
New-ServiceRequest -serviceRequestTemplate 'Standard Request' -customerRecID 'abc123' -service 'IT Support' -source 'Phone' -ownerTeam 'IT Support' -serviceReqParams @{ 'Param1' = 'Value1'; 'Param2' = 'Value2' }
Creates a new service request for the customer with record ID 'abc123' using the 'Standard Request' template with the specified details.
PARAMETERS
-serviceRequestTemplate
The name of the service request template to be used.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-customer
The login ID of the customer for whom the service request 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 service request is being created.
Type: String
Parameter Sets: customerRecID
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-createdBy
The user who created the service request.
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 service request.
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 service request. Default is 'Submitted'.
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 service request.
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 service request.
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 service request.
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 service request. Default is 'Medium'.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: Medium
Accept pipeline input: False
Accept wildcard characters: False
-customBodyFields
A hashtable of custom fields to be added to the service request.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-serviceReqParams
A hashtable of parameters to be set in the service request.
Type: Hashtable
Parameter Sets: (All)
Aliases: serviceRequestParams
Required: True
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.