Import-AzContainerRegistryImage

지정된 컨테이너 레지스트리에서 이 컨테이너 레지스트리에 이미지를 복사합니다.

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

지정된 컨테이너 레지스트리에서 이 컨테이너 레지스트리에 이미지를 복사합니다.

예제

예제 1: 공용/Azure 레지스트리에서 Azure Container Registry로 이미지를 가져옵니다.

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

작업 상자를 ACR로 가져옵니다. 참고: 원본 이미지 앞에 "library/"를 추가해야 합니다. 이 cmdlet에 원본 레지스트리를 공개적으로 사용할 수 없는 경우 "busybox:latest" => "library/busybox:latest" Credential이 필요합니다. 이 cmdlet에는 SourceRegistryResourceId 또는 SourceRegistryUri가 필요합니다.

매개 변수

-AsJob

작업으로 명령 실행

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

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

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

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

-Mode

Force를 적용하면 기존 대상 태그를 덮어씁니다. NoForce가 발생하면 복사가 시작되기 전에 기존 대상 태그가 작업에 실패합니다.

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

-NoWait

명령을 비동기적으로 실행

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

-Parameter

. 생성하려면 PARAMETER 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-PassThru

명령이 성공하면 true를 반환합니다.

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

-Password

원본 레지스트리를 사용하여 인증하는 데 사용되는 암호입니다.

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

-RegistryName

컨테이너 레지스트리의 이름입니다.

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

-ResourceGroupName

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

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

-SourceImage

원본 이미지의 리포지토리 이름입니다. 리포지토리별로 이미지를 지정합니다('hello-world'). '최신' 태그를 사용합니다. 태그로 이미지를 지정합니다('hello-world:latest'). sha256 기반 매니페스트 다이제스트('hello-world@sha256:abc123')로 이미지를 지정합니다.

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

-SourceRegistryUri

원본 레지스트리의 주소(예: 'mcr.microsoft.com')입니다.

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

-SourceResourceId

원본 Azure Container Registry의 리소스 식별자입니다.

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

-SubscriptionId

대상 구독의 ID입니다. 값은 UUID여야 합니다.

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

-TargetTag

양식 리포지토리[:tag]의 문자열 목록입니다. 태그를 생략하면 원본이 사용됩니다(또는 원본 태그도 생략된 경우 '최신').

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

-UntaggedTargetRepository

매니페스트만 복사할 리포지토리 이름의 문자열 목록입니다. 태그가 만들어지지 않습니다.

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

-Username

원본 레지스트리를 사용하여 인증할 사용자 이름입니다.

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

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

IImportImageParameters

출력

Boolean

참고

별칭

복합 매개 변수 속성

아래에 설명된 매개 변수를 만들려면 적절한 속성을 포함하는 해시 테이블을 생성합니다. 해시 테이블에 대한 자세한 내용은 Get-Help about_Hash_Tables 실행합니다.

PARAMETER <IImportImageParameters>: .

  • SourceImage <String>: 원본 이미지의 리포지토리 이름입니다. 리포지토리별로 이미지를 지정합니다('hello-world'). '최신' 태그를 사용합니다. 태그로 이미지를 지정합니다('hello-world:latest'). sha256 기반 매니페스트 다이제스트('hello-world@sha256:abc123')로 이미지를 지정합니다.
  • [CredentialsPassword <String>]: 원본 레지스트리를 사용하여 인증하는 데 사용되는 암호입니다.
  • [CredentialsUsername <String>]: 원본 레지스트리를 사용하여 인증할 사용자 이름입니다.
  • [Mode <ImportMode?>]: 강제 적용 시 기존 대상 태그를 덮어씁니다. NoForce가 발생하면 복사가 시작되기 전에 기존 대상 태그가 작업에 실패합니다.
  • [SourceRegistryUri <String>]: 원본 레지스트리의 주소(예: 'mcr.microsoft.com')입니다.
  • [SourceResourceId <String>]: 원본 Azure Container Registry의 리소스 식별자입니다.
  • [TargetTag <String[]>]: 양식 리포지토리의 문자열 목록[:tag]입니다. 태그를 생략하면 원본이 사용됩니다(또는 원본 태그도 생략된 경우 '최신').
  • [UntaggedTargetRepository <String[]>]: 매니페스트만 복사할 리포지토리 이름의 문자열 목록입니다. 태그가 만들어지지 않습니다.