Import-AzContainerRegistryImage

  • Référence
Module:
Az.ContainerRegistry

Copie une image dans ce registre de conteneurs à partir du registre de conteneurs spécifié.

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

Copie une image dans ce registre de conteneurs à partir du registre de conteneurs spécifié.

Exemples

Exemple 1 : Importer une image à partir d’un registre public/azure dans un registre de conteneurs Azure.

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

Importez busybox dans ACR. Remarque : « bibliothèque/ » doit être ajouté avant l’image source. « busybox :latest » => « library/busybox :latest » Informations d’identification nécessaires si le registre source n’est pas disponible publiquement SourceRegistryResourceId ou SourceRegistryUri est requis pour cette applet de commande

Paramètres

-AsJob

Exécuter la commande en tant que travail

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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

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

-Mode

Lorsque force, toutes les balises cibles existantes sont remplacées. Quand NoForce, toutes les balises cibles existantes échouent avant le début de la copie.

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

-NoWait

Exécuter la commande de manière asynchrone

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

-Parameter

. Pour construire, consultez la section NOTES pour les propriétés PARAMETER et créer une table de hachage.

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

-PassThru

Retourne true lorsque la commande réussit

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

-Password

Mot de passe utilisé pour s’authentifier auprès du registre source.

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

-RegistryName

Nom du registre de conteneurs.

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

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

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

-SourceImage

Nom du référentiel de l’image source. Spécifiez une image par référentiel ('hello-world'). Cette opération utilise la balise « latest ». Spécifiez une image par balise ('hello-world :latest'). Spécifiez une image par synthèse de manifeste basé sur sha256 ('hello-world@sha256 :abc123').

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

-SourceRegistryUri

Adresse du registre source (par exemple, « mcr.microsoft.com »).

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

-SourceResourceId

Identificateur de ressource de la source Azure Container Registry.

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

-SubscriptionId

ID de l’abonnement cible. La valeur doit être un UUID.

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

-TargetTag

Liste des chaînes du dépôt de formulaire[ :tag]. Lorsque la balise est omise, la source est utilisée (ou « latest » si la balise source est également omise).

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

-UntaggedTargetRepository

Liste des chaînes de noms de référentiels pour effectuer une copie de manifeste uniquement. Aucune balise n’est créée.

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

-Username

Nom d’utilisateur à authentifier auprès du registre source.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

IImportImageParameters

Sorties

Boolean

Notes

ALIAS

PROPRIÉTÉS DE PARAMÈTRES COMPLEXES

Pour créer les paramètres décrits ci-dessous, construisez une table de hachage contenant les propriétés appropriées. Pour plus d’informations sur les tables de hachage, exécutez Get-Help about_Hash_Tables.

PARAMETER <IImportImageParameters>: .

  • SourceImage <String>: nom du référentiel de l’image source. Spécifiez une image par référentiel ('hello-world'). Cette opération utilise la balise « latest ». Spécifiez une image par balise ('hello-world :latest'). Spécifiez une image par synthèse de manifeste basé sur sha256 ('hello-world@sha256 :abc123').
  • [CredentialsPassword <String>]: mot de passe utilisé pour s’authentifier auprès du registre source.
  • [CredentialsUsername <String>]: nom d’utilisateur à authentifier auprès du registre source.
  • [Mode <ImportMode?>]: Lorsque force, toutes les balises cibles existantes sont remplacées. Quand NoForce, toutes les balises cibles existantes échouent avant le début de la copie.
  • [SourceRegistryUri <String>]: adresse du registre source (par exemple, « mcr.microsoft.com »).
  • [SourceResourceId <String>]: identificateur de ressource de la source Azure Container Registry.
  • [TargetTag <String[]>]: liste de chaînes du dépôt de formulaire[ :tag]. Lorsque la balise est omise, la source est utilisée (ou « latest » si la balise source est également omise).
  • [UntaggedTargetRepository <String[]>]: liste de chaînes de noms de référentiels pour effectuer une copie de manifeste uniquement. Aucune balise n’est créée.