Update-IvantiCI

SYNOPSIS

Updates a configuration item (CI) in Ivanti ITSM.

SYNTAX

RecID (Default)

Update-IvantiCI -CIName <String> -recID <String> [-body <Hashtable>] [<CommonParameters>]

CIName

Update-IvantiCI -CIName <String> [-body <Hashtable>] [<CommonParameters>]

serialNumber

Update-IvantiCI -CIName <String> -serialNumber <String> [-body <Hashtable>] [<CommonParameters>]

DESCRIPTION

Updates a configuration item (CI) in Ivanti ITSM with the specified details such as CI name, record ID, filter, or search parameters. The function allows updating various attributes of the CI.

EXAMPLES

EXAMPLE 1

Update-CI -CIName 'CI123' -body @{ 'Status' = 'Active'; 'Owner' = 'JohnDoe' }

Updates the configuration item 'CI123' with the specified details.

EXAMPLE 2

Update-CI -recID 'abc123' -body @{ 'Status' = 'Inactive'; 'Owner' = 'JaneDoe' }

Updates the configuration item with record ID 'abc123' with the specified details.

EXAMPLE 3

Update-CI -filter "Name eq 'CI123'" -status 'Active' -body @{ 'Owner' = 'JohnDoe' }

Updates the configuration item found with the specified filter and status.

EXAMPLE 4

Update-CI -search 'CI123' -body @{ 'Status' = 'Active'; 'Owner' = 'JohnDoe' }

Updates the configuration item found with the specified search criteria.

PARAMETERS

-CIName

The name of the configuration item to be updated.

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

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

-serialNumber

Type: String
Parameter Sets: serialNumber
Aliases:

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

-recID

The record ID of the configuration item to be updated.

Type: String
Parameter Sets: RecID
Aliases:

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

-body

A hashtable of fields to be updated in the configuration item.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
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/Update-a-Business-Object.htm