New-AzContainerGroup

  • Referencia
Módulo:
Az.ContainerInstance

Cree o actualice grupos de contenedores con configuraciones especificadas.

Syntax

New-AzContainerGroup
   -Name <String>
   -ResourceGroupName <String>
   -Container <IContainer[]>
   -Location <String>
   [-SubscriptionId <String>]
   [-DnsConfigNameServer <String[]>]
   [-DnsConfigOption <String>]
   [-DnsConfigSearchDomain <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-IdentityType <ResourceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-OSType <OperatingSystemTypes>]
   [-Priority <String>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-SubnetId <IContainerGroupSubnetId[]>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Cree o actualice grupos de contenedores con configuraciones especificadas.

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

Estos comandos crean un grupo de contenedores con una instancia de contenedor, cuya imagen es nginx más reciente y solicita una dirección IP pública con el puerto 8000 y 8001.

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

$env1 = New-AzContainerInstanceEnvironmentVariableObject -Name "env1" -Value "value1"
$env2 = New-AzContainerInstanceEnvironmentVariableObject -Name "env2" -SecureValue (ConvertTo-SecureString -String "value2" -AsPlainText -Force)
$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

Estos comandos crean un grupo de contenedores y ejecutan un script personalizado dentro del contenedor.

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

Estos comandos crean un grupo de contenedores que imprime "hello" y se detiene.

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

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

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

Este comando crea un grupo de contenedores con una instancia de contenedor, cuya imagen es nginx en Azure Container Registry.

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

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

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

Estos comandos crean un grupo de contenedores con una instancia de contenedor, cuya imagen es una imagen personalizada a partir de un registro de imágenes de contenedor personalizado.

Ejemplo 6: Creación de un grupo de contenedores que monta el volumen de archivos de Azure

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

Estos comandos crean un grupo de contenedores con una instancia de contenedor, cuya imagen es una imagen personalizada a partir de un registro de imágenes de contenedor personalizado.

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 -IdentityType "SystemAssigned, UserAssigned" -IdentityUserAssignedIdentity @{"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" = @{}}

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

Estos comandos crean un grupo de contenedores con identidad asignada por el sistema y asignada por el usuario.

Parámetros

-AsJob

Ejecución del comando como trabajo

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Contenedores del grupo de contenedores. Para construir, consulte la sección NOTES para propiedades CONTAINER y crear una tabla hash.

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

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsConfigNameServer

Servidores DNS para el grupo de contenedores.

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

-DnsConfigOption

Opciones de DNS para el grupo de contenedores.

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

-DnsConfigSearchDomain

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

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

-EncryptionPropertyKeyName

Nombre de la clave de cifrado.

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

-EncryptionPropertyKeyVersion

Versión de la clave de cifrado.

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

-EncryptionPropertyVaultBaseUrl

Dirección URL base de keyvault.

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

-IdentityType

Tipo de identidad utilizado para el grupo de contenedores. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará las identidades del grupo de contenedores.

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

-IdentityUserAssignedIdentity

Lista de identidades de usuario asociadas con el grupo de contenedores. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

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

-ImageRegistryCredential

Credenciales del registro de imágenes por las que se crea el grupo de contenedores. Para construir, consulte la sección NOTES de las propiedades IMAGEREGISTRYCREDENTIAL y cree una tabla hash.

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

-InitContainer

Contenedores de inicialización de un grupo de contenedores. Para construir, consulte la sección NOTES de las propiedades INITCONTAINER y cree una tabla hash.

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

-IPAddressDnsNameLabel

Etiqueta del nombre DNS para la IP.

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

-IPAddressIP

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

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

-IPAddressPort

Lista de puertos expuestos en el grupo de contenedores. Para construir, consulte la sección NOTES de las propiedades IPADDRESSPORT y cree una tabla hash.

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

-IPAddressType

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

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

-Location

La ubicación del recurso.

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

-LogAnalyticLogType

Tipo de registro que se va a usar.

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

-LogAnalyticMetadata

Metadatos de Log Analytics.

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

-LogAnalyticWorkspaceId

Identificador del área de trabajo de Log Analytics

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

-LogAnalyticWorkspaceKey

Clave del área de trabajo de Log Analytics

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

-LogAnalyticWorkspaceResourceId

Identificador de recurso del área de trabajo para Log Analytics

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

-Name

Nombre del grupo de contenedores.

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

-NoWait

Ejecutar el comando de forma asincrónica

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

-OSType

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

Type:OperatingSystemTypes
Position:Named
Default value:"Linux"
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Priority

Prioridad del grupo de contenedores.

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

-ResourceGroupName

Nombre del grupo de recursos.

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

-RestartPolicy

Directiva de reinicio para todos los contenedores del grupo de contenedores.

  • Always Reiniciar siempre- OnFailure Reiniciar en caso de error- Never No reiniciar nunca
Type:ContainerGroupRestartPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

SKU de un grupo de contenedores.

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

-SubnetId

Identificadores de recursos de subred para un grupo de contenedores. Para construir, vea la sección NOTES para las propiedades DE SUBNETID y crear una tabla hash.

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

-SubscriptionId

Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Etiquetas del recurso.

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

-Volume

Lista de volúmenes que pueden montar los contenedores de este grupo de contenedores. Para construir, consulte la sección NOTES para las propiedades VOLUME y cree una tabla hash.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Zonas para el grupo de contenedores.

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

Salidas

IContainerGroup

Notas

ALIAS

PROPIEDADES DE PARÁMETRO COMPLEJAS

Para crear los parámetros descritos a continuación, cree una tabla hash que contenga las propiedades adecuadas. Para obtener información sobre las tablas hash, ejecute Get-Help about_Hash_Tables.

CONTAINER <IContainer[]>: los contenedores del grupo de contenedores.

  • Image <String>: el nombre de la imagen utilizada para crear la instancia de contenedor.
  • Name <String>: nombre proporcionado por el usuario de la instancia de contenedor.
  • RequestCpu <Double>: solicitud de CPU de esta instancia de contenedor.
  • RequestMemoryInGb <Double>: solicitud de memoria en GB de esta instancia de contenedor.
  • [Command <String[]>]: los comandos que se van a ejecutar dentro de la instancia de contenedor en formato exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: las variables de entorno que se van a establecer en la instancia del contenedor.
    • Name <String>: nombre de la variable de entorno.
    • [SecureValue <String>]: valor de la variable de entorno segura.
    • [Value <String>]: valor de la variable de entorno.
  • [LimitCpu <Double?>]: límite de CPU de esta instancia de contenedor.
  • [LimitMemoryInGb <Double?>]: límite de memoria en GB de esta instancia de contenedor.
  • [LimitsGpuCount <Int32?>]: recuento del recurso de GPU.
  • [LimitsGpuSku <GpuSku?>]: la SKU del recurso de GPU.
  • [LivenessProbeExecCommand <String[]>]: los comandos que se van a ejecutar en el contenedor.
  • [LivenessProbeFailureThreshold <Int32?>]: umbral de error.
  • [LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]: encabezados HTTP.
    • [Name <String>]: nombre del encabezado.
    • [Value <String>]: valor de encabezado.
  • [LivenessProbeHttpGetPath <String>]: ruta de acceso al sondeo.
  • [LivenessProbeHttpGetPort <Int32?>]: número de puerto que se va a sondear.
  • [LivenessProbeHttpGetScheme <Scheme?>]: esquema.
  • [LivenessProbeInitialDelaySecond <Int32?>]: los segundos de retraso inicial.
  • [LivenessProbePeriodSecond <Int32?>]: el período de segundos.
  • [LivenessProbeSuccessThreshold <Int32?>]: umbral de éxito.
  • [LivenessProbeTimeoutSecond <Int32?>]: los segundos de tiempo de espera.
  • [Port <IContainerPort[]>]: los puertos expuestos en la instancia del contenedor.
    • Port <Int32>: número de puerto expuesto en el grupo de contenedores.
    • [Protocol <ContainerNetworkProtocol?>]: el protocolo asociado al puerto.
  • [ReadinessProbeExecCommand <String[]>]: los comandos que se van a ejecutar en el contenedor.
  • [ReadinessProbeFailureThreshold <Int32?>]: umbral de error.
  • [ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]: encabezados HTTP.
  • [ReadinessProbeHttpGetPath <String>]: ruta de acceso al sondeo.
  • [ReadinessProbeHttpGetPort <Int32?>]: número de puerto que se va a sondear.
  • [ReadinessProbeHttpGetScheme <Scheme?>]: esquema.
  • [ReadinessProbeInitialDelaySecond <Int32?>]: los segundos de retraso inicial.
  • [ReadinessProbePeriodSecond <Int32?>]: el período de segundos.
  • [ReadinessProbeSuccessThreshold <Int32?>]: umbral de éxito.
  • [ReadinessProbeTimeoutSecond <Int32?>]: los segundos de tiempo de espera.
  • [RequestsGpuCount <Int32?>]: recuento del recurso de GPU.
  • [RequestsGpuSku <GpuSku?>]: la SKU del recurso de GPU.
  • [VolumeMount <IVolumeMount[]>]: el volumen se monta disponible para la instancia del contenedor.
    • MountPath <String>: ruta de acceso dentro del contenedor donde se debe montar el volumen. No debe contener dos puntos (:).
    • Name <String>: nombre del montaje del volumen.
    • [ReadOnly <Boolean?>]: marca que indica si el montaje del volumen es de solo lectura.

IMAGEREGISTRYCREDENTIAL <IImageRegistryCredential[]>: las credenciales del Registro de imágenes a partir de las que se crea el grupo de contenedores.

  • Server <String>: el servidor del Registro de imágenes de Docker sin un protocolo como "http" y "https".
  • [Identity <String>]: la identidad del registro privado.
  • [IdentityUrl <String>]: la dirección URL de identidad del registro privado.
  • [Password <String>]: la contraseña del registro privado.
  • [Username <String>]: nombre de usuario del registro privado.

INITCONTAINER <IInitContainerDefinition[]>: los contenedores de inicialización de un grupo de contenedores.

  • Name <String>: nombre del contenedor de inicialización.
  • [Command <String[]>]: comando que se va a ejecutar en el contenedor init en formato exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: las variables de entorno que se van a establecer en el contenedor de inicialización.
    • Name <String>: nombre de la variable de entorno.
    • [SecureValue <String>]: valor de la variable de entorno segura.
    • [Value <String>]: valor de la variable de entorno.
  • [Image <String>]: la imagen del contenedor de inicialización.
  • [VolumeMount <IVolumeMount[]>]: el volumen monta los montajes disponibles para el contenedor de inicialización.
    • MountPath <String>: ruta de acceso dentro del contenedor donde se debe montar el volumen. No debe contener dos puntos (:).
    • Name <String>: nombre del montaje del volumen.
    • [ReadOnly <Boolean?>]: marca que indica si el montaje del volumen es de solo lectura.

IPADDRESSPORT <IPort[]>: la lista de puertos expuestos en el grupo de contenedores.

  • Port1 <Int32>: número de puerto.
  • [Protocol <ContainerGroupNetworkProtocol?>]: el protocolo asociado al puerto.

SUBNETID <IContainerGroupSubnetId[]>: identificadores de recursos de subred para un grupo de contenedores.

  • Id <String>: identificador de recurso de la red virtual y la subred.
  • [Name <String>]: nombre descriptivo de la subred.

VOLUME <IVolume[]>: la lista de volúmenes que pueden montar los contenedores de este grupo de contenedores.

  • Name <String>: nombre del volumen.
  • [AzureFileReadOnly <Boolean?>]: marca que indica si el recurso compartido de Archivos de Azure montado como un volumen es de solo lectura.
  • [AzureFileShareName <String>]: el nombre del recurso compartido de archivos de Azure que se va a montar como un volumen.
  • [AzureFileStorageAccountKey <String>]: la clave de acceso de la cuenta de almacenamiento que se usa para acceder al recurso compartido de archivos de Azure.
  • [AzureFileStorageAccountName <String>]: el nombre de la cuenta de almacenamiento que contiene el recurso compartido de archivos de Azure.
  • [EmptyDir <IVolumeEmptyDir>]: volumen de directorio vacío.
    • [(Any) <Object>]: indica que se puede agregar cualquier propiedad a este objeto.
  • [GitRepoDirectory <String>]: nombre del directorio de destino. No debe contener ".." ni empezar así. Si se proporciona ".", el directorio de volumen será el repositorio de GIT. De lo contrario, si se especifica, el volumen contendrá el repositorio de GIT en el subdirectorio con el nombre especificado.
  • [GitRepoRepository <String>]: dirección URL del repositorio
  • [GitRepoRevision <String>]: se confirma el hash de la revisión especificada.
  • [Secret <ISecretVolume>]: el volumen secreto.
    • [(Any) <String>]: indica que se puede agregar cualquier propiedad a este objeto.