Saran dan Komentar

New-AzContainerGroup

  • Referensi
Modul:
Az.ContainerInstance

Membuat atau memperbarui grup kontainer dengan konfigurasi tertentu.

Sintaks

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

Deskripsi

Membuat atau memperbarui grup kontainer dengan konfigurasi tertentu.

Contoh

Contoh 1: Membuat grup kontainer dengan instans kontainer dan meminta alamat IP publik dengan port pembuka

$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

Perintah ini membuat grup kontainer dengan instans kontainer, yang gambarnya adalah nginx terbaru, dan meminta alamat IP publik dengan membuka port 8000 dan 8001.

Contoh 2: Membuat grup kontainer dan menjalankan skrip kustom di dalam kontainer.

$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

Perintah ini membuat grup kontainer dan menjalankan skrip kustom di dalam kontainer.

Contoh 3: Membuat grup kontainer run-to-completion

$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

Perintah ini membuat grup kontainer yang mencetak 'halo' dan berhenti.

Contoh 4: Membuat grup kontainer dengan instans kontainer menggunakan image nginx di Azure Container Registry

$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

Perintah ini membuat grup kontainer dengan instans kontainer, yang gambarnya nginx dalam Azure Container Registry.

Contoh 5: Membuat grup kontainer dengan instans kontainer menggunakan image nginx di registri gambar kontainer kustom

$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

Perintah ini membuat grup kontainer dengan instans kontainer, yang gambarnya adalah gambar kustom dari registri gambar kontainer kustom.

Contoh 6: Membuat grup kontainer yang memasang volume File Azure

$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

Perintah ini membuat grup kontainer dengan instans kontainer, yang gambarnya adalah gambar kustom dari registri gambar kontainer kustom.

Contoh 7: Membuat grup kontainer dengan sistem yang ditetapkan dan identitas yang ditetapkan pengguna

$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

Perintah ini membuat grup kontainer dengan sistem yang ditetapkan dan identitas yang ditetapkan pengguna.

Parameter

-AsJob

Jalankan perintah sebagai pekerjaan

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

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

Kontainer dalam grup kontainer. Untuk membuat, lihat bagian CATATAN untuk properti KONTAINER dan buat tabel hash.

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

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

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

Server DNS untuk grup kontainer.

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

Opsi DNS untuk grup kontainer.

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

Domain pencarian DNS untuk pencarian nama host di grup kontainer.

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

Nama kunci enkripsi.

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

Versi kunci enkripsi.

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

Url dasar keyvault.

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

Jenis identitas yang digunakan untuk grup kontainer. Jenis 'SystemAssigned, UserAssigned' mencakup identitas yang dibuat secara implisit dan sekumpulan identitas yang ditetapkan pengguna. Jenis 'None' akan menghapus identitas apa pun dari grup kontainer.

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

Daftar identitas pengguna yang terkait dengan grup kontainer. Referensi kunci kamus identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

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

Kredensial registri gambar tempat grup kontainer dibuat. Untuk membuat, lihat bagian CATATAN untuk properti IMAGEREGISTRYCREDENTIAL dan buat tabel hash.

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

Kontainer init untuk grup kontainer. Untuk membuat, lihat bagian CATATAN untuk properti INITCONTAINER dan buat tabel hash.

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

Label nama dns untuk IP.

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

IP yang terekspos ke internet publik.

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

Daftar port yang terekspos di grup kontainer. Untuk membuat, lihat bagian CATATAN untuk properti IPADDRESSPORT dan buat tabel hash.

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

Menentukan apakah IP terekspos ke internet publik atau VNET pribadi.

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

Lokasi sumber daya.

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

Jenis log yang akan digunakan.

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

Metadata untuk analitik log.

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

Id ruang kerja untuk analitik log

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

Kunci ruang kerja untuk analitik log

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

Id sumber daya ruang kerja untuk analitik log

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

Nama grup kontainer.

Type:String
Aliases:ContainerGroupName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NoWait

Jalankan perintah secara asinkron

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

Jenis sistem operasi yang diperlukan oleh kontainer dalam grup kontainer.

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

Nama grup sumber daya.

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

