New-AzContainerGroup

모듈:

Az.ContainerInstance

지정된 구성을 사용하여 컨테이너 그룹을 만들거나 업데이트합니다.

Syntax

New-AzContainerGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Container <IContainer[]>
   -Location <String>
   [-OSType <OperatingSystemTypes>]
   [-DnsConfigNameServer <String[]>]
   [-DnsConfigOption <String>]
   [-DnsConfigSearchDomain <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-IdentityType <ResourceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-SubnetId <IContainerGroupSubnetId[]>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-Priority <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

지정된 구성을 사용하여 컨테이너 그룹을 만들거나 업데이트합니다.

예제

예제 1: 컨테이너 인스턴스를 사용하여 컨테이너 그룹 만들기 및 포트 열기가 있는 공용 IP 주소 요청

$port1 = New-AzContainerInstancePortObject -Port 8000 -Protocol TCP
$port2 = New-AzContainerInstancePortObject -Port 8001 -Protocol TCP
$container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5 -Port @($port1, $port2)
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 이미지가 최신 nginx인 컨테이너 인스턴스를 사용하여 컨테이너 그룹을 만들고 포트 8000 및 8001을 여는 공용 IP 주소를 요청합니다.

예제 2: 컨테이너 그룹을 만들고 컨테이너 내에서 사용자 지정 스크립트를 실행합니다.

$env1 = New-AzContainerInstanceEnvironmentVariableObject -Name "env1" -Value "value1"
$env2 = New-AzContainerInstanceEnvironmentVariableObject -Name "env2" -SecureValue (ConvertTo-SecureString -String "value2" -AsPlainText -Force)
$container = New-AzContainerInstanceObject -Name test-container -Image alpine -Command "/bin/sh -c myscript.sh" -EnvironmentVariable @($env1, $env2)
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 컨테이너 그룹을 만들고 컨테이너 내에서 사용자 지정 스크립트를 실행합니다.

예제 3: 실행-완료 컨테이너 그룹 만들기

$container = New-AzContainerInstanceObject -Name test-container -Image alpine -Command "echo hello" 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 'hello'를 출력하고 중지하는 컨테이너 그룹을 만듭니다.

예제 4: Azure Container Registry에서 이미지 nginx를 사용하여 컨테이너 인스턴스가 있는 컨테이너 그룹 만들기

$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force) 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 Azure Container Registry에서 이미지가 nginx인 컨테이너 인스턴스를 사용하여 컨테이너 그룹을 만듭니다.

예제 5: 사용자 지정 컨테이너 이미지 레지스트리에서 이미지 nginx를 사용하여 컨테이너 인스턴스가 있는 컨테이너 그룹 만들기

$container = New-AzContainerInstanceObject -Name test-container -Image myserver.com/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myserver.com" -Username "username" -Password (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force) 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 컨테이너 인스턴스를 사용하여 컨테이너 그룹을 만듭니다. 해당 이미지는 사용자 지정 컨테이너 이미지 레지스트리의 사용자 지정 이미지입니다.

예제 6: Azure File 볼륨을 탑재하는 컨테이너 그룹 만들기

$volume = New-AzContainerGroupVolumeObject -Name "myvolume" -AzureFileShareName "myshare" -AzureFileStorageAccountName "username" -AzureFileStorageAccountKey (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force)
$mount = New-AzContainerInstanceVolumeMountObject -MountPath "/aci/logs" -Name "myvolume"
$container = New-AzContainerInstanceObject -Name test-container -Image alpine -VolumeMount $mount
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -Volume $volume

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 컨테이너 인스턴스를 사용하여 컨테이너 그룹을 만듭니다. 해당 이미지는 사용자 지정 컨테이너 이미지 레지스트리의 사용자 지정 이미지입니다.

예제 7: 시스템 할당 및 사용자 할당 ID를 사용하여 컨테이너 그룹 만들기

$container = New-AzContainerInstanceObject -Name test-container -Image alpine
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -IdentityType "SystemAssigned, UserAssigned" -IdentityUserAssignedIdentity @{"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" = @{}}

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg      test-rg

이 명령은 시스템 할당 및 사용자 할당 ID를 사용하여 컨테이너 그룹을 만듭니다.

매개 변수

-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

-Container

컨테이너 그룹 내의 컨테이너입니다. 생성하려면 CONTAINER 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

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

-DnsConfigNameServer

컨테이너 그룹의 DNS 서버입니다.

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

-DnsConfigOption

컨테이너 그룹에 대한 DNS 옵션입니다.

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

-DnsConfigSearchDomain

DNS 검색은 컨테이너 그룹의 호스트 이름 조회를 기본.

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

-EncryptionPropertyKeyName

암호화 키 이름입니다.

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

-EncryptionPropertyKeyVersion

암호화 키 버전입니다.

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

-EncryptionPropertyVaultBaseUrl

keyvault 기준 URL입니다.

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

-IdentityType

컨테이너 그룹에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 컨테이너 그룹에서 모든 ID를 제거합니다.

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

-IdentityUserAssignedIdentity

컨테이너 그룹과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

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

-ImageRegistryCredential

컨테이너 그룹을 만든 이미지 레지스트리 자격 증명입니다. 생성하려면 IMAGEREGISTRYCREDENTIAL 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-InitContainer

컨테이너 그룹의 init 컨테이너입니다. 생성하려면 INITCONTAINER 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-IPAddressDnsNameLabel

IP의 Dns 이름 레이블입니다.

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

-IPAddressIP

공용 인터넷에 노출되는 IP입니다.

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

-IPAddressPort

컨테이너 그룹에 노출되는 포트 목록입니다. 생성하려면 IPADDRESSPORT 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-IPAddressType

IP가 공용 인터넷 또는 프라이빗 VNET에 노출되는지 여부를 지정합니다.

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

-Location

리소스 위치.

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

-LogAnalyticLogType

사용할 로그 형식입니다.

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

-LogAnalyticMetadata

로그 분석에 대한 메타데이터입니다.

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

-LogAnalyticWorkspaceId

로그 분석의 작업 영역 ID

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

-LogAnalyticWorkspaceKey

로그 분석을 위한 작업 영역 키

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

-LogAnalyticWorkspaceResourceId

로그 분석의 작업 영역 리소스 ID

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

-Name

컨테이너 그룹의 이름입니다.

Type:	String
Aliases:	ContainerGroupName
Position:	Named
Default value:	None
Required:	True
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

-OSType

컨테이너 그룹의 컨테이너에 필요한 운영 체제 유형입니다.

Type:	OperatingSystemTypes
Position:	Named
Default value:	"Linux"
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

컨테이너 그룹의 우선 순위입니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
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

-RestartPolicy

컨테이너 그룹 내의 모든 컨테이너에 대한 정책을 다시 시작합니다.

• Always항상 다시 시작- OnFailure 실패할 때 다시 시작- 다시 시작 안 하세요. Never

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

-Sku

컨테이너 그룹의 SKU입니다.

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

-SubnetId

컨테이너 그룹의 서브넷 리소스 ID입니다. 구성하려면 SUBNETID 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

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

-SubscriptionId

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

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

-Tag

리소스 태그입니다.

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

-Volume

이 컨테이너 그룹의 컨테이너에서 탑재할 수 있는 볼륨 목록입니다. 생성하려면 VOLUME 속성에 대한 NOTES 섹션을 참조하고 해시 테이블을 만듭니다.

Type:	IVolume[]
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

-Zone

컨테이너 그룹의 영역입니다.

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

출력

IContainerGroup