New-AzContainerGroup

Modül:

Az.ContainerInstance

Kapsayıcı gruplarını belirtilen yapılandırmalarla oluşturun veya güncelleştirin.

Sözdizimi

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

Kapsayıcı gruplarını belirtilen yapılandırmalarla oluşturun veya güncelleştirin.

Örnekler

Örnek 1: Kapsayıcı örneğiyle bir kapsayıcı grubu oluşturma ve bağlantı noktalarını açma ile genel IP adresi isteme

$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

Bu komutlar, görüntüsü en son nginx olan ve 8000 ve 8001 numaralı bağlantı noktalarını açan bir genel IP adresi isteyen bir kapsayıcı örneği içeren bir kapsayıcı grubu oluşturur.

Örnek 2: Kapsayıcı grubu oluşturma ve kapsayıcı içinde özel bir betik çalıştırma.

$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

Bu komutlar bir kapsayıcı grubu oluşturur ve kapsayıcı içinde özel bir betik çalıştırır.

Örnek 3: Bir çalıştırma-tamamlama kapsayıcı grubu oluşturma

$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

Bu komutlar, 'hello' yazdıran ve durduran bir kapsayıcı grubu oluşturur.

Örnek 4: Azure Container Registry'de nginx görüntüsünü kullanarak kapsayıcı örneğiyle kapsayıcı grubu oluşturma

$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

Bu komutlar, Azure Container Registry'de görüntüsü nginx olan bir kapsayıcı örneği içeren bir kapsayıcı grubu oluşturur.

Örnek 5: Özel kapsayıcı görüntüsü kayıt defterinde nginx görüntüsünü kullanarak kapsayıcı örneğiyle kapsayıcı grubu oluşturma

$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

Bu komutlar, görüntüsü özel bir kapsayıcı görüntüsü kayıt defterinden alınan özel bir görüntü olan kapsayıcı örneğine sahip bir kapsayıcı grubu oluşturur.

Örnek 6: Azure Dosya birimini takan bir kapsayıcı grubu oluşturma

$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

Bu komutlar, görüntüsü özel bir kapsayıcı görüntüsü kayıt defterinden alınan özel bir görüntü olan kapsayıcı örneğine sahip bir kapsayıcı grubu oluşturur.

Örnek 7: Sistem tarafından atanan ve kullanıcı tarafından atanan kimlikle kapsayıcı grubu oluşturma

$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

Bu komutlar, sistem tarafından atanan ve kullanıcı tarafından atanan kimliğe sahip bir kapsayıcı grubu oluşturur.

Parametreler

-AsJob

Komutu iş olarak çalıştırma

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Container

Kapsayıcı grubu içindeki kapsayıcılar. Oluşturmak için, CONTAINER özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:	IContainer[]
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:	PSObject
Diğer adlar:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DnsConfigNameServer

Kapsayıcı grubu için DNS sunucuları.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DnsConfigOption

Kapsayıcı grubu için DNS seçenekleri.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-DnsConfigSearchDomain

Kapsayıcı grubundaki konak adı araması için DNS arama etki alanları.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-EncryptionPropertyKeyName

Şifreleme anahtarı adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-EncryptionPropertyKeyVersion

Şifreleme anahtarı sürümü.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-EncryptionPropertyVaultBaseUrl

Keyvault temel URL'si.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IdentityType

Kapsayıcı grubu için kullanılan kimlik türü. 'SystemAssigned, UserAssigned' türü hem örtük olarak oluşturulmuş bir kimliği hem de kullanıcı tarafından atanan bir kimlik kümesini içerir. 'Hiçbiri' türü kapsayıcı grubundan tüm kimlikleri kaldırır.

Tür:	ResourceIdentityType
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IdentityUserAssignedIdentity

Kapsayıcı grubuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlük anahtarı başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Tür:	Hashtable
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ImageRegistryCredential

Kapsayıcı grubunun oluşturulduğu görüntü kayıt defteri kimlik bilgileri. Oluşturmak için IMAGEREGISTRYCREDENTIAL özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:	IImageRegistryCredential[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-InitContainer

Kapsayıcı grubu için init kapsayıcıları. Oluşturmak için, INITCONTAINER özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:	IInitContainerDefinition[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IPAddressDnsNameLabel

IP için Dns adı etiketi.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IPAddressIP

Genel İnternet'e sunulan IP.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IPAddressPort

Kapsayıcı grubunda kullanıma sunulan bağlantı noktalarının listesi. Oluşturmak için IPADDRESSPORT özellikleri için NOTLAR bölümüne bakın ve bir karma tablo oluşturun.

Tür:	IPort[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-IPAddressType

IP'nin genel İnternet'e mi yoksa özel sanal ağa mı açık olduğunu belirtir.

Tür:	ContainerGroupIPAddressType
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Location

Kaynak konumu.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LogAnalyticLogType

Kullanılacak günlük türü.

Tür:	LogAnalyticsLogType
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LogAnalyticMetadata

Log Analytics için meta veriler.

Tür:	Hashtable
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LogAnalyticWorkspaceId

Log Analytics için çalışma alanı kimliği

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LogAnalyticWorkspaceKey

Log Analytics için çalışma alanı anahtarı

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-LogAnalyticWorkspaceResourceId

Log Analytics için çalışma alanı kaynak kimliği

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Name

Kapsayıcı grubunun adı.

Tür:	String
Diğer adlar:	ContainerGroupName
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-NoWait

Komutu zaman uyumsuz olarak çalıştırma

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-OSType

Kapsayıcı grubundaki kapsayıcılar için gereken işletim sistemi türü.

Tür:	OperatingSystemTypes
Position:	Named
Default value:	"Linux"
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Priority

Kapsayıcı Grubunun önceliği.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-ResourceGroupName

Kaynak grubunun adı.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-RestartPolicy

Kapsayıcı grubu içindeki tüm kapsayıcılar için yeniden başlatma ilkesi.

• Always Her zaman yeniden başlat- OnFailure Hatada yeniden başlatma- Never Hiçbir zaman yeniden başlatma

Tür:	ContainerGroupRestartPolicy
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Sku

Kapsayıcı grubunun SKU'su.

Tür:	ContainerGroupSku
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SubnetId

Kapsayıcı grubu için alt ağ kaynak kimlikleri. Oluşturmak için SUBNETID özellikleri için NOTLAR bölümüne bakın ve bir karma tablo oluşturun.

Tür:	IContainerGroupSubnetId[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SubscriptionId

Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.

Tür:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Tag

Kaynak etiketleri.

Tür:	Hashtable
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Volume

Bu kapsayıcı grubundaki kapsayıcılar tarafından bağlanabilen birimlerin listesi. Oluşturmak için VOLUME özellikleri için NOTLAR bölümüne bakın ve karma tablo oluşturun.

Tür:	IVolume[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Zone

Kapsayıcı grubunun bölgeleri.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Çıkışlar

IContainerGroup