Skip to content

Get-IvantiServiceRequestSubscription

SYNOPSIS

Retrieves service request subscriptions from Ivanti ITSM.

SYNTAX

serviceRequestTemplate

Get-IvantiServiceRequestSubscription -serviceRequestTemplate <String> [-orgUnit <String>] [-allSubscriptions]
 [-customFields <String>] [-top <Int32>] [-allFields] [<CommonParameters>]

RecID

Get-IvantiServiceRequestSubscription -recID <String> [-orgUnit <String>] [-customFields <String>]
 [-top <Int32>] [-allFields] [<CommonParameters>]

Filter

Get-IvantiServiceRequestSubscription -filter <String> [-orgUnit <String>] [-customFields <String>]
 [-top <Int32>] [-allFields] [<CommonParameters>]
Get-IvantiServiceRequestSubscription -search <String> [-orgUnit <String>] [-allSubscriptions]
 [-customFields <String>] [-top <Int32>] [-allFields] [<CommonParameters>]

DESCRIPTION

Retrieves service request subscriptions from Ivanti ITSM based on specified parameters such as service request template, record ID, filter, or search criteria. Allows selecting specific fields and filtering by active subscriptions.

EXAMPLES

EXAMPLE 1

Get-ServiceRequestSubscription -serviceRequestTemplate 'Standard Request'

Retrieves the active subscriptions for the 'Standard Request' service request template.

EXAMPLE 2

Get-ServiceRequestSubscription -recID 'abc123'

Retrieves the service request subscription with the record ID 'abc123'.

EXAMPLE 3

Get-ServiceRequestSubscription -filter "OrgUnit eq 'IT'"

Retrieves the service request subscriptions for the 'IT' organizational unit.

EXAMPLE 4

Get-ServiceRequestSubscription -search 'Subscription123' -allFields

Retrieves the service request subscription with the search criteria 'Subscription123' and returns all fields.

PARAMETERS

-serviceRequestTemplate

The name of the service request template to retrieve subscriptions for.

Type: String
Parameter Sets: serviceRequestTemplate
Aliases: SRTemplate

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-recID

The record ID of the service request subscription to be retrieved.

Type: String
Parameter Sets: RecID
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 subscription to be retrieved.

Type: String
Parameter Sets: Filter
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

The search criteria to find the service request subscription to be retrieved.

Type: String
Parameter Sets: Search
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-orgUnit

The organizational unit associated with the service request subscription.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-allSubscriptions

Switch to indicate if all subscriptions should be retrieved, including inactive ones.

Type: SwitchParameter
Parameter Sets: serviceRequestTemplate, Search
Aliases:

Required: False
Position: Named
Default value: False
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

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.

INPUTS

OUTPUTS

NOTES