New-AzContainerGroup

Sintaxis

CreateExpanded (valor predeterminado)

New-AzContainerGroup
    -Name <String>
    -ResourceGroupName <String>
    -Container <IContainer[]>
    -Location <String>
    [-SubscriptionId <String>]
    [-OSType <String>]
    [-ConfidentialComputePropertyCcePolicy <String>]
    [-ContainerGroupProfileId <String>]
    [-ContainerGroupProfileRevision <Int32>]
    [-DnsConfigNameServer <String[]>]
    [-DnsConfigOption <String>]
    [-DnsConfigSearchDomain <String>]
    [-EnableSystemAssignedIdentity]
    [-EncryptionPropertyIdentity <String>]
    [-EncryptionPropertyKeyName <String>]
    [-EncryptionPropertyKeyVersion <String>]
    [-EncryptionPropertyVaultBaseUrl <String>]
    [-Extension <IDeploymentExtensionSpec[]>]
    [-IPAddressAutoGeneratedDomainNameLabelScope <String>]
    [-IPAddressDnsNameLabel <String>]
    [-IPAddressIP <String>]
    [-IPAddressPort <IPort[]>]
    [-IPAddressType <String>]
    [-ImageRegistryCredential <IImageRegistryCredential[]>]
    [-InitContainer <IInitContainerDefinition[]>]
    [-LogAnalyticLogType <String>]
    [-LogAnalyticMetadata <Hashtable>]
    [-LogAnalyticWorkspaceId <String>]
    [-LogAnalyticWorkspaceKey <String>]
    [-LogAnalyticWorkspaceResourceId <String>]
    [-RestartPolicy <String>]
    [-Sku <String>]
    [-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure]
    [-StandbyPoolProfileId <String>]
    [-SubnetId <IContainerGroupSubnetId[]>]
    [-Tag <Hashtable>]
    [-UserAssignedIdentity <String[]>]
    [-Volume <IVolume[]>]
    [-Zone <String[]>]
    [-Priority <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzContainerGroup
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzContainerGroup
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1: Creación de un grupo de contenedores con una instancia de contenedor y solicitud de una dirección IP pública con puertos de apertura

$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

Ejemplo 2: Crear un grupo de contenedores y ejecutar un script personalizado dentro del contenedor.

$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)
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux

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

Ejemplo 3: Creación de un grupo de contenedores de ejecución a finalización

$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

Ejemplo 4: Creación de un grupo de contenedores con una instancia de contenedor mediante image nginx en Azure Container Registry

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password $pwd
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

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

Ejemplo 5: Creación de un grupo de contenedores con una instancia de contenedor mediante image nginx en custom container image Registry

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$container = New-AzContainerInstanceObject -Name test-container -Image myserver.com/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myserver.com" -Username "username" -Password $pwd
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

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

Ejemplo 6: Crear un grupo de contenedores que monte Azure volumen de archivos

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$volume = New-AzContainerGroupVolumeObject -Name "myvolume" -AzureFileShareName "myshare" -AzureFileStorageAccountName "username" -AzureFileStorageAccountKey $pwd
$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

Ejemplo 7: Creación de un grupo de contenedores con identidad asignada por el sistema y asignada por el usuario

$container = New-AzContainerInstanceObject -Name test-container -Image alpine
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -EnableSystemAssignedIdentity -UserAssignedIdentity "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}"

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

Parámetros

-AsJob

Ejecución del comando como trabajo

Propiedades de parámetro

Conjuntos de parámetros

-ConfidentialComputePropertyCcePolicy

Directiva de cumplimiento de proceso confidencial codificada en Base64

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Container

Contenedores dentro del grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-ContainerGroupProfileId

Id. de referencia del perfil de grupo de contenedores. Este será un identificador de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroupProfiles/{containerGroupProfileName}'.

Propiedades de parámetro

Conjuntos de parámetros

-ContainerGroupProfileRevision

Revisión de referencia del perfil del grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-DefaultProfile

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

Propiedades de parámetro

Conjuntos de parámetros

-DnsConfigNameServer

Los servidores DNS para el grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-DnsConfigOption

Opciones de DNS para el grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-DnsConfigSearchDomain

Dominios de búsqueda DNS para la búsqueda de nombres de host en el grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-EnableSystemAssignedIdentity

Determina si se va a habilitar una identidad asignada por el sistema para el recurso.

Propiedades de parámetro

Conjuntos de parámetros

-EncryptionPropertyIdentity

Identidad administrada de keyvault.

Propiedades de parámetro

Conjuntos de parámetros

-EncryptionPropertyKeyName

Nombre de clave de cifrado.

Propiedades de parámetro

Conjuntos de parámetros

