New-ITGlueRelatedItem

SYNOPSIS

Creates one or more related items

SYNTAX

New-ITGlueRelatedItem [-ResourceType] <String> [-ResourceID] <Int64> [-Data] <Object> [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

The New-ITGlueRelatedItem cmdlet creates one or more related items

The create action is directional from source item to destination item(s)

The source item is the item that matches the resource_type and resource_id in the URL

The destination item(s) are the items that match the destination_type and destination_id in the JSON object

Examples of JSON objects can be found under ITGlues developer documentation https://api.itglue.com/developer

EXAMPLES

EXAMPLE 1

New-ITGlueRelatedItem -ResourceType passwords -ResourceID 8675309 -Data $JsonObject

Creates a new related password to the defined resource id with the structured JSON object

PARAMETERS

-ResourceType

The resource type of the parent resource

Allowed values: ‘checklists’, ‘checklist_templates’, ‘configurations’, ‘contacts’, ‘documents’, ‘domains’, ‘folders’, ‘locations’, ‘passwords’, ‘ssl_certificates’, ‘flexible_assets’, ‘tickets’

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

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

-ResourceID

The resource id of the parent resource

Type: Int64
Parameter Sets: (All)
Aliases: resource_id

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

-Data

JSON object or array depending on bulk changes or not

Type: Object
Parameter Sets: (All)
Aliases:

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

N/A

https://celerium.github.io/ITGlue-PowerShellWrapper/site/RelatedItems/New-ITGlueRelatedItem.html

https://api.itglue.com/developer/#related-items-create