Public/Set-SnipeitAssetOwner.ps1
<# .SYNOPSIS Checkout asset .DESCRIPTION Checkout asset to user/localtion/asset .PARAMETER ID Unique IDs For assets to checkout .PARAMETER assigned_id Id of target user , location or asset .PARAMETER checkout_to_type Checkout asset to one of following types user, location, asset .PARAMETER note Notes about checkout .PARAMETER name Optional new asset name. This is useful for changing the asset's name on new checkout, for example, an asset that was named "Anna's Macbook Pro" could be renamed on the fly when it's checked out to Elizabeth, to "Beth's Macbook Pro" .PARAMETER expected_checkin Optional date the asset is expected to be checked in .PARAMETER checkout_at Optional date to override the checkout time of now .PARAMETER url Deprecated parameter, please use Connect-SnipeitPS instead. URL of Snipeit system. .PARAMETER apiKey Deprecated parameter, please use Connect-SnipeitPS instead. User's API Key for Snipeit. .EXAMPLE Set-SnipeitAssetOwner -id 1 -assigned_id 1 -checkout_to_type user -note "testing check out to user" #> function Set-SnipeitAssetOwner() { [CmdletBinding( SupportsShouldProcess = $true, ConfirmImpact = "Medium" )] Param( [parameter(mandatory = $true,ValueFromPipelineByPropertyName)] [int[]]$id, [parameter(mandatory = $true)] [int]$assigned_id, [ValidateSet("location","asset","user")] [string] $checkout_to_type = "user", [string] $name, [string] $note, [datetime] $expected_checkin, [datetime]$checkout_at, [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 if ($Values['expected_checkin']) { $Values['expected_checkin'] = $Values['expected_checkin'].ToString("yyyy-MM-dd") } if ($Values['checkout_at']) { $Values['checkout_at'] = $Values['checkout_at'].ToString("yyyy-MM-dd") } switch ($checkout_to_type) { 'location' { $Values += @{ "assigned_location" = $assigned_id } } 'user' { $Values += @{ "assigned_user" = $assigned_id } } 'asset' { $Values += @{ "assigned_asset" = $assigned_id } } } #This can be removed now if ($Values.ContainsKey('assigned_id')) {$Values.Remove('assigned_id')} } process{ foreach($asset_id in $id) { $Parameters = @{ Api = "/api/v1/hardware/$asset_id/checkout" 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 } if ($PSCmdlet.ShouldProcess("ShouldProcess?")) { $result = Invoke-SnipeitMethod @Parameters } return $result } } end { # reset legacy sessions if ($PSBoundParameters.ContainsKey('url') -and '' -ne [string]$url -or $PSBoundParameters.ContainsKey('apiKey') -and '' -ne [string]$apiKey) { Reset-SnipeitPSLegacyApi } } } |