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
}