Export-ContainerImage

Export-ContainerImage

Exports a container image to a file.

Sintaxis

Parameter Set: Container Image Object
Export-ContainerImage [-Image] <ContainerImage[]> [-Path] <String> [-AsJob] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Name
Export-ContainerImage [[-Name] <String> ] [-Path] <String> [[-Publisher] <String> ] [[-Version] <Version> ] [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Export-ContainerImage cmdlet exports a container image to a file.

Parámetros

-AsJob

Indicates that this cmdlet runs the command as a background job on a remote computer. Use this parameter to run commands that take an extensive time to complete.

When you use AsJob, the command returns an object that represents the job, and then displays the command prompt. You can continue to work in the session while the job completes. To manage the job, use the Job cmdlets. To get the job results, use the Receive-Job cmdlet.

For more information about Windows PowerShell background jobs, see about_Jobs (https://go.microsoft.com/fwlink/?LinkID=113251) and about_Remote_Jobs (https://go.microsoft.com/fwlink/?LinkID=135184).

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

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

-Credential<PSCredential[]>

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

-Image<ContainerImage[]>

Specifies the container image to be exported.

-Name<String>

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

-Passthru

Devuelve un objeto que representa el elemento con el que está trabajando. De manera predeterminada, este cmdlet no genera ningún resultado.

-Path<String>

Specfies the path to which this cmdlet exports the image.

-Publisher<String>

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

-Version<Version>

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

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

-WhatIf

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

<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: Export a container image

This command exports the container image stored in the $Image01 variable to the path C:\Containers.

PS C:\> Export-ContainerImage -Image $Image01 -Path "C:\Containers"              

Temas relacionados

Get-ContainerImage

Import-ContainerImage

New-ContainerImage

Remove-ContainerImage

Test-ContainerImage