Skip to content

Add-IvantiLinkedCI

SYNOPSIS

Links a configuration item (CI) to an incident, service request, or change in Ivanti ITSM.

SYNTAX

incidentNumber (Default)

Add-IvantiLinkedCI -incidentNumber <Int32> -CIName <String> [<CommonParameters>]

serviceReqNumber

Add-IvantiLinkedCI -serviceReqNumber <Int32> -CIName <String> [<CommonParameters>]

changeNumber

Add-IvantiLinkedCI -changeNumber <Int32> -CIName <String> [<CommonParameters>]

taskNumber

Add-IvantiLinkedCI -taskNumber <Int32> -CIName <String> [<CommonParameters>]

RecID

Add-IvantiLinkedCI -recID <String> -objectType <String> -CIName <String> [<CommonParameters>]

DESCRIPTION

Links a configuration item (CI) to an incident, service request, or change in Ivanti ITSM by specifying the relevant parameters such as service request number, incident number, change number, or record ID.

EXAMPLES

EXAMPLE 1

Add-LinkedCI -serviceReqNumber 12345 -CIName 'CI123'

Links the configuration item 'CI123' to the service request number 12345.

EXAMPLE 2

Add-LinkedCI -incidentNumber 67890 -CIName 'CI456'

Links the configuration item 'CI456' to the incident number 67890.

EXAMPLE 3

Add-LinkedCI -changeNumber 11223 -CIName 'CI789'

Links the configuration item 'CI789' to the change number 11223.

EXAMPLE 4

Add-LinkedCI -recID 'abc123' -objectType 'incident' -CIName 'CI101'

Links the configuration item 'CI101' to the incident with record ID 'abc123'.

PARAMETERS

-serviceReqNumber

The service request number to which the CI is related.

Type: Int32
Parameter Sets: serviceReqNumber
Aliases:

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

-incidentNumber

The incident number to which the CI is related.

Type: Int32
Parameter Sets: incidentNumber
Aliases:

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

-changeNumber

The change number to which the CI is related.

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 to which the CI is related.

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 parent item to which the CI is related.

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 parent object (incident, servicereq, change).

Type: String
Parameter Sets: RecID
Aliases:

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

-CIName

The name of the configuration item to be linked.

Type: String
Parameter Sets: (All)
Aliases: CI

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.

INPUTS

OUTPUTS

NOTES

https://help.ivanti.com/ht/help/en_US/ISM/2022/admin/Content/Configure/API/Create-a-Business-Object.htm