Public/New-SnipeitLocation.ps1
|
<# .SYNOPSIS Add a new Location to Snipe-it asset system .DESCRIPTION Long description .PARAMETER name Name of the Location .PARAMETER address Address line 1 of the location .PARAMETER address2 Address line 2 of the location .PARAMETER state Address State of the location .PARAMETER country Country of the location .PARAMETER zip The zip code of the location .PARAMETER ldap_ou The LDAP OU of the location .PARAMETER parent_id Parent location ID for the location .PARAMETER currency Currency used at the location .PARAMETER city City of the location .PARAMETER manager_id The manager ID of the location .PARAMETER image Location 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 for Snipeit. .EXAMPLE New-SnipeitLocation -name "Room 1" -address "123 Asset Street" -parent_id 14 #> function New-SnipeitLocation() { [CmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = "Low" )] Param( [parameter(mandatory = $true)] [string]$name, [string]$address, [string]$address2, [string]$city, [string]$state, [string]$country, [string]$zip, [string]$currency, [int]$parent_id, [int]$manager_id, [string]$ldap_ou, [ValidateScript({Test-Path $_})] [string]$image, [switch]$image_delete=$false, [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 $Parameters = @{ Api = "/api/v1/locations" Method = 'post' Body = $Values } if ($PSBoundParameters.ContainsKey('apiKey') -and '' -ne [string]$apiKey) { Write-Warning "-apiKey parameter is deprecated, please use Connect-SnipeitPS instead." Set-SnipeitPSLegacyApiKey -apiKey $apikey } if ($PSBoundParameters.ContainsKey('url') -and '' -ne [string]$url) { Write-Warning "-url parameter is deprecated, please use Connect-SnipeitPS instead." Set-SnipeitPSLegacyUrl -url $url } } process { if ($PSCmdlet.ShouldProcess("ShouldProcess?")) { $result = Invoke-SnipeitMethod @Parameters } $result } end { # reset legacy sessions if ($PSBoundParameters.ContainsKey('url') -and '' -ne [string]$url -or $PSBoundParameters.ContainsKey('apiKey') -and '' -ne [string]$apiKey) { Reset-SnipeitPSLegacyApi } } } |