New-ContainerImage

發行項
11/17/2015

New-ContainerImage

Creates a container image from an existing container.

語法

Parameter Set: Container Id
New-ContainerImage [-ContainerId] <Guid> [-Name] <String> [-Publisher] <String> [-Version] <Version> [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

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

Parameter Set: Container Object
New-ContainerImage [-Container] <Container> [-Name] <String> [-Publisher] <String> [-Version] <Version> [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The New-ContainerImage cmdlet creates a container image from an existing container.

參數

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-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

-Container<Container>

Specifies the container from which to create the image.

別名	none
必要項？	true
位置？	1
預設值	none
接受管線輸入？	true(ByValue)
接受萬用字元？	false

-ContainerId<Guid>

Specifies the ID of the container from which to create the image.

別名	none
必要項？	true
位置？	1
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-ContainerName<String>

Specifies the name of the container from which to create the image.

別名	none
必要項？	true
位置？	1
預設值	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 creates.

別名	none
必要項？	true
位置？	2
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-Publisher<String>

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

別名	none
必要項？	true
位置？	3
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-Version<Version>

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

別名	none
必要項？	true
位置？	4
預設值	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)。

輸入

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

輸出

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

Microsoft.Containers.PowerShell.Objects.ContainerImage

Microsoft.Containers.PowerShell.Objects.ContainerImage

範例

Create a container image from an existing container

This command creates a new container image from the container in the $Container01 variable, and specifies the name, publisher, and version of the new image.

PS C:\> New-ContainerImage -Container $Container01 -Name "Image01" -Publisher Contoso -Version 1.1.0.0

Share via

New-ContainerImage