Public/Set-SnipeitAccessory.ps1
|
<# .SYNOPSIS Updates accessory on Snipe-It system .DESCRIPTION Updates accessory on Snipe-It system .PARAMETER name ID number of Accessory or array of IDs on Snipe-It system .PARAMETER notes Notes about the accessory .PARAMETER qty Quantity of the accessory you have .PARAMETER min_amt Minimum amount of the accessory, before alert is triggered .PARAMETER category_id ID number of the category the accessory belongs to .PARAMETER company_id ID Number of the company the accessory is assigned to .PARAMETER manufacturer_id ID number of the manufacturer for this accessory. .PARAMETER model_number Model number for this accessory .PARAMETER order_number Order number for this accessory. .PARAMETER purchase_cost Cost of item being purchased. .PARAMETER purchase_date Date accessory was purchased .PARAMETER supplier_id ID number of the supplier for this accessory .PARAMETER location_id ID number of the location the accessory is assigned to .PARAMETER image Image file name and path for item .PARAMETER image_delete Remove current image .PARAMETER RequestType Http request type to send Snipe IT system. Defaults to Patch you could use Put if needed. .PARAMETER url Deprecated parameter, please use Connect-SnipeitPS instead. URL of Snipeit system. .PARAMETER apiKey Deprecated parameter, please use Connect-SnipeitPS instead. Users API Key for Snipeit. .EXAMPLE Set-SnipeitAccessory -id 1 -qty 3 #> function Set-SnipeitAccessory() { [CmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = "Low" )] Param( [parameter(mandatory = $true,ValueFromPipelineByPropertyName)] [int[]]$id, [ValidateLength(3, 255)] [string]$name, [int]$qty, [ValidateRange(1, [int]::MaxValue)] [int]$category_id, [Nullable[System.Int32]]$company_id, [Nullable[System.Int32]]$manufacturer_id, [string]$model_number, [string]$order_number, [float]$purchase_cost, [datetime]$purchase_date, [Nullable[System.Int32]]$min_amt, [Nullable[System.Int32]]$supplier_id, [Nullable[System.Int32]]$location_id, [ValidateScript({Test-Path $_})] [string]$image, [switch]$image_delete=$false, [ValidateSet("Put","Patch")] [string]$RequestType = "Patch", [parameter(mandatory = $false)] [string]$url, [parameter(mandatory = $false)] [string]$apiKey ) begin { Test-SnipeitAlias -invocationName $MyInvocation.InvocationName -commandName $MyInvocation.MyCommand.Name $Values = . Get-ParameterValue -Parameters $MyInvocation.MyCommand.Parameters -BoundParameters $PSBoundParameters if ($Values['purchase_date']) { $Values['purchase_date'] = $Values['purchase_date'].ToString("yyyy-MM-dd") } } process { foreach($accessory_id in $id) { $Parameters = @{ Api = "/api/v1/accessories/$accessory_id" Method = $RequestType Body = $Values } if ($PSBoundParameters.ContainsKey('apiKey') -and '' -ne [string]$apiKey) { Write-Warning "-apiKey parameter is deprecated, please use Connect-SnipeitPS instead." Set-SnipeitPSLegacyApiKey -apiKey $apikey } if ($PSBoundParameters.ContainsKey('url') -and '' -ne [string]$url) { Write-Warning "-url parameter is deprecated, please use Connect-SnipeitPS instead." Set-SnipeitPSLegacyUrl -url $url } if ($PSCmdlet.ShouldProcess("ShouldProcess?")) { $result = Invoke-SnipeitMethod @Parameters } $result } } end { # reset legacy sessions if ($PSBoundParameters.ContainsKey('url') -and '' -ne [string]$url -or $PSBoundParameters.ContainsKey('apiKey') -and '' -ne [string]$apiKey) { Reset-SnipeitPSLegacyApi } } } |