mirror of
https://github.com/snazy2000/SnipeitPS.git
synced 2025-12-13 18:02:30 +00:00
142 lines
3.6 KiB
PowerShell
142 lines
3.6 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Gets a list of Snipe-it Licenses
|
|
|
|
.PARAMETER search
|
|
A text string to search the Licenses data
|
|
|
|
.PARAMETER id
|
|
A id of specific License
|
|
|
|
.PARAMETER limit
|
|
Specify the number of results you wish to return. Defaults to 50. Defines batch size for -all
|
|
|
|
.PARAMETER offset
|
|
Offset to use
|
|
|
|
.PARAMETER all
|
|
A return all results, works with -offset and other parameters
|
|
|
|
|
|
.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
|
|
Get-SnipeitLicense -search SomeLicense
|
|
|
|
.EXAMPLE
|
|
Get-SnipeitLicense -id 1
|
|
|
|
#>
|
|
|
|
function Get-SnipeitLicense() {
|
|
[CmdletBinding(DefaultParameterSetName = 'Search')]
|
|
Param(
|
|
[parameter(ParameterSetName='Search')]
|
|
[string]$search,
|
|
|
|
[parameter(ParameterSetName='Get with ID')]
|
|
[int]$id,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[string]$name,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int] $company_id,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[string]$product_key,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[string]$order_number,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[string]$purchase_order,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[string]$license_name,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[mailaddress]$license_email,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int]$manufacturer_id,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int]$supplier_id,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int]$depreciation_id,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int]$category_id,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[ValidateSet("asc", "desc")]
|
|
[string]$order = "desc",
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[ValidateSet('created_at','id', 'name', 'purchase_cost', 'expiration_date', 'purchase_order', 'order_number', 'notes', 'purchase_date', 'serial', 'company', 'category', 'license_name', 'license_email', 'free_seats_count', 'seats', 'manufacturer', 'supplier')]
|
|
[string]$sort = "created_at",
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int]$limit = 50,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[int]$offset,
|
|
|
|
[parameter(ParameterSetName='Search')]
|
|
[switch]$all = $false,
|
|
|
|
[parameter(mandatory = $true)]
|
|
[string]$url,
|
|
|
|
[parameter(mandatory = $true)]
|
|
[string]$apiKey
|
|
)
|
|
|
|
Test-SnipeitAlias -invocationName $MyInvocation.InvocationName -commandName $MyInvocation.MyCommand.Name
|
|
|
|
$SearchParameter = . Get-ParameterValue -Parameters $MyInvocation.MyCommand.Parameters -BoundParameters $PSBoundParameters
|
|
|
|
$apiurl = "$url/api/v1/licenses"
|
|
|
|
if ($search -and $id ) {
|
|
Throw "[$($MyInvocation.MyCommand.Name)] Please specify only -search or -id parameter , not both "
|
|
}
|
|
|
|
if ($id) {
|
|
$apiurl= "$url/api/v1/licenses/$id"
|
|
}
|
|
|
|
$Parameters = @{
|
|
Uri = $apiurl
|
|
Method = 'Get'
|
|
Token = $apiKey
|
|
GetParameters = $SearchParameter
|
|
}
|
|
|
|
if ($all) {
|
|
$offstart = $(if($offset){$offset} Else {0})
|
|
$callargs = $SearchParameter
|
|
$callargs.Remove('all')
|
|
|
|
while ($true) {
|
|
$callargs['offset'] = $offstart
|
|
$callargs['limit'] = $limit
|
|
$res=Get-SnipeitLicense @callargs
|
|
$res
|
|
if ($res.count -lt $limit) {
|
|
break
|
|
}
|
|
$offstart = $offstart + $limit
|
|
}
|
|
} else {
|
|
$result = Invoke-SnipeitMethod @Parameters
|
|
$result
|
|
}
|
|
}
|
|
|