Get-IvantiProblem
SYNOPSIS
Retrieve a problem record from Ivanti ITSM.
SYNTAX
RecID (Default)
Get-IvantiProblem -recID <String> [-customFields <String>] [-top <Int32>] [-status <String>] [-allFields]
[<CommonParameters>]
problemNumber
Get-IvantiProblem -problemNumber <Int32> [-customFields <String>] [-top <Int32>] [-status <String>]
[-allFields] [<CommonParameters>]
Search
Get-IvantiProblem [-filter <String>] -search <String> [-customFields <String>] [-top <Int32>]
[-status <String>] [-allFields] [<CommonParameters>]
Filter
Get-IvantiProblem -filter <String> [-customFields <String>] [-top <Int32>] [-status <String>] [-allFields]
[<CommonParameters>]
Subject
Get-IvantiProblem -subject <String> [-customFields <String>] [-top <Int32>] [-status <String>] [-allFields]
[<CommonParameters>]
DESCRIPTION
This function retrieves problem records from Ivanti ITSM. You can specify the problem using various parameters such as problem number, record ID, filter, search, or subject. The function also allows you to specify custom fields to include in the result and the maximum number of problems to retrieve.
EXAMPLES
EXAMPLE 1
Retrieves the problem with the problem number 12345.
EXAMPLE 2
Retrieves the problem with the record ID 'abc123'.
EXAMPLE 3
Retrieves problems created by 'John Doe'.
EXAMPLE 4
Retrieves problems containing the search string 'urgent'.
EXAMPLE 5
Retrieves problems with the subject 'Network Issue'.
PARAMETERS
-problemNumber
The problem number of the problem to retrieve. This parameter is mandatory when using the 'problemNumber' parameter set.
Type: Int32
Parameter Sets: problemNumber
Aliases: Problem
Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-recID
The record ID of the problem to retrieve. This parameter is mandatory when using the 'RecID' parameter set.
Type: String
Parameter Sets: RecID
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-filter
A filter to apply when retrieving the problem. This parameter is mandatory when using the 'Filter' parameter set.
Type: String
Parameter Sets: Search
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: String
Parameter Sets: Filter
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-search
A search string to apply when retrieving the problem. This parameter is mandatory when using the 'Search' parameter set.
Type: String
Parameter Sets: Search
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-subject
The subject of the problem to retrieve. This parameter is mandatory when using the 'Subject' parameter set.
Type: String
Parameter Sets: Subject
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-customFields
Custom fields to include in the retrieved problem.
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 problems to retrieve.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-status
The status of the problem to retrieve. Valid values are 'Logged', 'Active', 'Resolved', 'Closed', 'Waiting for Resolution', 'Waiting for Customer', and '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
-allFields
A switch to include all fields in the retrieved problem.
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.