New-ContainerImage

New-ContainerImage

Creates a container image from an existing container.

Sintaxis

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>]

Descripción detallada

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

Parámetros

-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

-Container<Container>

Specifies the container from which to create the image.

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	true(ByValue)
¿Aceptar caracteres comodín?	false

-ContainerId<Guid>

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

Alias	none
¿Necesario?	true
¿Posición?	1
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-ContainerName<String>

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

Alias	none
¿Necesario?	true
¿Posición?	1
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 creates.

Alias	none
¿Necesario?	true
¿Posición?	2
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 creates.

Alias	none
¿Necesario?	true
¿Posición?	3
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 creates.

Alias	none
¿Necesario?	true
¿Posición?	4
Valor predeterminado	none
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

¿Necesario?	false
¿Posición?	named
Valor predeterminado	false
¿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

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          

Temas relacionados

Export-ContainerImage

Get-ContainerImage

Import-ContainerImage

Remove-ContainerImage

Test-ContainerImage