Internal/Invoke-ClientCommand.ps1
function Invoke-ClientCommand { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string[]] $ArgumentList, [Parameter(Mandatory=$true)] [ValidateNotNullOrEmpty()] [int] $TimeoutMS, [Parameter(Mandatory=$false)] [switch] $StringOutput, [Parameter(Mandatory=$false)] [switch] $TableOutput, [Parameter(Mandatory=$false)] [hashtable] $ColumnNames ) # Configure process $process = New-Object System.Diagnostics.Process $process.StartInfo.Filename = "docker" $process.StartInfo.Arguments = $ArgumentList $process.StartInfo.RedirectStandardOutput = $true $process.StartInfo.RedirectStandardError = $true $process.StartInfo.UseShellExecute = $false $process.StartInfo.CreateNoWindow = $true # Connect output events $standardOutputBuffer = New-Object System.Collections.SortedList $standardErrorBuffer = New-Object System.Collections.SortedList $EventAction = { if ( -not [String]::IsNullOrEmpty( $EventArgs.Data )) { $Event.MessageData.Add( $event.EventIdentifier, $EventArgs.Data ) | Out-Null Write-Verbose $EventArgs.Data } } $outputEvent = Register-ObjectEvent -InputObject $process ` -EventName 'OutputDataReceived' -Action $EventAction -MessageData $standardOutputBuffer $errorEvent = Register-ObjectEvent -InputObject $process ` -EventName 'ErrorDataReceived' -Action $EventAction -MessageData $standardErrorBuffer try { $processCall = "$( $process.StartInfo.FileName ) $( $process.StartInfo.Arguments )" if ( $processCall.Length -ge 250 ) { $processCall = "$( $processCall.Substring(252) )..." } Write-Verbose "Process started: $processCall" $process.Start() | Out-Null $process.BeginOutputReadLine() $process.BeginErrorReadLine() # Wait for exit if ( $TimeoutMS ) { $process.WaitForExit( $TimeoutMS ) | Out-Null } $process.WaitForExit() | Out-Null # Ensure streams are flushed Write-Verbose "Process exited (code $( $process.ExitCode )) after $( $process.TotalProcessorTime )." } catch { throw } finally { Unregister-Event -SourceIdentifier $outputEvent.Name Unregister-Event -SourceIdentifier $errorEvent.Name } # Process output if ( $standardOutputBuffer.Count ) { if ( $StringOutput ) { $standardOutput = $standardOutputBuffer.Values -join "`r`n" Write-Verbose "Process output: $standardOutput" $standardOutput } elseif ( $TableOutput ) { Convert-ToTable -Content $standardOutputBuffer.Values -ColumnNames $ColumnNames } } else { Write-Verbose "No process output" } # process error if ( $standardErrorBuffer.Count -or $process.ExitCode ) { foreach ( $line in $standardErrorBuffer.Values ) { if ( $line ) { Write-Warning "Process error: $line" -ErrorAction 'Continue' } } throw "Proccess failed ($processCall) after $( $process.TotalProcessorTime )." } else { Write-Verbose "No process error output" } if ( $process.TotalProcessorTime.TotalMilliseconds -ge $TimeoutMS ) { throw "Process timed out ($processCall) after $( $process.TotalProcessorTime )." } } |