Public/New-Audit.ps1
<#
.SYNOPSIS Add a new Audit to Snipe-it asset system .DESCRIPTION Long description .PARAMETER Tag The asset tag of the asset you wish to audit .PARAMETER Location_id ID of the location you want to associate with the audit .EXAMPLE New-Audit -tag 1 -location_id "Location of Audit" #> function New-Audit() { [CmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = "Low" )] Param( [parameter(mandatory = $true)] [string]$tag, [int]$location_id, [parameter(mandatory = $true)] [string]$url, [parameter(mandatory = $true)] [string]$apiKey ) $Values = @{ "location_id" = $location_id } if ($PSBoundParameters.ContainsKey('tag')) { $Values += @{"asset_tag" = $tag} } $Body = $Values | ConvertTo-Json; $Parameters = @{ Uri = "$url/api/v1/hardware/audit" Method = 'Post' Body = $Body Token = $apiKey } If ($PSCmdlet.ShouldProcess("ShouldProcess?")) { $result = Invoke-SnipeitMethod @Parameters } $result } |