Public/Get-Image.ps1

Register-ArgumentCompleter -CommandName Get-DockerImage -ParameterName Repository -ScriptBlock $RepositoryCompleter
Register-ArgumentCompleter -CommandName Get-DockerImage -ParameterName Tag -ScriptBlock $TagCompleter

function Get-Image {

    <#
 
    .SYNOPSIS
    Get docker image
 
    .DESCRIPTION
    Wraps the command `docker image ls`.
 
    .LINK
    https://docs.docker.com/engine/reference/commandline/image_ls/
 
    .PARAMETER Repository
    Specifies the repository to filter the images on.
 
    .PARAMETER Tag
    Specifies the tag to filter the images on.
 
    .PARAMETER Timeout
    Specifies the number of seconds to wait for the command to finish.
 
    .OUTPUTS
    Image: Returns a `Image` object for each object matching the parameters.
 
    .EXAMPLE
    PS C:\> Get-DockerImage -Repository 'microsoft/powershell'
    Created : 2 weeks ago
    ImageId : sha256:4ebab174c7292440d4d7d5e5e61d3cd4487441d3f49df0b656ccc81d2a0e4489
    Size : 364MB
    Tag : latest
    Repository : microsoft/powershell
 
    #>


    [CmdletBinding()]
    param (
        [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true )]
        [Alias( 'Name' )]
        [ValidateNotNullOrEmpty()]
        [string] $Repository,

        [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true )]
        [ValidateNotNullOrEmpty()]
        [string] $Tag,

        [Parameter( Mandatory = $false )]
        [int] $Timeout = 10
    )

    process {

        $arguments = New-Object System.Collections.ArrayList
        $arguments.Add( '--no-trunc' ) | Out-Null
        $arguments.Add( '--format="{{json .}}" ') | Out-Null

        if ( $Repository ) {
            if ( $Tag ) {
                $arguments.Add( $Repository + ':' + $Tag ) | Out-Null
            }
            else {
                $arguments.Add( $Repository ) | Out-Null
            }
        }

        Invoke-ClientCommand 'image ls', $arguments -Timeout $Timeout -JsonOutput |
            ForEach-Object {
                New-Object -TypeName Image -Property @{
                    Repository = $_.Repository
                    Tag        = switch ( $_.Tag ) { '<none>' { $null } default { $_ } }
                    Id         = $_.ID
                    CreatedAt  = $_.CreatedAt
                    Size       = $_.Size
                } | Write-Output
            } | Write-Output

    }
}