SnipeitPS/SnipeitPS/Public/New-AssetMaintenance.ps1
2019-04-26 16:30:00 +01:00

101 lines
2.5 KiB
PowerShell

<#
.SYNOPSIS
Add a new Asset to Snipe-it asset system
.DESCRIPTION
Long description
.PARAMETER Tag
Asset Tag for the Asset
.PARAMETER Name
Name of the Asset
.PARAMETER Status_id
Status ID of the asset, this can be got using Get-Status
.PARAMETER Model_id
Model ID of the asset, this can be got using Get-Model
.PARAMETER url
URL of Snipeit system, can be set using Set-Info command
.PARAMETER apiKey
Users API Key for Snipeit, can be set using Set-Info command
.PARAMETER customfields
Hastable of custom fields and extra fields that need passing through to Snipeit
.EXAMPLE
New-Asset -status_id 1 -model_id 1 -name "Machine1"
.EXAMPLE
New-Asset -status_id 1 -model_id 1 -name "Machine1" -CustomValues = @{ "_snipeit_os_5 = "Windows 10 Pro" }
#>
function New-AssetMaintenance() {
[CmdletBinding(
SupportsShouldProcess = $true,
ConfirmImpact = "Low"
)]
Param(
[parameter(mandatory = $true)]
[int]$asset_id,
[parameter(mandatory = $true)]
[int]$supplier_id,
[parameter(mandatory = $true)]
[string]$asset_maintenance_type,
[parameter(mandatory = $true)]
[string]$title,
[parameter(mandatory = $true)]
[datetime]$startDate,
[parameter(mandatory = $false)]
[datetime]$completionDate,
[switch]$is_warranty=$false,
[decimal]$cost,
[string]$notes,
[parameter(mandatory = $true)]
[string]$url,
[parameter(mandatory = $true)]
[string]$apiKey
)
$Values = @{
"asset_id" = $asset_id
"supplier_id" = $supplier_id
"asset_maintenance_type" = $asset_maintenance_type
"title" = $title
"start_date" = $startDate.ToString("yyyy-MM-dd")
"is_warranty" = [Bool]::Parse($is_warranty)
}
if ($PSBoundParameters.ContainsKey('completionDate')) { $Values.Add("completion_date", $completionDate.ToString("yyyy-MM-dd")) }
if ($PSBoundParameters.ContainsKey('cost')) { $Values.Add("cost", $cost) }
if ($PSBoundParameters.ContainsKey('notes')) { $Values.Add("notes", $notes) }
$Body = $Values | ConvertTo-Json;
$Parameters = @{
Uri = "$url/api/v1/maintenances"
Method = 'Post'
Body = $Body
Token = $apiKey
}
If ($PSCmdlet.ShouldProcess("ShouldProcess?")) {
$result = Invoke-SnipeitMethod @Parameters
}
$result
}