你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzContainerInstanceObject

  • 参考
模块:
Az.ContainerInstance

为容器创建内存中对象

语法

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>]

说明

为容器创建内存中对象

示例

示例 1：使用具有请求 cpu 1.0 和请求内存 1.5Gb 的映像 alphine 创建容器实例

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

Name
----
test-container

使用包含请求 cpu 1.0 和请求内存 1.5Gb 的映像 alphine 创建容器实例

示例 2：使用映像 alphine 创建容器实例，限制 cpu 2.0 并限制内存 2.5Gb

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

Name
----
test-container

使用 cpu 2.0 限制的映像lphine 创建容器实例，并限制内存 2.5Gb

示例 3：使用容器实例创建容器组

$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

使用容器实例创建容器组

参数

-Command

要在容器实例中执行的 exec 形式的命令。

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

-EnvironmentVariable

要在容器实例中设置的环境变量。 若要构造，请参阅 ENVIRONMENTVARIABLE 属性的 NOTES 部分并创建哈希表。

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

-Image

用于创建容器实例的映像的名称。

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

-LimitCpu

此容器实例的 CPU 限制。

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

-LimitMemoryInGb

此容器实例的内存限制 (GB)。

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

-LimitsGpuCount

GPU 资源计数。

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

-LimitsGpuSku

GPU 资源的 SKU。

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

-LivenessProbeExecCommand

要在容器中执行的命令。

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

-LivenessProbeFailureThreshold

失败阈值。

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

-LivenessProbeHttpGetHttpHeader

实时探测的 HTTP 标头。 若要构造，请参阅 LIVENESSPROBEHTTPGETHTTPHEADER 属性的 NOTES 部分，并创建哈希表。

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

-LivenessProbeHttpGetPath

要探测的路径。

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

-LivenessProbeHttpGetPort

要探测的端口号。

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

-LivenessProbeHttpGetScheme

方案。

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

-LivenessProbeInitialDelaySecond

初始延迟秒数。

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

-LivenessProbePeriodSecond

时间段秒数。

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

-LivenessProbeSuccessThreshold

成功阈值。

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

-LivenessProbeTimeoutSecond

超时秒数。

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

-Name

用户提供的容器实例名称。

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

-Port

容器实例上的已公开端口。 若要构造，请参阅 PORT 属性的 NOTES 部分并创建哈希表。

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

-ReadinessProbeExecCommand

要在容器中执行的命令。

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

-ReadinessProbeFailureThreshold

失败阈值。

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

-ReadinessProbeHttpGetHttpHeader

准备情况探测的 HTTP 标头。 若要构造，请参阅 READINESSPROBEHTTPGETHTTPHEADER 属性的 NOTES 部分，并创建哈希表。

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

-ReadinessProbeHttpGetPath

要探测的路径。

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

-ReadinessProbeHttpGetPort

要探测的端口号。

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

-ReadinessProbeHttpGetScheme

方案。

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

-ReadinessProbeInitialDelaySecond

初始延迟秒数。

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

-ReadinessProbePeriodSecond

时间段秒数。

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

-ReadinessProbeSuccessThreshold

成功阈值。

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

-ReadinessProbeTimeoutSecond

超时秒数。

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

-RequestCpu

此容器实例的 CPU 请求。

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

-RequestMemoryInGb

此容器实例的内存请求 (GB)。

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

-RequestsGpuCount

GPU 资源计数。

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

-RequestsGpuSku

GPU 资源的 SKU。

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

-VolumeMount

容器实例可用的卷装入点数。 若要构造，请参阅 VOLUMEMOUNT 属性的 NOTES 部分，并创建哈希表。

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

输出

Container

备注

别名

复杂参数属性

若要创建下面所述的参数，请构造一个包含相应属性的哈希表。 有关哈希表的信息，请运行 Get-Help about_Hash_Tables。

ENVIRONMENTVARIABLE <IEnvironmentVariable[]>：在容器实例中设置的环境变量。

  • Name <String>：环境变量的名称。
  • [SecureValue <String>]：安全环境变量的值。
  • [Value <String>]：环境变量的值。

LIVENESSPROBEHTTPGETHTTPHEADER <IHttpHeader[]>：实时探测的 HTTP 标头。

  • [Name <String>]：标头名称。
  • [Value <String>]：标头值。

PORT <IContainerPort[]>：容器实例上公开的端口。

  • Port <Int32>：容器组中公开的端口号。
  • [Protocol <ContainerNetworkProtocol?>]：与端口关联的协议。

READINESSPROBEHTTPGETHTTPHEADER <IHttpHeader[]>：准备情况探测的 HTTP 标头。

  • [Name <String>]：标头名称。
  • [Value <String>]：标头值。

VOLUMEMOUNT <IVolumeMount[]>：可用于容器实例的卷装载。

  • MountPath <String>：容器中应装载卷的路径。 不得包含冒号 (:)。
  • Name <String>：卷装载的名称。
  • [ReadOnly <Boolean?>]：指示卷装载是否为只读的标志。