Share via


Get-ContainerImage

Get-ContainerImage

Gets local container images.

語法

Parameter Set: Default
Get-ContainerImage [[-Name] <String> ] [[-Publisher] <String> ] [[-Version] <Version> ] [-ChildOf <ContainerImage> ] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [ <CommonParameters>]

詳細描述

The Get-ContainerImage cmdlet gets local container images.

參數

-ChildOf<ContainerImage>

Specifies the container image for which to retrieve dependent images.

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件,例如 New-CimSessionGet-CimSession Cmdlet 的輸出。預設為本機電腦上目前的工作階段。

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

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.

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Credential<PSCredential[]>

Specifies a user account that has permission to perform this action. The default is the current user.

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Name<String>

Specifies the name of the container image that this cmdlet retrieves.

別名

none

必要項?

false

位置?

1

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Publisher<String>

Specifies the publisher of the container image that this cmdlet retrieves.

別名

none

必要項?

false

位置?

2

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Version<Version>

Specifies the version of the container image that this cmdlet retrieves.

別名

none

必要項?

false

位置?

3

預設值

none

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個指令程式支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是可透過管道傳送至指令程式的物件類型。

輸出

輸出類型是指令程式所發出的物件類型。

  • Microsoft.Containers.PowerShell.Objects.ContainerImage

    Microsoft.Containers.PowerShell.Objects.ContainerImage

範例

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                        

相關主題

Export-ContainerImage

Import-ContainerImage

New-ContainerImage

Remove-ContainerImage

Test-ContainerImage