New-AzContainerInstanceContainerGroupProfile
Cree o actualice perfiles de grupo de contenedores con configuraciones especificadas.
Sintaxis
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>]
Description
Cree o actualice perfiles de grupo de contenedores con configuraciones especificadas.
Ejemplos
Ejemplo 1: Creación de un perfil de 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)
$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
Este comando crea un perfil de 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: Creación de un perfil de grupo de contenedores y ejecución de 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) -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
Estos comandos crean un perfil de grupo de contenedores y ejecutan un script personalizado dentro del contenedor.
Ejemplo 3: Creación de un perfil de 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 -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
Estos comandos crean un perfil de grupo de contenedores con una instancia de contenedor, cuya imagen es nginx en Azure Container Registry.
Ejemplo 4: Creación de un perfil de grupo de contenedores con prioridad de acceso puntual y una instancia de contenedor mediante la imagen 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
Estos comandos crean un perfil de grupo de contenedores con prioridad de acceso puntual y una instancia de contenedor, cuya imagen es nginx.
Parámetros
-ConfidentialComputePropertyCcePolicy
Directiva de cumplimiento de proceso confidencial codificada en Base64
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Container
Contenedores dentro del grupo de contenedores. Para construir, consulte la sección NOTES para propiedades CONTAINER y crear una tabla hash.
Tipo: | IContainer[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DefaultProfile
El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.
Tipo: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptionPropertyIdentity
Identidad administrada de keyvault.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptionPropertyKeyName
Nombre de clave de cifrado.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptionPropertyKeyVersion
Versión de la clave de cifrado.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptionPropertyVaultBaseUrl
Dirección URL base de keyvault.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Extension
extensiones usadas por kubelet virtual Para construir, vea la sección NOTES para propiedades EXTENSION y crear una tabla hash.
Tipo: | IDeploymentExtensionSpec[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ImageRegistryCredential
Credenciales del Registro de imágenes a partir de las cuales se crea el grupo de contenedores. Para construir, consulte la sección NOTES de las propiedades IMAGEREGISTRYCREDENTIAL y cree una tabla hash.
Tipo: | IImageRegistryCredential[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | IInitContainerDefinition[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-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.
Tipo: | DnsNameLabelReusePolicy |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-IPAddressDnsNameLabel
Etiqueta de nombre DNS para la dirección IP.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-IPAddressIP
Dirección IP expuesta a la red pública de Internet.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | IPort[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-IPAddressType
Especifica si la dirección IP se expone a la red virtual pública de Internet o privada.
Tipo: | ContainerGroupIPAddressType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Location
Ubicación del recurso.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LogAnalyticLogType
Tipo de registro que se va a usar.
Tipo: | LogAnalyticsLogType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LogAnalyticMetadata
Metadatos de Log Analytics.
Tipo: | Hashtable |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LogAnalyticWorkspaceId
Identificador del área de trabajo para Log Analytics
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LogAnalyticWorkspaceKey
La clave del área de trabajo para Log Analytics
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LogAnalyticWorkspaceResourceId
Identificador de recurso del área de trabajo para Log Analytics
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Nombre del perfil del grupo de contenedores.
Tipo: | String |
Alias: | ContainerGroupProfileName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-OSType
Tipo de sistema operativo requerido por los contenedores del grupo de contenedores.
Tipo: | OperatingSystemTypes |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Priority
Prioridad del grupo de contenedores.
Tipo: | ContainerGroupPriority |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ResourceGroupName
Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RestartPolicy
Reinicie la directiva para todos los contenedores del grupo de contenedores.
-
Always
reiniciar siempreOnFailure
reinicio en caso de error:Never
No reiniciar nunca
Tipo: | ContainerGroupRestartPolicy |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Sku
SKU de un grupo de contenedores.
Tipo: | ContainerGroupSku |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SubscriptionId
Identificador de la suscripción de destino. El valor debe ser un UUID.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | (Get-AzContext).Subscription.Id |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Tag
Etiquetas de recursos.
Tipo: | Hashtable |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | 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.
Tipo: | IVolume[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Zone
Zonas para el grupo de contenedores.
Tipo: | String[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |