mirror of
https://github.com/snazy2000/SnipeitPS.git
synced 2025-12-13 01:42:29 +00:00
149 lines
3.4 KiB
PowerShell
149 lines
3.4 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Creates new accessory on Snipe-It system
|
|
|
|
.DESCRIPTION
|
|
Creates new accessory on Snipe-It system
|
|
|
|
.PARAMETER name
|
|
Accessory name
|
|
|
|
.PARAMETER notes
|
|
Notes about the accessory
|
|
|
|
.PARAMETER qty
|
|
Quantity of the accessory you have
|
|
|
|
.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 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 min_amt
|
|
Min quantity of the accessory before alert is triggered
|
|
|
|
.PARAMETER image
|
|
Accessory image fileame and path
|
|
|
|
.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
|
|
New-SnipeitAccessory -name "Accessory" -qty 3 -category_id 1
|
|
|
|
#>
|
|
function New-SnipeitAccessory() {
|
|
[CmdletBinding(
|
|
SupportsShouldProcess = $true,
|
|
ConfirmImpact = "Low"
|
|
)]
|
|
|
|
Param(
|
|
[parameter(mandatory = $true)]
|
|
[ValidateLength(3, 255)]
|
|
[string]$name,
|
|
|
|
[parameter(mandatory = $true)]
|
|
[int]$qty,
|
|
|
|
[parameter(mandatory = $true)]
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$category_id,
|
|
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$company_id,
|
|
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$manufacturer_id,
|
|
|
|
[string]$order_number,
|
|
|
|
[string]$model_number,
|
|
|
|
[float]$purchase_cost,
|
|
|
|
[datetime]$purchase_date,
|
|
|
|
[int]$min_amt,
|
|
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$supplier_id,
|
|
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$location_id,
|
|
|
|
[ValidateScript({Test-Path $_})]
|
|
[string]$image,
|
|
|
|
[parameter(mandatory = $false)]
|
|
[string]$url,
|
|
|
|
[parameter(mandatory = $false)]
|
|
[string]$apiKey
|
|
)
|
|
|
|
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")
|
|
}
|
|
|
|
$Parameters = @{
|
|
Api = "/api/v1/accessories"
|
|
Method = 'POST'
|
|
Body = $Values
|
|
}
|
|
|
|
if ($PSBoundParameters.ContainsKey('apiKey')) {
|
|
Write-Warning "-apiKey parameter is deprecated, please use Connect-SnipeitPS instead."
|
|
Set-SnipeitPSSessionApiKey -apiKey $apikey
|
|
}
|
|
|
|
if ($PSBoundParameters.ContainsKey('url')) {
|
|
Write-Warning "-url parameter is deprecated, please use Connect-SnipeitPS instead."
|
|
Set-SnipeitPSSessionApiKey -url $url
|
|
}
|
|
|
|
if ($PSCmdlet.ShouldProcess("ShouldProcess?")) {
|
|
$result = Invoke-SnipeitMethod @Parameters
|
|
}
|
|
|
|
$result
|
|
}
|
|
|