Public/New-License.ps1
|
<# .SYNOPSIS Creates a licence .DESCRIPTION Creates a new licence on Snipe-It system .PARAMETER name Name of license being created .PARAMETER seats Number of license seats owned. .PARAMETER company_id Id number of company license belongs to .PARAMETER expiration_date Date of license expiration .PARAMETER expiration_date Date of license expiration .PARAMETER license_email Email address associated with license .PARAMETER license_name Name of license contact person .PARAMETER serial Serialnumber of license .PARAMETER maintained Maintained status of license .PARAMETER manufacturer_id ID number of manufacturer of license. .PARAMETER notes License Notes .PARAMETER order_number Order number of license purchase .PARAMETER purchase_cost Cost of license .PARAMETER purchase_date Date of license purchase .PARAMETER reassignable Is license reassignable? .PARAMETER supplier_id ID number of license supplier .PARAMETER termination_date Termination date for license. .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 .EXAMPLE New-Licence -name "License" -seats 3 -company_id 1 #> function New-License() { [CmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = "Low" )] Param( [parameter(mandatory = $true)] [ValidateLength(3, 255)] [string]$name, [parameter(mandatory = $true)] [int]$seats, [ValidateRange(1, [int]::MaxValue)] [int]$category_id, [ValidateRange(1, [int]::MaxValue)] [int]$company_id, [datetime]$expiration_date, [ValidateLength(1, 120)] [mailaddress]$license_email, [ValidateLength(1, 100)] [string]$license_name, [bool]$maintained, [ValidateRange(1, [int]::MaxValue)] [int]$manufacturer_id, [string]$notes, [string]$order_number, [float]$purchase_cost, [datetime]$purchase_date, [bool]$reassignable, [string]$serial, [ValidateRange(1, [int]::MaxValue)] [int]$supplier_id, [datetime]$termination_date, [parameter(mandatory = $true)] [string]$url, [parameter(mandatory = $true)] [string]$apiKey ) $Values = . Get-ParameterValue $MyInvocation.MyCommand.Parameters if ($values['expiration_date']) { $values['expiration_date'] = $values['expiration_date'].ToString("yyyy-MM-dd") } if ($values['purchase_date']) { $values['purchase_date'] = $values['purchase_date'].ToString("yyyy-MM-dd") } if ($values['termination_date']) { $values['termination_date'] = $values['termination_date'].ToString("yyyy-MM-dd") } $Body = $Values | ConvertTo-Json; $Parameters = @{ Uri = "$url/api/v1/licenses" Method = 'POST' Body = $Body Token = $apiKey } If ($PSCmdlet.ShouldProcess("ShouldProcess?")) { $result = Invoke-SnipeitMethod @Parameters } $result } |