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 |
입력
출력
참고
별칭
복합 매개 변수 속성
아래에 설명된 매개 변수를 만들려면 적절한 속성을 포함하는 해시 테이블을 생성합니다. 해시 테이블에 대한 자세한 내용은 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[]>]
: 매니페스트만 복사할 리포지토리 이름의 문자열 목록입니다. 태그가 만들어지지 않습니다.