Get-IvantiServiceRequest
SYNOPSIS
Retrieves service requests from Ivanti ITSM.
SYNTAX
RecID (Default)
Get-IvantiServiceRequest -recID <String> [-status <String>] [-customFields <String>] [-top <Int32>]
[-allFields] [-withParams] [<CommonParameters>]
serviceRequestNumber
Get-IvantiServiceRequest -serviceRequestNumber <Int32> [-status <String>] [-customFields <String>]
[-top <Int32>] [-allFields] [-withParams] [<CommonParameters>]
Subject
Get-IvantiServiceRequest -subject <String> [-status <String>] [-customFields <String>] [-top <Int32>]
[-allFields] [-withParams] [<CommonParameters>]
Filter
Get-IvantiServiceRequest -filter <String> [-status <String>] [-customFields <String>] [-top <Int32>]
[-allFields] [-withParams] [<CommonParameters>]
Search
Get-IvantiServiceRequest -search <String> [-status <String>] [-customFields <String>] [-top <Int32>]
[-allFields] [-withParams] [<CommonParameters>]
DESCRIPTION
Retrieves service requests from Ivanti ITSM based on specified parameters such as service request number, record ID, subject, filter, or search criteria. Allows selecting specific fields, filtering by status, and including associated parameters.
EXAMPLES
EXAMPLE 1
Retrieves the service request with the number 12345.
EXAMPLE 2
Retrieves the service request with the record ID 'abc123'.
EXAMPLE 3
Retrieves active service requests with the specified filter.
EXAMPLE 4
Retrieves the service request with the search criteria 'Request123' and returns all fields.
PARAMETERS
-serviceRequestNumber
The service request number to be retrieved.
Type: Int32
Parameter Sets: serviceRequestNumber
Aliases: SR
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-recID
The record ID of the service request to be retrieved.
Type: String
Parameter Sets: RecID
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-subject
The subject of the service request to be retrieved.
Type: String
Parameter Sets: Subject
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter
The filter criteria to find the service request to be retrieved.
Type: String
Parameter Sets: Filter
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-search
The search criteria to find the service request to be retrieved.
Type: String
Parameter Sets: Search
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-status
The status of the service request. Valid values are 'Submitted', 'Active', 'Accepted', 'Closed', 'Fulfilled', 'Cancelled', 'Approved', 'Approval Rejected', 'Waiting for Approval', 'Waiting for Customer', 'Waiting for 3rd Party'.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-customFields
A comma-separated list of custom fields to be included in the result.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-top
The maximum number of results to return.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-allFields
Switch to indicate if all fields should be returned.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-withParams
Switch to indicate if associated parameters should be included in the result.
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.