mirror of
https://github.com/snazy2000/SnipeitPS.git
synced 2025-12-13 01:42:29 +00:00
102 lines
2.6 KiB
PowerShell
102 lines
2.6 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Create a new Snipe-IT Category
|
|
|
|
.PARAMETER name
|
|
Name of new category to be created
|
|
|
|
.PARAMETER type
|
|
Type of new category to be created (asset, accessory, consumable, component, license)
|
|
|
|
.PARAMETER eula_text
|
|
This allows you to customize your EULAs for specific types of assets
|
|
|
|
.PARAMETER use_default_eula
|
|
If switch is present, use the primary default EULA
|
|
|
|
.PARAMETER require_acceptance
|
|
If switch is present, require users to confirm acceptance of assets in this category
|
|
|
|
.PARAMETER checkin_email
|
|
If switch is present, send email to user on checkin/checkout
|
|
|
|
.PARAMETER image
|
|
Category image filename 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 API Key for Snipeit.
|
|
|
|
.EXAMPLE
|
|
New-SnipeitCategory -name "Laptops" -category_type asset
|
|
#>
|
|
|
|
function New-SnipeitCategory() {
|
|
[CmdletBinding(
|
|
SupportsShouldProcess = $true,
|
|
ConfirmImpact = "Low"
|
|
)]
|
|
|
|
Param(
|
|
[parameter(mandatory = $true)]
|
|
[string]$name,
|
|
|
|
[parameter(mandatory = $true)]
|
|
[ValidateSet("asset", "accessory", "consumable", "component", "license")]
|
|
[string]$category_type,
|
|
|
|
[string]$eula_text,
|
|
|
|
[switch]$use_default_eula,
|
|
|
|
[switch]$require_acceptance,
|
|
|
|
[switch]$checkin_email,
|
|
|
|
[ValidateScript({Test-Path $_})]
|
|
[string]$image,
|
|
|
|
[parameter(mandatory = $false)]
|
|
[string]$url,
|
|
|
|
[parameter(mandatory = $false)]
|
|
[string]$apiKey
|
|
|
|
)
|
|
begin {
|
|
Test-SnipeitAlias -invocationName $MyInvocation.InvocationName -commandName $MyInvocation.MyCommand.Name
|
|
|
|
if ($eula_text -and $use_default_eula) {
|
|
throw 'Dont use -use_defalt_eula if -eula_text is set'
|
|
}
|
|
|
|
$Values = . Get-ParameterValue -Parameters $MyInvocation.MyCommand.Parameters -BoundParameters $PSBoundParameters
|
|
}
|
|
|
|
process {
|
|
|
|
$Parameters = @{
|
|
Api = "/api/v1/categories"
|
|
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-SnipeitPSSessionUrl -url $url
|
|
}
|
|
|
|
if ($PSCmdlet.ShouldProcess("ShouldProcess?")) {
|
|
$result = Invoke-SnipeitMethod @Parameters
|
|
}
|
|
|
|
$result
|
|
}
|
|
}
|