Get-IvantiLinkedCI

SYNOPSIS

Retrieve linked configuration items (CIs) for a specified business object in Ivanti ITSM.

SYNTAX

servicereq (Default)

Get-IvantiLinkedCI [-allFields] [<CommonParameters>]

incidentNumber

Get-IvantiLinkedCI -incidentNumber <Int32> [-allFields] [<CommonParameters>]

serviceReqNumber

Get-IvantiLinkedCI -serviceReqNumber <Int32> [-allFields] [<CommonParameters>]

changeNumber

Get-IvantiLinkedCI -changeNumber <Int32> [-allFields] [<CommonParameters>]

taskNumber

Get-IvantiLinkedCI -taskNumber <Int32> [-allFields] [<CommonParameters>]

RecID

Get-IvantiLinkedCI -RecID <String> -objectType <String> [-allFields] [<CommonParameters>]

DESCRIPTION

The `Get-LinkedCI` function allows you to retrieve linked configuration items (CIs) for a specified business object in Ivanti ITSM. You can specify the business object using various parameters such as incident number, service request number, change number, task number, or record ID. The function also allows you to specify custom fields to include in the result and whether to include all fields.

EXAMPLES

EXAMPLE 1

Get-LinkedCI -incidentNumber 12345

Retrieves linked CIs for the incident with the incident number 12345.

EXAMPLE 2

Get-LinkedCI -serviceReqNumber 67890

Retrieves linked CIs for the service request with the service request number 67890.

EXAMPLE 3

Get-LinkedCI -changeNumber 54321

Retrieves linked CIs for the change with the change number 54321.

EXAMPLE 4

Get-LinkedCI -taskNumber 98765

Retrieves linked CIs for the task with the task number 98765.

EXAMPLE 5

Get-LinkedCI -RecID 'abc123' -objectType 'incident'

Retrieves linked CIs for the business object with the record ID 'abc123' and type 'incident'.

PARAMETERS

-incidentNumber

The incident number of the business object for which to retrieve linked CIs. This parameter is mandatory when using the 'incidentNumber' parameter set.

Type: Int32
Parameter Sets: incidentNumber
Aliases:

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

-serviceReqNumber

The service request number of the business object for which to retrieve linked CIs. This parameter is mandatory when using the 'serviceReqNumber' parameter set.

Type: Int32
Parameter Sets: serviceReqNumber
Aliases: servicerequestNumber

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

-changeNumber

The change number of the business object for which to retrieve linked CIs. This parameter is mandatory when using the 'changeNumber' parameter set.

Type: Int32
Parameter Sets: changeNumber
Aliases:

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

-taskNumber

The task number of the business object for which to retrieve linked CIs. This parameter is mandatory when using the 'taskNumber' parameter set.

Type: Int32
Parameter Sets: taskNumber
Aliases:

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

-RecID

The record ID of the business object for which to retrieve linked CIs. 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

-objectType

The type of the business object (incident, servicereq, or change). 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

-allFields

A switch to include all fields in the retrieved linked CIs.

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

This function is useful for retrieving linked configuration items (CIs) for various business objects in Ivanti ITSM.

https://docs.microsoft.com/en-us/powershell/scripting/overview