New-AzContainerInstanceObject

  • Reference
Module:
Az.ContainerInstance

Create a in-memory object for Container

Syntax

New-AzContainerInstanceObject
   -Image <String>
   -Name <String>
   [-Command <String[]>]
   [-EnvironmentVariable <IEnvironmentVariable[]>]
   [-LimitCpu <Double>]
   [-LimitMemoryInGb <Double>]
   [-LimitsGpuCount <Int32>]
   [-LimitsGpuSku <String>]
   [-LivenessProbeExecCommand <String[]>]
   [-LivenessProbeFailureThreshold <Int32>]
   [-LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]
   [-LivenessProbeHttpGetPath <String>]
   [-LivenessProbeHttpGetPort <Int32>]
   [-LivenessProbeHttpGetScheme <String>]
   [-LivenessProbeInitialDelaySecond <Int32>]
   [-LivenessProbePeriodSecond <Int32>]
   [-LivenessProbeSuccessThreshold <Int32>]
   [-LivenessProbeTimeoutSecond <Int32>]
   [-Port <IContainerPort[]>]
   [-ReadinessProbeExecCommand <String[]>]
   [-ReadinessProbeFailureThreshold <Int32>]
   [-ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]
   [-ReadinessProbeHttpGetPath <String>]
   [-ReadinessProbeHttpGetPort <Int32>]
   [-ReadinessProbeHttpGetScheme <String>]
   [-ReadinessProbeInitialDelaySecond <Int32>]
   [-ReadinessProbePeriodSecond <Int32>]
   [-ReadinessProbeSuccessThreshold <Int32>]
   [-ReadinessProbeTimeoutSecond <Int32>]
   [-RequestCpu <Double>]
   [-RequestMemoryInGb <Double>]
   [-RequestsGpuCount <Int32>]
   [-RequestsGpuSku <String>]
   [-VolumeMount <IVolumeMount[]>]
   [<CommonParameters>]

Description

Create a in-memory object for Container

Examples

Example 1: Create a container instance using image alphine with request cpu 1.0 and request memory 1.5Gb

New-AzContainerInstanceObject -Name "test-container" -Image alpine -RequestCpu 1 -RequestMemoryInGb 1.5

Name
----
test-container

Create a container instance using image alphine with request cpu 1.0 and request memory 1.5Gb

Example 2: Create a container instance using image alphine with limit cpu 2.0 and limit memory 2.5Gb

New-AzContainerInstanceObject -Image alpine -Name "test-container" -LimitCpu 2 -LimitMemoryInGb 2.5

Name
----
test-container

Create a container instance using image alphine with limit cpu 2.0 and limit memory 2.5Gb

Example 3: Create a container group with a container instance

$container = New-AzContainerInstanceObject -Name test-container -Image alpine
New-AzContainerGroup -ResourceGroupName testrg-rg -Name test-cg -Location eastus -Container $container

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

Create a container group with a container instance

Parameters

-Command

The commands to execute within the container instance in exec form.

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

-EnvironmentVariable

The environment variables to set in the container instance. To construct, see NOTES section for ENVIRONMENTVARIABLE properties and create a hash table.

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

-Image

The name of the image used to create the container instance.

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

-LimitCpu

The CPU limit of this container instance.

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

-LimitMemoryInGb

The memory limit in GB of this container instance.

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

-LimitsGpuCount

The count of the GPU resource.

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

-LimitsGpuSku

The SKU of the GPU resource.

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

-LivenessProbeExecCommand

The commands to execute within the container.

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

-LivenessProbeFailureThreshold

The failure threshold.

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

-LivenessProbeHttpGetHttpHeader

The HTTP headers for liveness probe. To construct, see NOTES section for LIVENESSPROBEHTTPGETHTTPHEADER properties and create a hash table.

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

-LivenessProbeHttpGetPath

The path to probe.

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

-LivenessProbeHttpGetPort

The port number to probe.

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

-LivenessProbeHttpGetScheme

The scheme.

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

-LivenessProbeInitialDelaySecond

The initial delay seconds.

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

-LivenessProbePeriodSecond

The period seconds.

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

-LivenessProbeSuccessThreshold

The success threshold.

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

-LivenessProbeTimeoutSecond

The timeout seconds.

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

-Name

The user-provided name of the container instance.

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

-Port

The exposed ports on the container instance. To construct, see NOTES section for PORT properties and create a hash table.

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

-ReadinessProbeExecCommand

The commands to execute within the container.

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

-ReadinessProbeFailureThreshold

The failure threshold.

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

-ReadinessProbeHttpGetHttpHeader

The HTTP headers for readiness probe. To construct, see NOTES section for READINESSPROBEHTTPGETHTTPHEADER properties and create a hash table.

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

-ReadinessProbeHttpGetPath

The path to probe.

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

-ReadinessProbeHttpGetPort

The port number to probe.

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

-ReadinessProbeHttpGetScheme

The scheme.

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

-ReadinessProbeInitialDelaySecond

The initial delay seconds.

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

-ReadinessProbePeriodSecond

The period seconds.

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

-ReadinessProbeSuccessThreshold

The success threshold.

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

-ReadinessProbeTimeoutSecond

The timeout seconds.

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

-RequestCpu

The CPU request of this container instance.

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

-RequestMemoryInGb

The memory request in GB of this container instance.

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

-RequestsGpuCount

The count of the GPU resource.

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

-RequestsGpuSku

The SKU of the GPU resource.

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

-VolumeMount

The volume mounts available to the container instance. To construct, see NOTES section for VOLUMEMOUNT properties and create a hash table.

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

Outputs

Container