Import-AzContainerRegistryImage

  • Referência
Módulo:
Az.ContainerRegistry

Copia uma imagem para este registro de contêiner do registro de contêiner 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 uma imagem para este registro de contêiner do registro de contêiner especificado.

Exemplos

Exemplo 1: Importar imagem de um registro público/azure para um registro de contêiner azure.

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

Importe busybox para ACR. Nota: "library/" precisa ser adicionado antes da imagem de origem. "busybox:latest" => "library/busybox:latest" Credencial necessária se o registro de origem não estiver disponível publicamente SourceRegistryResourceId ou SourceRegistryUri for necessário para este cmdlet

Parâmetros

-AsJob

Executar o comando como um trabalho

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

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

-Mode

Quando Force, todas as tags de destino existentes serão substituídas. Quando NoForce, qualquer tag de destino existente falhará na operação antes de qualquer cópia começar.

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

-NoWait

Execute o comando de forma assíncrona

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

-Parameter

. Para construir, consulte a seção NOTAS para propriedades PARAMETER e crie uma tabela de hash.

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

-PassThru

Retorna true quando o comando é bem-sucedido

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

-Password

A senha usada para autenticar com o registro de origem.

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

-RegistryName

O nome do registro de contêiner.

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

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

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

-SourceImage

Nome do repositório da imagem de origem. Especifique uma imagem por repositório ('hello-world'). Isso usará a tag 'mais recente'. Especifique uma imagem por tag ('hello-world:latest'). Especifique uma imagem por resumo de manifesto baseado em sha256 ('hello-world@sha256:abc123').

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

-SourceRegistryUri

O endereço do registo de origem (por exemplo, «mcr.microsoft.com»).

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

-SourceResourceId

O identificador de recurso do Registro de Contêiner do Azure de origem.

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

-SubscriptionId

A ID da assinatura de destino. O valor deve ser um UUID.

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

-TargetTag

Lista de cadeias de caracteres do formulário repo[:tag]. Quando a tag é omitida, a fonte será usada (ou 'mais recente' se a tag source também for omitida).

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

-UntaggedTargetRepository

Lista de cadeias de caracteres de nomes de repositórios para fazer uma cópia somente de manifesto. Nenhuma tag será criada.

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

-Username

O nome de usuário a ser autenticado com o registro de origem.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Entradas

IImportImageParameters

Saídas

Boolean

Notas

PSEUDÓNIMOS

PROPRIEDADES DE PARÂMETROS COMPLEXOS

Para criar os parâmetros descritos abaixo, construa uma tabela de hash contendo as propriedades apropriadas. Para obter informações sobre tabelas de hash, execute Get-Help about_Hash_Tables.

PARAMETER <IImportImageParameters>: .

  • SourceImage <String>: Nome do repositório da imagem de origem. Especifique uma imagem por repositório ('hello-world'). Isso usará a tag 'mais recente'. Especifique uma imagem por tag ('hello-world:latest'). Especifique uma imagem por resumo de manifesto baseado em sha256 ('hello-world@sha256:abc123').
  • [CredentialsPassword <String>]: A senha usada para autenticar com o registro de origem.
  • [CredentialsUsername <String>]: O nome de usuário a ser autenticado com o registro de origem.
  • [Mode <ImportMode?>]: Quando Force, todas as tags de destino existentes serão substituídas. Quando NoForce, qualquer tag de destino existente falhará na operação antes de qualquer cópia começar.
  • [SourceRegistryUri <String>]: O endereço do registo de origem (por exemplo, «mcr.microsoft.com»).
  • [SourceResourceId <String>]: O identificador de recurso do Registro de Contêiner do Azure de origem.
  • [TargetTag <String[]>]: Lista de cadeias de caracteres do formulário repo[:tag]. Quando a tag é omitida, a fonte será usada (ou 'mais recente' se a tag source também for omitida).
  • [UntaggedTargetRepository <String[]>]: Lista de cadeias de caracteres de nomes de repositórios para fazer uma cópia somente de manifesto. Nenhuma tag será criada.