Kebijakan hidupkan ulang untuk semua kontainer dalam grup kontainer.

  • Always Selalu hidupkan ulang- OnFailure Hidupkan ulang pada kegagalan- Never Jangan pernah memulai ulang
Type:ContainerGroupRestartPolicy
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Sku

SKU untuk grup kontainer.

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

ID sumber daya subnet untuk grup kontainer. Untuk membuat, lihat bagian NOTES untuk properti SUBNETID dan membuat tabel hash.

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

Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.

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

Tag sumber daya.

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

Daftar volume yang dapat dipasang oleh kontainer dalam grup kontainer ini. Untuk membuat, lihat bagian CATATAN untuk properti VOLUME dan membuat tabel hash.

Type:IVolume[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Zona untuk grup kontainer.

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

Output

IContainerGroup

Catatan

ALIAS

PROPERTI PARAMETER KOMPLEKS

Untuk membuat parameter yang dijelaskan di bawah ini, buat tabel hash yang berisi properti yang sesuai. Untuk informasi tentang tabel hash, jalankan Get-Help about_Hash_Tables.

CONTAINER <IContainer[]>: Kontainer dalam grup kontainer.

  • Image <String>: Nama gambar yang digunakan untuk membuat instans kontainer.
  • Name <String>: Nama instans kontainer yang disediakan pengguna.
  • RequestCpu <Double>: Permintaan CPU dari instans kontainer ini.
  • RequestMemoryInGb <Double>: Permintaan memori dalam GB instans kontainer ini.
  • [Command <String[]>]: Perintah untuk dijalankan dalam instans kontainer dalam bentuk exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: Variabel lingkungan yang akan diatur dalam instans kontainer.
    • Name <String>: Nama variabel lingkungan.
    • [SecureValue <String>]: Nilai variabel lingkungan yang aman.
    • [Value <String>]: Nilai variabel lingkungan.
  • [LimitCpu <Double?>]: Batas CPU instans kontainer ini.
  • [LimitMemoryInGb <Double?>]: Batas memori dalam GB instans kontainer ini.
  • [LimitsGpuCount <Int32?>]: Jumlah sumber daya GPU.
  • [LimitsGpuSku <GpuSku?>]: SKU sumber daya GPU.
  • [LivenessProbeExecCommand <String[]>]: Perintah yang akan dijalankan dalam kontainer.
  • [LivenessProbeFailureThreshold <Int32?>]: Ambang kegagalan.
  • [LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]: Header HTTP.
    • [Name <String>]: Nama header.
    • [Value <String>]: Nilai header.
  • [LivenessProbeHttpGetPath <String>]: Jalur ke probe.
  • [LivenessProbeHttpGetPort <Int32?>]: Nomor port untuk pemeriksaan.
  • [LivenessProbeHttpGetScheme <Scheme?>]: Skema.
  • [LivenessProbeInitialDelaySecond <Int32?>]: Detik penundaan awal.
  • [LivenessProbePeriodSecond <Int32?>]: Detik periode.
  • [LivenessProbeSuccessThreshold <Int32?>]: Ambang keberhasilan.
  • [LivenessProbeTimeoutSecond <Int32?>]: Detik waktu habis.
  • [Port <IContainerPort[]>]: Port yang diekspos pada instans kontainer.
    • Port <Int32>: Nomor port yang diekspos dalam grup kontainer.
    • [Protocol <ContainerNetworkProtocol?>]: Protokol yang terkait dengan port.
  • [ReadinessProbeExecCommand <String[]>]: Perintah yang akan dijalankan dalam kontainer.
  • [ReadinessProbeFailureThreshold <Int32?>]: Ambang kegagalan.
  • [ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]: Header HTTP.
  • [ReadinessProbeHttpGetPath <String>]: Jalur ke probe.
  • [ReadinessProbeHttpGetPort <Int32?>]: Nomor port untuk pemeriksaan.
  • [ReadinessProbeHttpGetScheme <Scheme?>]: Skema.
  • [ReadinessProbeInitialDelaySecond <Int32?>]: Detik penundaan awal.
  • [ReadinessProbePeriodSecond <Int32?>]: Detik periode.
  • [ReadinessProbeSuccessThreshold <Int32?>]: Ambang keberhasilan.
  • [ReadinessProbeTimeoutSecond <Int32?>]: Detik waktu habis.
  • [RequestsGpuCount <Int32?>]: Jumlah sumber daya GPU.
  • [RequestsGpuSku <GpuSku?>]: SKU sumber daya GPU.
  • [VolumeMount <IVolumeMount[]>]: Volume dipasang tersedia untuk instans kontainer.
    • MountPath <String>: Jalur dalam kontainer tempat volume harus dipasang. Tidak boleh ada titik dua (:).
    • Name <String>: Nama pemasangan volume.
    • [ReadOnly <Boolean?>]: Bendera yang menunjukkan apakah pemasangan volume bersifat baca-saja.

IMAGEREGISTRYCREDENTIAL <IImageRegistryCredential[]>: Kredensial registri gambar tempat grup kontainer dibuat.

  • Server <String>: Server registri gambar Docker tanpa protokol seperti "http" dan "https".
  • Username <String>: Nama pengguna untuk registri privat.
  • [Identity <String>]: Identitas untuk registri privat.
  • [IdentityUrl <String>]: URL identitas untuk registri privat.
  • [Password <String>]: Kata sandi untuk registri privat.

INITCONTAINER <IInitContainerDefinition[]>: Kontainer init untuk grup kontainer.

  • Name <String>: Nama untuk kontainer init.
  • [Command <String[]>]: Perintah untuk menjalankan dalam kontainer init dalam bentuk exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: Variabel lingkungan yang akan diatur dalam kontainer init.
    • Name <String>: Nama variabel lingkungan.
    • [SecureValue <String>]: Nilai variabel lingkungan yang aman.
    • [Value <String>]: Nilai variabel lingkungan.
  • [Image <String>]: Gambar kontainer init.
  • [VolumeMount <IVolumeMount[]>]: Volume dipasang tersedia untuk kontainer init.
    • MountPath <String>: Jalur dalam kontainer tempat volume harus dipasang. Tidak boleh ada titik dua (:).
    • Name <String>: Nama pemasangan volume.
    • [ReadOnly <Boolean?>]: Bendera yang menunjukkan apakah pemasangan volume bersifat baca-saja.

IPADDRESSPORT <IPort[]>: Daftar port yang terekspos pada grup kontainer.

  • Port1 <Int32>: Nomor port.
  • [Protocol <ContainerGroupNetworkProtocol?>]: Protokol yang terkait dengan port.

SUBNETID <IContainerGroupSubnetId[]>: ID sumber daya subnet untuk grup kontainer.

  • Id <String>: ID sumber daya jaringan virtual dan subnet.
  • [Name <String>]: Nama yang mudah diingat untuk subnet.

VOLUME <IVolume[]>: Daftar volume yang dapat dipasang oleh kontainer dalam grup kontainer ini.

  • Name <String>: Nama volume.
  • [AzureFileReadOnly <Boolean?>]: Bendera yang menunjukkan apakah File Azure yang dibagikan dipasang sebagai volume bersifat baca-saja.
  • [AzureFileShareName <String>]: Nama berbagi File Azure yang akan dipasang sebagai volume.
  • [AzureFileStorageAccountKey <String>]: Kunci akses akun penyimpanan yang digunakan untuk mengakses berbagi File Azure.
  • [AzureFileStorageAccountName <String>]: Nama akun penyimpanan yang berisi berbagi File Azure.
  • [EmptyDir <IVolumeEmptyDir>]: Volume direktori kosong.
    • [(Any) <Object>]: Ini menunjukkan properti apa pun dapat ditambahkan ke objek ini.
  • [GitRepoDirectory <String>]: Nama direktori target. Tidak boleh berisi atau dimulai dengan '..'. Jika '.' disediakan, direktori volume akan menjadi repositori git. Jika tidak, jika ditentukan, volume akan berisi repositori git di subdirektori dengan nama yang diberikan.
  • [GitRepoRepository <String>]: URL Repositori
  • [GitRepoRevision <String>]: Menerapkan hash untuk revisi yang ditentukan.
  • [Secret <ISecretVolume>]: Volume rahasia.
    • [(Any) <String>]: Ini menunjukkan properti apa pun dapat ditambahkan ke objek ini.