mirror of
https://github.com/snazy2000/SnipeitPS.git
synced 2025-12-13 18:02:30 +00:00
172 lines
3.8 KiB
PowerShell
172 lines
3.8 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Updates a licence
|
|
|
|
.DESCRIPTION
|
|
Updates licence on Snipe-It system
|
|
|
|
.PARAMETER id
|
|
ID number of license or array of license IDs
|
|
|
|
.PARAMETER name
|
|
Name of license
|
|
|
|
.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 RequestType
|
|
Http request type to send Snipe IT system. Defaults to Patch you could use Put if needed.
|
|
|
|
.PARAMETER url
|
|
URL of Snipeit system, can be set using Set-SnipeitInfo command
|
|
|
|
.PARAMETER apiKey
|
|
Users API Key for Snipeit, can be set using Set-SnipeitInfo command
|
|
|
|
.EXAMPLE
|
|
Set-SnipeitLicence -name "License" -seats 3 -company_id 1
|
|
|
|
#>
|
|
|
|
function Set-SnipeitLicense() {
|
|
[CmdletBinding(
|
|
SupportsShouldProcess = $true,
|
|
ConfirmImpact = "Low"
|
|
)]
|
|
|
|
Param(
|
|
[parameter(mandatory = $true, ValueFromPipelineByPropertyName)]
|
|
[int[]]$id,
|
|
|
|
[ValidateLength(3, 255)]
|
|
[string]$name,
|
|
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$seats,
|
|
|
|
[ValidateRange(1, [int]::MaxValue)]
|
|
[int]$category_id,
|
|
|
|
|
|
[Nullable[System.Int32]]$company_id,
|
|
|
|
[datetime]$expiration_date,
|
|
|
|
[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,
|
|
|
|
[Nullable[System.Int32]]$supplier_id,
|
|
|
|
[datetime]$termination_date,
|
|
|
|
[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['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")
|
|
}
|
|
|
|
}
|
|
|
|
process {
|
|
foreach($license_id in $id){
|
|
$Parameters = @{
|
|
Uri = "$url/api/v1/licenses/$license_id"
|
|
Method = $RequestType
|
|
Body = $Values
|
|
Token = $apiKey
|
|
}
|
|
|
|
If ($PSCmdlet.ShouldProcess("ShouldProcess?")) {
|
|
$result = Invoke-SnipeitMethod @Parameters
|
|
}
|
|
|
|
$result
|
|
}
|
|
}
|
|
}
|