-EncryptionPropertyKeyVersion

Versión de la clave de cifrado.

Propiedades de parámetro

Conjuntos de parámetros

-EncryptionPropertyVaultBaseUrl

Dirección URL base de keyvault.

Propiedades de parámetro

Conjuntos de parámetros

-Extension

extensiones usadas por kubelet virtual

Propiedades de parámetro

Conjuntos de parámetros

-ImageRegistryCredential

Credenciales del Registro de imágenes a partir de las cuales se crea el grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-InitContainer

Contenedores de inicialización de un grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-IPAddressAutoGeneratedDomainNameLabelScope

Valor que representa la enumeración de seguridad. El valor "No seguro" es el valor predeterminado si no está seleccionado y significa que la etiqueta de nombre de dominio del objeto no está protegida con la adquisición del subdominio. El valor "TenantReuse" es el valor predeterminado si está seleccionado y significa que la etiqueta de nombre de dominio del objeto se puede reutilizar en el mismo inquilino. El valor "SubscriptionReuse" significa que la etiqueta de nombre de dominio del objeto se puede reutilizar dentro de la misma suscripción. El valor "ResourceGroupReuse" significa que la etiqueta de nombre de dominio del objeto se puede reutilizar dentro del mismo grupo de recursos. El valor "NoReuse" significa que la etiqueta de nombre de dominio del objeto no se puede reutilizar dentro del mismo grupo de recursos, suscripción o inquilino.

Propiedades de parámetro

Conjuntos de parámetros

-IPAddressDnsNameLabel

Etiqueta de nombre DNS para la dirección IP.

Propiedades de parámetro

Conjuntos de parámetros

-IPAddressIP

Dirección IP expuesta a la red pública de Internet.

Propiedades de parámetro

Conjuntos de parámetros

-IPAddressPort

Lista de puertos expuestos en el grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-IPAddressType

Especifica si la dirección IP se expone a la red virtual pública de Internet o privada.

Propiedades de parámetro

Conjuntos de parámetros

-JsonFilePath

Ruta de acceso del archivo Json proporcionado a la operación Create

Propiedades de parámetro

Conjuntos de parámetros

-JsonString

Cadena JSON proporcionada a la operación Create

Propiedades de parámetro

Conjuntos de parámetros

-Location

Ubicación del recurso.

Propiedades de parámetro

Conjuntos de parámetros

-LogAnalyticLogType

Tipo de registro que se va a usar.

Propiedades de parámetro

Conjuntos de parámetros

-LogAnalyticMetadata

Metadatos de Log Analytics.

Propiedades de parámetro

Conjuntos de parámetros

-LogAnalyticWorkspaceId

Identificador del área de trabajo para Log Analytics

Propiedades de parámetro

Conjuntos de parámetros

-LogAnalyticWorkspaceKey

La clave del área de trabajo para Log Analytics

Propiedades de parámetro

Conjuntos de parámetros

-LogAnalyticWorkspaceResourceId

Identificador de recurso del área de trabajo para Log Analytics

Propiedades de parámetro

Conjuntos de parámetros

-Name

Nombre del grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-NoWait

Ejecutar el comando de forma asincrónica

Propiedades de parámetro

Conjuntos de parámetros

-OSType

Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-Priority

Prioridad del grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-ResourceGroupName

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

Propiedades de parámetro

Conjuntos de parámetros

-RestartPolicy

Reinicie la directiva para todos los contenedores del grupo de contenedores.

• Always Reiniciar siempre- OnFailure Reiniciar en caso de error- Never No reiniciar nunca

Propiedades de parámetro

Conjuntos de parámetros

-Sku

SKU de un grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure

Marca para determinar si ACI debe producir un error en la solicitud de creación si el grupo de contenedores no se puede obtener del grupo en espera.

Propiedades de parámetro

Conjuntos de parámetros

-StandbyPoolProfileId

Id. de referencia del perfil de grupo en espera. Este será un identificador de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyPoolName}'.

Propiedades de parámetro

Conjuntos de parámetros

-SubnetId

Identificadores de recursos de subred para un grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-SubscriptionId

Identificador de la suscripción de destino. El valor debe ser un UUID.

Propiedades de parámetro

Conjuntos de parámetros

-Tag

Etiquetas de recursos.

Propiedades de parámetro

Conjuntos de parámetros

-UserAssignedIdentity

Matriz de identidades asignadas por el usuario asociadas al recurso. Los elementos de la matriz serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'

Propiedades de parámetro

Conjuntos de parámetros

-Volume

Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Conjuntos de parámetros

-Zone

Zonas para el grupo de contenedores.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Salidas

Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.Models.IContainerGroup