Import-ContainerImage
Import-ContainerImage
Imports a container image from a file.
Sintaxis
Parameter Set: Default
Import-ContainerImage [-Path] <String> [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Descripción detallada
The Import-ContainerImage cmdlet imports a container image from 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).
Alias |
none |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-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 |
-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 |
-Path<String>
Specifies the path of the container image file that this cmdlet imports.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
1 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
true(ByValue) |
¿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
Example 1: Import a container image
This command imports a container image from the file at C:\ContainerImages\CN=Test_Image_1.0.0.0.APPX.
PS C:\> Import-ContainerImage -Path "C:\ContainerImages\CN=Test_Image_1.0.0.0.APPX"