Get-ContainerImage
Get-ContainerImage
Gets local container images.
Sintaxis
Parameter Set: Default
Get-ContainerImage [[-Name] <String> ] [[-Publisher] <String> ] [[-Version] <Version> ] [-ChildOf <ContainerImage> ] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [ <CommonParameters>]
Descripción detallada
The Get-ContainerImage cmdlet gets local container images.
Parámetros
-ChildOf<ContainerImage>
Specifies the container image for which to retrieve dependent images.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-CimSession<CimSession[]>
Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-ComputerName<String[]>
Specifies one or more Hyper-V hosts to run the cmdlet. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer. Use "localhost" or a dot (".") to specify the local computer explicitly.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Credential<PSCredential[]>
Specifies a user account that has permission to perform this action. The default is the current user.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Name<String>
Specifies the name of the container image that this cmdlet retrieves.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
1 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Publisher<String>
Specifies the publisher of the container image that this cmdlet retrieves.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
2 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Version<Version>
Specifies the version of the container image that this cmdlet retrieves.
Alias |
none |
¿Necesario? |
false |
¿Posición? |
3 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.
Salidas
El tipo de resultado es el tipo de los objetos que el cmdlet emite.
Microsoft.Containers.PowerShell.Objects.ContainerImage
Microsoft.Containers.PowerShell.Objects.ContainerImage
Ejemplos
Example 1: Retrieve all local container images
This command retrieves all local container images.
PS C:\> Get-ContainerImage
Example 2: Retrieve dependent images
This command gets all container images that are dependent upon the image stored in the $MyImage variable.
PS C:\> Get-ContainerImage -ChildOf $MyImage