Get-IvantiBusinessObjectURL
SYNOPSIS
Generate a URL for an Ivanti ITSM business object.
SYNTAX
Get-IvantiBusinessObjectURL [-businessObject] <String> [-ObjectNumber] <UInt64> [-ToClipboard]
[-ToClipboardAsHtml] -ivantiURL <String> [<CommonParameters>]
DESCRIPTION
The `Get-BusinessObjectURL` function generates a URL for a specified Ivanti ITSM business object (e.g., Change, Incident, Problem, ServiceRequest, Task) and optionally copies it to the clipboard in plain text or HTML format.
EXAMPLES
EXAMPLE 1
Get-BusinessObjectURL -businessObject 'Incident' -ObjectNumber 12345 -ivantiURL 'https://ivanti.example.local/HEAT'
Generates a URL for the specified Incident and outputs it as plain text.
EXAMPLE 2
Get-BusinessObjectURL -businessObject 'Change' -ObjectNumber 67890 -ivantiURL 'https://ivanti.example.local/HEAT' -ToClipboard
Generates a URL for the specified Change and copies it to the clipboard in plain text format.
EXAMPLE 3
Get-BusinessObjectURL -businessObject 'Task' -ObjectNumber 54321 -ivantiURL 'https://ivanti.example.local/HEAT' -ToClipboardAsHtml
Generates a URL for the specified Task and copies it to the clipboard as an HTML link.
PARAMETERS
-businessObject
The type of business object for which the URL is generated. Accepted values: Change, Incident, Problem, ServiceRequest, Task.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-ObjectNumber
The unique identifier (number) of the business object.
Type: UInt64
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-ToClipboard
Copies the generated URL to the clipboard in plain text format.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ToClipboardAsHtml
Copies the generated URL to the clipboard as an HTML link.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ivantiURL
The base URL of the Ivanti ITSM instance. Example: https://ivanti.example.local/HEAT
Type: String
Parameter Sets: (All)
Aliases:
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.