New-AzureRmContainerGroup

  • Referensi
Modul:
AzureRM.ContainerInstance

Membuat grup kontainer.

Penting

Karena modul Az PowerShell sekarang memiliki semua kemampuan modul AzureRM PowerShell dan lebih banyak lagi, kami akan menghentikan modul AzureRM PowerShell pada 29 Februari 2024.

Untuk menghindari gangguan layanan, perbarui skrip Anda yang menggunakan modul AzureRM PowerShell untuk menggunakan modul Az PowerShell paling lambat 29 Februari 2024. Untuk memperbarui skrip Anda secara otomatis, ikuti panduan memulai cepat.

Sintaks

New-AzureRmContainerGroup
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Image] <String>
   [-RegistryCredential <PSCredential>]
   [-Location <String>]
   [-OsType <String>]
   [-RestartPolicy <String>]
   [-Cpu <Int32>]
   [-MemoryInGB <Double>]
   [-IpAddressType <String>]
   [-DnsNameLabel <String>]
   [-Port <Int32[]>]
   [-Command <String>]
   [-EnvironmentVariable <Hashtable>]
   [-RegistryServerDomain <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmContainerGroup
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Image] <String>
   [-RegistryCredential <PSCredential>]
   -AzureFileVolumeShareName <String>
   -AzureFileVolumeAccountCredential <PSCredential>
   -AzureFileVolumeMountPath <String>
   [-Location <String>]
   [-OsType <String>]
   [-RestartPolicy <String>]
   [-Cpu <Int32>]
   [-MemoryInGB <Double>]
   [-IpAddressType <String>]
   [-DnsNameLabel <String>]
   [-Port <Int32[]>]
   [-Command <String>]
   [-EnvironmentVariable <Hashtable>]
   [-RegistryServerDomain <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet New-AzureRmContainerGroup membuat grup kontainer.

Contoh

Contoh 1

PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image nginx -OsType Linux -IpAddressType Public -Port @(8000)

ResourceGroupName        : demo
Id                       : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {8000}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

Perintah ini membuat grup kontainer menggunakan gambar nginx terbaru dan meminta alamat IP publik dengan membuka port 8000.

Contoh 2

PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image alpine -OsType Linux -Command "/bin/sh -c myscript.sh" -EnvironmentVariable @{"env1"="value1";"env2"="value2"}

ResourceGroupName        : demo
Id                       : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                :
Ports                    :
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

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

Contoh 3: Membuat grup kontainer run-to-completion.

PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image alpine -OsType Linux -Command "echo hello" -RestartPolicy Never

ResourceGroupName        : demo
Id                       : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials :
RestartPolicy            :
IpAddress                :
Ports                    :
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

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

Contoh 4: Membuat grup kontainer menggunakan gambar di Azure Container Registry

PS C:\> $secpasswd = ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force
PS C:\> $mycred = New-Object System.Management.Automation.PSCredential ("myacr", $secpasswd)
PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image myacr.azurecr.io/nginx:latest -IpAddressType Public -RegistryCredential $mycred

ResourceGroupName        : demo
Id                       : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials : {myacr}
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {80}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

Perintah ini membuat grup kontainer menggunakan gambar nginx di Azure Container Registry.

Contoh 5: Membuat grup kontainer menggunakan gambar dalam registri gambar kontainer kustom

PS C:\> $secpasswd = ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force
PS C:\> $mycred = New-Object System.Management.Automation.PSCredential ("username", $secpasswd)
PS C:\> New-AzureRmContainerGroup -ResourceGroupName MyResourceGroup -Name MyContainer -Image myserver.com/myimage:latest -RegistryServer myserver.com -RegistryCredential $mycred

ResourceGroupName        : demo
Id                       : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials : {myserver.com}
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {80}
OsType                   : Linux
Volumes                  :
State                    : Running
Events                   : {}

Perintah ini membuat grup kontainer menggunakan gambar kustom dari registri gambar kontainer kustom.

Contoh 6: Membuat grup kontainer yang memasang volume Azure File

PS C:\> $secpasswd = ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force
PS C:\> $mycred = New-Object System.Management.Automation.PSCredential ("username", $secpasswd)
PS C:\> New-AzureRmContainerGroup -ResourceGroupName MyResourceGroup -Name MyContainer -Image alpine -AzureFileVolumeShareName myshare -AzureFileVolumeAccountKey $mycred -AzureFileVolumeMountPath /mnt/azfile

ResourceGroupName        : demo
Id                       : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name                     : mycontainer
Type                     : Microsoft.ContainerInstance/containerGroups
Location                 : westus
Tags                     :
ProvisioningState        : Creating
Containers               : {mycontainer}
ImageRegistryCredentials : {myserver.com}
RestartPolicy            :
IpAddress                : 13.88.10.240
Ports                    : {80}
OsType                   : Linux
Volumes                  : {AzureFile}
State                    : Running
Events                   : {}

Perintah ini membuat grup kontainer yang memasang berbagi File Azure yang disediakan ke /mnt/azfile.

Parameter

-AzureFileVolumeAccountCredential

Kredensial akun penyimpanan berbagi Azure File untuk dipasang di mana nama pengguna adalah nama akun penyimpanan dan kuncinya adalah kunci akun penyimpanan.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AzureFileVolumeMountPath

Jalur pemasangan untuk volume Azure File.

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

Nama berbagi File Azure yang akan dipasang.

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

Perintah untuk dijalankan dalam kontainer.

Type:String
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
-Cpu

Inti CPU yang diperlukan. Default: 1

Type:Nullable<T>[Int32]
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:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DnsNameLabel

Label nama DNS untuk alamat IP.

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

Variabel lingkungan kontainer.

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

Gambar kontainer.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IpAddressType

Jenis alamat IP.

Type:String
Accepted values:Public
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Location

Lokasi grup kontainer. Default ke lokasi grup sumber daya.

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

Memori yang diperlukan dalam GB. Default: 1.5

Type:Nullable<T>[Double]
Aliases:Memory
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Nama grup kontainer.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-OsType

Jenis OS kontainer. Default: Linux

Type:String
Accepted values:Linux, Windows
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Port

Port yang akan dibuka. Default: [80]

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

Kredensial registri kontainer kustom.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RegistryServerDomain

Server login registri kontainer kustom.

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

Nama grup sumber daya.

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

Kebijakan hidupkan ulang kontainer. Default: Selalu

Type:String
Accepted values:Always, Never, OnFailure
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Tag

{{Fill Tag Description}}

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:True
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

Input

String

Hashtable

Output

PSContainerGroup