Public/Get-Container.ps1
|
function Get-Container { <# .SYNOPSIS Get docker container .DESCRIPTION Returns references to docker containers of a docker service. It can be filtered by name and status. Wraps the command [docker ps](https://docs.docker.com/engine/reference/commandline/ps/). .PARAMETER Running Specifies if only running containers should be returned. .PARAMETER Latest Specifies if only the latest created container should be returned. .PARAMETER Name Specifies if only the container with the given name should be returned. .PARAMETER Timeout Specifies the number of seconds to wait for the command to finish. .EXAMPLE PS C:\> New-DockerContainer -Image 'microsoft/nanoserver' -Name 'mycontainer' | Out-Null PS C:\> Get-DockerContainer -Name 'mycontainer' Image : microsoft/nanoserver Ports : Command : "c:\\windows\\system32\\cmd.exe" Created : 13 seconds ago Name : mycontainer ContainerID : 1c3bd73d25552b41a677a99a15a9326ba72123096f9e10c3d36f72fb90e57f16 Status : Exited (0) 5 seconds ago #> [CmdletBinding()] param ( [Parameter(Mandatory=$false)] [switch] $Running, [Parameter(Mandatory=$false)] [switch] $Latest, [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [string] $Name, [Parameter(Mandatory=$false)] [ValidateNotNullOrEmpty()] [int] $Timeout = 1 ) $arguments = New-Object System.Collections.ArrayList $arguments.Add( 'ps' ) | Out-Null if ( $Running -eq $false ) { $arguments.Add( '--all' ) | Out-Null } if ( $Latest ) { $arguments.Add( '--latest' ) | Out-Null } if ( $Name ) { $arguments.Add( "--filter name=$Name" ) | Out-Null } $arguments.Add( '--no-trunc' ) | Out-Null Invoke-ClientCommand ` -ArgumentList $arguments ` -Timeout $Timeout ` -TableOutput @{ 'CONTAINER ID' = 'ContainerID' 'IMAGE' = 'Image' 'COMMAND' = 'Command' 'CREATED' = 'Created' 'STATUS' = 'Status' 'PORTS' = 'Ports' 'NAMES' = 'Name' } } |