Import-AzContainerRegistryImage

  • Referencia
Módulo:
Az.ContainerRegistry

Copia una imagen en este registro de contenedor desde el registro de contenedor especificado.

Syntax

Import-AzContainerRegistryImage
      -RegistryName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -SourceImage <String>
      [-Mode <ImportMode>]
      [-Password <String>]
      [-SourceRegistryUri <String>]
      [-SourceResourceId <String>]
      [-TargetTag <String[]>]
      [-UntaggedTargetRepository <String[]>]
      [-Username <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-AzContainerRegistryImage
      -RegistryName <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      -Parameter <IImportImageParameters>
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Copia una imagen en este registro de contenedor desde el registro de contenedor especificado.

Ejemplos

Ejemplo 1: Importación de una imagen de un registro público o de Azure a un registro de contenedor de Azure.

Import-AzContainerRegistryImage -SourceImage library/busybox:latest -ResourceGroupName $resourceGroupName -RegistryName $RegistryName -SourceRegistryUri docker.io -TargetTag busybox:latest

Importe busybox a ACR. Nota: "biblioteca/" debe agregarse antes de la imagen de origen. "busybox:latest" => "library/busybox:latest" Credencial necesaria si el registro de origen no está disponible públicamente SourceRegistryResourceId o SourceRegistryUri es necesario para este cmdlet.

Parámetros

-AsJob

Ejecución del comando como trabajo

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mode

Cuando Force, se sobrescribirán las etiquetas de destino existentes. Cuando NoForce, las etiquetas de destino existentes producirán un error en la operación antes de que comience cualquier copia.

Type:ImportMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Ejecutar el comando de forma asincrónica

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Parameter

. Para construir, consulte la sección NOTES para las propiedades PARAMETER y crear una tabla hash.

Type:IImportImageParameters
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Devuelve true cuando el comando se ejecuta correctamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Contraseña usada para autenticarse con el registro de origen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RegistryName

Nombre del registro de contenedor.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceImage

Nombre del repositorio de la imagen de origen. Especifique una imagen por repositorio ("hello-world"). Esto usará la etiqueta "latest". Especifique una imagen por etiqueta ("hello-world:latest"). Especifique una imagen por resumen de manifiesto basado en sha256 ("hello-world@sha256:abc123").

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceRegistryUri

Dirección del registro de origen (por ejemplo, "mcr.microsoft.com").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceResourceId

Identificador de recurso del origen de Azure Container Registry.

Type:String
Aliases:SourceRegistryResourceId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Identificador de la suscripción de destino. El valor debe ser un UUID.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetTag

Lista de cadenas del repositorio de formulario[:tag]. Cuando se omite la etiqueta, se usará el origen (o "latest" si también se omite la etiqueta de origen).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UntaggedTargetRepository

Lista de cadenas de nombres de repositorio para realizar una copia de manifiesto solo. No se creará ninguna etiqueta.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Username

Nombre de usuario que se va a autenticar con el registro de origen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

IImportImageParameters

Salidas

Boolean

Notas

ALIAS

PROPIEDADES DE PARÁMETRO COMPLEJAS

Para crear los parámetros descritos a continuación, cree una tabla hash que contenga las propiedades adecuadas. Para obtener información sobre las tablas hash, ejecute Get-Help about_Hash_Tables.

PARAMETER <IImportImageParameters>: .

  • SourceImage <String>: nombre del repositorio de la imagen de origen. Especifique una imagen por repositorio ("hello-world"). Esto usará la etiqueta "latest". Especifique una imagen por etiqueta ("hello-world:latest"). Especifique una imagen por resumen de manifiesto basado en sha256 ("hello-world@sha256:abc123").
  • [CredentialsPassword <String>]: la contraseña usada para autenticarse con el registro de origen.
  • [CredentialsUsername <String>]: nombre de usuario que se va a autenticar con el registro de origen.
  • [Mode <ImportMode?>]: Cuando force, se sobrescribirán las etiquetas de destino existentes. Cuando NoForce, las etiquetas de destino existentes producirán un error en la operación antes de que comience cualquier copia.
  • [SourceRegistryUri <String>]: dirección del registro de origen (por ejemplo, "mcr.microsoft.com").
  • [SourceResourceId <String>]: identificador de recurso del origen de Azure Container Registry.
  • [TargetTag <String[]>]: lista de cadenas del repositorio de formulario[:tag]. Cuando se omite la etiqueta, se usará el origen (o "latest" si también se omite la etiqueta de origen).
  • [UntaggedTargetRepository <String[]>]: lista de cadenas de nombres de repositorio para realizar una copia de manifiesto solo. No se creará ninguna etiqueta.