Share via


Remove-ContainerImage

Remove-ContainerImage

Removes a container image.

語法

Parameter Set: Container Image Object
Remove-ContainerImage [-Image] <ContainerImage> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Name
Remove-ContainerImage [[-Name] <String> ] [[-Publisher] <String> ] [[-Version] <Version> ] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The Remote-ContainerImage cmdlet removes a container image.

參數

-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

-Force

強制執行命令,不要求使用者確認。

別名

none

必要項?

false

位置?

named

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Image<ContainerImage>

Specifies the image to be removed.

別名

none

必要項?

true

位置?

1

預設值

none

接受管線輸入?

true(ByValue)

接受萬用字元?

false

-Name<String>

Specifies the name of the image to be removed.

別名

none

必要項?

false

位置?

1

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Publisher<String>

Specifies the publisher of the image to be removed.

別名

none

必要項?

false

位置?

2

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Version<Version>

Specifies the version of the image to be removed.

別名

none

必要項?

false

位置?

3

預設值

none

接受管線輸入?

false

接受萬用字元?

false

-Confirm

在執行指令程式之前提示您確認。

必要項?

false

位置?

named

預設值

false

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

示範當執行指令程式時會發生什麼事情。此指令程式並未執行。

必要項?

false

位置?

named

預設值

false

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

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

輸入

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

輸出

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

範例

Example 1: Remove a container image

This command removes the container image that is stored in the variable $Image01, without prompting for confirmation.

PS C:\> Remove-ContainerImage -Image $Image01 -Force                        

相關主題

Export-ContainerImage

Get-ContainerImage

Import-ContainerImage

Test-ContainerImage