AdminByRequest

1.0.0

Public/PINCode/Request-ABRPINCodeForUninstall.ps1

<#
    .SYNOPSIS
      Request an uninstall PIN code
 
    .DESCRIPTION
      Request an uninstall PIN code for the specified inventory item by either Id or ComputerName
 
    .PARAMETER Id
      The Id for the inventory item
 
    .PARAMETER ComputerName
      The ComputerName for the inventory item
 
    .EXAMPLE
      PS C:\> Request-ABRPinCodeForUninstall -Id 1234567
      Get an uninstall PIN for the inventory item Id 1234567
 
    .EXAMPLE
      PS C:\> Request-ABRPinCodeForUninstall -ComputerName $env:ComputerName
      Get an uninstall PIN for the current computer
 
    .EXAMPLE
      PS C:\> Get-ABRInventory -id 1234567 | Request-ABRPinCodeForUninstall
      Request an uninstall PIN by using pipeline support
 
#>
Function Request-ABRPinCodeForUninstall
{
  [CmdletBinding(DefaultParameterSetName = 'Id')]
  Param
  (
    [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, ParameterSetName = 'Id', Position = 0)]
    [ValidateNotNullOrEmpty()]
    [int]
    $Id,

    [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, ParameterSetName = 'Computer', Position = 0)]
    [ValidateNotNullOrEmpty()]
    [string]
    $ComputerName
  )

  Process
  {
    $URL = '/inventory'
    $Headers = @{}

    Switch ($PSCmdlet.ParameterSetName)
    {
      'Id'
      {
        If ($Id -gt 0)
        {
          $URL += '/{0}/pin' -f $Id
        }
        break
      }

      'Computer'
      {
        $URL += '/{0}/pin' -f $ComputerName
        break
      }
    }

    $Headers.Add('pintype', 'UninstallPIN')

    $InvokeABRRequest_Splat = @{
      URI = $URL
    }

    If ($Headers.Count -gt 0)
    {
      $InvokeABRRequest_Splat.Add('Headers', $Headers)
    }

    Invoke-ABRRequest @InvokeABRRequest_Splat
  }
}