Private/Invoke-AIMClient.ps1

Function Invoke-AIMClient {

    <#
    .SYNOPSIS
    Defines specified CLIPasswordSDK command and arguments

    .DESCRIPTION
    Defines a CLIPasswordSDK process object with arguments required for specific command.

    .PARAMETER ClientPath
    The Path to CLIPasswordSDK.exe.
    Defaults to value of $Script:AIM.ClientPath, which is set during module import or via Set-AIMConfiguration.

    .PARAMETER CommandParameters
    The CLIPasswordSDK command to execute

    .PARAMETER PAROptions
    Additional command parameters.

    .PARAMETER RemainingArgs
    A catch all parameter, accepts any remaining values from pipeline.
    Intended to suppress errors when piping in an object.

    .EXAMPLE
    Invoke-AIMClient -CommandParameters "/p AppDescs.AppID=TestApp /p RequiredProps=UserName,Address /p Query="Safe=TestSafe;Folder=Root;UserName=TestUser1" /o PassProps.UserName,PassProps.Address,Password,PasswordChangeInProcess""

    Invokes the GetPassword action using the provided arguments.

    .NOTES
        AUTHOR: Pete Maan

    #>


    [CmdLetBinding(SupportsShouldProcess)]
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', 'RemainingArgs', Justification = 'Intentionally Unused Parameter')]
    param(

        [Parameter(
            Mandatory = $False,
            ValueFromPipelineByPropertyName = $True
        )]
        [string]$ClientPath = $Script:AIM.ClientPath,

        [Parameter(
            Mandatory = $False,
            ValueFromPipelineByPropertyName = $True
        )]
        [string]$Command = 'GetPassword',

        [Parameter(
            Mandatory = $True,
            ValueFromPipelineByPropertyName = $True
        )]
        [string]$CommandParameters,

        [Parameter(Mandatory = $False,
            ValueFromPipelineByPropertyName = $True
        )]
        [string]$Options,

        [Parameter(Mandatory = $False,
            ValueFromPipelineByPropertyName = $False,
            ValueFromRemainingArguments = $true
        )]
        $RemainingArgs
    )

    Begin {

        Try {

            Get-Variable -Name AIM -ErrorAction Stop

            #Check we have the path to the required client executable
            if ($AIM.PSObject.Properties.Name -notcontains 'ClientPath') {

                Write-Error 'Heads Up!' -ErrorAction Stop

            }

        } Catch { throw "CLIPasswordSDK.exe not found `nRun Set-AIMConfiguration to set path to CLIPasswordSDK" }

        #Create process
        $Process = New-Object System.Diagnostics.Process

    }

    Process {

        if ($PSCmdlet.ShouldProcess($ClientPath, "$CommandParameters")) {

            Write-Debug "Command Arguments: $Command $Options $CommandParameters"

            #Assign process parameters

            $Process.StartInfo.WorkingDirectory = "$(Split-Path $ClientPath -Parent)"
            $Process.StartInfo.Filename = $ClientPath
            $Process.StartInfo.Arguments = "$Command $Options $CommandParameters"
            $Process.StartInfo.RedirectStandardOutput = $True
            $Process.StartInfo.RedirectStandardError = $True
            $Process.StartInfo.UseShellExecute = $False
            $Process.StartInfo.CreateNoWindow = $True
            $Process.StartInfo.WindowStyle = 'hidden'

            #Start Process
            $Result = Start-AIMClientProcess -Process $Process -ErrorAction Stop

            #Return Error or Result
            if ($Result.StdErr -match '((?:^[A-Z]{5}[0-9]{3}[A-Z])|(?:ERROR \(\d+\)))(?::)? (.+)$') {

                #APPAP008E Problem occurred while trying to use user in the Vault
                Write-Debug "ErrorId: $($Matches[1])"
                Write-Debug "Message: $($Matches[2])"
                Write-Error -Message $Matches[2] -ErrorId $Matches[1]

            } Else { $Result }
        }

    }

    End {

        $Process.Dispose()

    }

}