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

New-AzContainerInstanceContainerGroupProfile

参考

模块:: Az.ContainerInstance

创建或更新具有指定配置的容器组配置文件。

语法

New-AzContainerInstanceContainerGroupProfile
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Container <IContainer[]>
   -OSType <OperatingSystemTypes>
   [-ConfidentialComputePropertyCcePolicy <String>]
   [-EncryptionPropertyIdentity <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-Extension <IDeploymentExtensionSpec[]>]
   [-IPAddressAutoGeneratedDomainNameLabelScope <DnsNameLabelReusePolicy>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-Location <String>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-Priority <ContainerGroupPriority>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建或更新具有指定配置的容器组配置文件。

示例

示例 1：使用容器实例创建容器组配置文件，并使用打开端口请求公共 IP 地址

$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)
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

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

此命令使用容器实例创建容器组配置文件，该实例的映像是最新的 nginx，并使用打开端口 8000 和 8001 请求公共 IP 地址。

示例 2：创建容器组配置文件并在容器中运行自定义脚本。

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$env1 = New-AzContainerInstanceEnvironmentVariableObject -Name "env1" -Value "value1"
$env2 = New-AzContainerInstanceEnvironmentVariableObject -Name "env2" -SecureValue $pwd
$container = New-AzContainerInstanceObject -Name test-container -Image alpine -Command "/bin/sh -c myscript.sh" -EnvironmentVariable @($env1, $env2) -RequestCpu 1 -RequestMemoryInGb 1.5
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux

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

此命令将创建容器组配置文件并在容器中运行自定义脚本。

示例 3：在 Azure 容器注册表中使用映像 nginx 创建包含容器实例的容器组配置文件

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest -RequestCpu 1 -RequestMemoryInGb 1.5
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password $pwd
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential -OsType Linux

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

此命令使用容器实例创建容器组配置文件，该实例的映像为 Azure 容器注册表中的 nginx。

示例 4：使用 nginx 映像创建具有现成优先级和容器实例的容器组配置文件

$container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux -RestartPolicy Never -Priority Spot

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

此命令创建具有现成优先级的容器组配置文件和容器实例，其映像为 nginx。

参数

-ConfidentialComputePropertyCcePolicy

base64 编码的机密计算强制策略

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Container

容器组中的容器。若要构造，请参阅 CONTAINER 属性的 NOTES 部分并创建哈希表。

类型:	IContainer[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DefaultProfile

DefaultProfile 参数不起作用。如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionPropertyIdentity

keyvault 托管标识。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionPropertyKeyName

加密密钥名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionPropertyKeyVersion

加密密钥版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EncryptionPropertyVaultBaseUrl

keyvault 基 URL。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Extension

虚拟 kubelet 使用的扩展要构造，请参阅 EXTENSION 属性的 NOTES 部分并创建哈希表。

类型:	IDeploymentExtensionSpec[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageRegistryCredential

从中创建容器组的映像注册表凭据。若要构造，请参阅 IMAGEREGISTRYCREDENTIAL 属性的 NOTES 部分，并创建哈希表。

类型:	IImageRegistryCredential[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InitContainer

容器组的初始化容器。若要构造，请参阅 INITCONTAINER 属性的 NOTES 部分并创建哈希表。

类型:	IInitContainerDefinition[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddressAutoGeneratedDomainNameLabelScope

表示安全枚举的值。如果未选择“不安全”值，则为默认值，表示对象域名标签不受子域接管保护。如果选中“TenantReuse”值，则为默认值，表示可以在同一租户中重复使用对象的域名标签。 “SubscriptionReuse”值表示可以在同一订阅中重复使用对象的域名标签。 “ResourceGroupReuse”值表示可以在同一资源组中重复使用对象的域名标签。 “NoReuse”值表示不能在同一资源组、订阅或租户中重复使用对象的域名标签。

类型:	DnsNameLabelReusePolicy
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddressDnsNameLabel

IP 的 Dns 名称标签。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddressIP

公开给公共 Internet 的 IP。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddressPort

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

类型:	IPort[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddressType

指定 IP 是否向公共 Internet 或专用 VNET 公开。

类型:	ContainerGroupIPAddressType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Location

资源位置。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LogAnalyticLogType

要使用的日志类型。

类型:	LogAnalyticsLogType
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LogAnalyticMetadata

日志分析的元数据。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LogAnalyticWorkspaceId

Log Analytics 的工作区 ID

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LogAnalyticWorkspaceKey

Log Analytics 的工作区密钥

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LogAnalyticWorkspaceResourceId

Log Analytics 的工作区资源 ID

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

容器组配置文件的名称。

类型:	String
别名:	ContainerGroupProfileName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OSType

容器组中容器所需的作系统类型。

类型:	OperatingSystemTypes
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Priority

容器组的优先级。

类型:	ContainerGroupPriority
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

资源组的名称。名称不区分大小写。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-RestartPolicy

重启容器组中所有容器的策略。

Always 始终重启 - OnFailure 失败时重启 - Never 永不重启

类型:	ContainerGroupRestartPolicy
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Sku

容器组的 SKU。

类型:	ContainerGroupSku
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SubscriptionId

目标订阅的 ID。该值必须是 UUID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

资源标记。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Volume

此容器组中的容器可以装载的卷列表。若要构造，请参阅 VOLUME 属性的 NOTES 部分并创建哈希表。

类型:	IVolume[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Zone

容器组的区域。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

IContainerGroupProfile

通过