Partilhar via

New-AzContainerInstanceContainerGroupProfile

Módulo:
Az.ContainerInstance Module

Crie ou atualize perfis de grupo de contêineres com configurações especificadas.

Sintaxe

Default (Padrão) 

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

Descrição

Crie ou atualize perfis de grupo de contêineres com configurações especificadas.

Exemplos

Exemplo 1: Criar um perfil de grupo de contêineres com uma instância de contêiner e solicitar um endereço IP público com portas de abertura

$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 cria um perfil de grupo de contêineres com uma instância de contêiner, cuja imagem é nginx mais recente, e solicita um endereço IP público com abertura das portas 8000 e 8001.

Exemplo 2: Crie um perfil de grupo de contêineres e execute um script personalizado dentro do contêiner.

$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

Este comando cria um perfil de grupo de contêineres e executa um script personalizado dentro do contêiner.

Exemplo 3: Criar um perfil de grupo de contêineres com uma instância de contêiner usando a imagem nginx no Registro de Contêiner do Azure

$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

Este comando cria um perfil de grupo de contêineres com uma instância de contêiner, cuja imagem é nginx no Registro de Contêiner do Azure.

Exemplo 4: Criar um perfil de grupo de contêineres com prioridade Spot e uma instância de contêiner usando a imagem 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

Este comando cria um perfil de grupo de contêiner com prioridade spot e uma instância de contêiner, cuja imagem é nginx.

Parâmetros

-ConfidentialComputePropertyCcePolicy

A política de aplicação de computação confidencial codificada em base64

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Cf.

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Container

Os contêineres dentro do grupo de contêineres. Para construir, consulte a seção NOTAS para propriedades CONTAINER e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:

IContainer[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

O parâmetro DefaultProfile não é funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Propriedades dos parâmetros

Tipo:PSObject
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzureRMContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-EncryptionPropertyIdentity

A identidade gerenciada do keyvault.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-EncryptionPropertyKeyName

O nome da chave de criptografia.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-EncryptionPropertyKeyVersion

A versão da chave de encriptação.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-EncryptionPropertyVaultBaseUrl

A url base do keyvault.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Extension

extensões usadas pelo kubelet virtual Para construir, consulte a seção NOTAS para propriedades EXTENSION e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:

IDeploymentExtensionSpec[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ImageRegistryCredential

As credenciais do registro de imagem a partir das quais o grupo de contêineres é criado. Para construir, consulte a seção NOTAS para propriedades IMAGEREGISTRYCREDENTIAL e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:

IImageRegistryCredential[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-InitContainer

Os contêineres init para um grupo de contêineres. Para construir, consulte a seção NOTAS para propriedades INITCONTAINER e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:

IInitContainerDefinition[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IPAddressAutoGeneratedDomainNameLabelScope

O valor que representa o enum de segurança. O valor 'Unsecure' é o valor padrão se não for selecionado e significa que o rótulo do nome de domínio do objeto não está protegido contra a aquisição do subdomínio. O valor 'TenantReuse' é o valor padrão se selecionado e significa que o rótulo de nome de domínio do objeto pode ser reutilizado dentro do mesmo locatário. O valor 'SubscriptionReuse' significa que o rótulo do nome de domínio do objeto pode ser reutilizado dentro da mesma assinatura. O valor 'ResourceGroupReuse' significa que o rótulo de nome de domínio do objeto pode ser reutilizado dentro do mesmo grupo de recursos. O valor 'NoReuse' significa que o rótulo do nome de domínio do objeto não pode ser reutilizado dentro do mesmo grupo de recursos, assinatura ou locatário.

Propriedades dos parâmetros

Tipo:DnsNameLabelReusePolicy
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IPAddressDnsNameLabel

O rótulo de nome Dns para o IP.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IPAddressIP

O IP exposto à internet pública.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IPAddressPort

A lista de portas expostas no grupo de contêineres. Para construir, consulte a seção NOTAS para propriedades IPADDRESSPORT e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:

IPort[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-IPAddressType

Especifica se o IP está exposto à Internet pública ou à VNET privada.

Propriedades dos parâmetros

Tipo:ContainerGroupIPAddressType
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Location

A localização do recurso.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-LogAnalyticLogType

O tipo de log a ser usado.

Propriedades dos parâmetros

Tipo:LogAnalyticsLogType
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-LogAnalyticMetadata

Metadados para análise de logs.

Propriedades dos parâmetros

Tipo:Hashtable
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-LogAnalyticWorkspaceId

O ID do espaço de trabalho para análise de log

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-LogAnalyticWorkspaceKey

A chave do espaço de trabalho para análise de log

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-LogAnalyticWorkspaceResourceId

A ID do recurso do espaço de trabalho para análise de log

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Name

O nome do perfil do grupo de contêineres.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:ContainerGroupProfileName

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-OSType

O tipo de sistema operacional exigido pelos contêineres no grupo de contêineres.

Propriedades dos parâmetros

Tipo:OperatingSystemTypes
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Priority

A prioridade do grupo de contêineres.

Propriedades dos parâmetros

Tipo:ContainerGroupPriority
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-RestartPolicy

Política de reinicialização para todos os contêineres dentro do grupo de contêineres.

  • Always Sempre reiniciar- OnFailure Reiniciar em caso de falha- Never Nunca reiniciar

Propriedades dos parâmetros

Tipo:ContainerGroupRestartPolicy
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Sku

A SKU para um grupo de contêineres.

Propriedades dos parâmetros

Tipo:ContainerGroupSku
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-SubscriptionId

A ID da assinatura de destino. O valor deve ser um UUID.

Propriedades dos parâmetros

Tipo:String
Valor padrão:(Get-AzContext).Subscription.Id
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Tag

As tags de recurso.

Propriedades dos parâmetros

Tipo:Hashtable
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Volume

A lista de volumes que podem ser montados por contêineres neste grupo de contêineres. Para construir, consulte a seção NOTAS para propriedades VOLUME e crie uma tabela de hash.

Propriedades dos parâmetros

Tipo:

IVolume[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Wi

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-Zone

As zonas para o grupo de contêineres.

Propriedades dos parâmetros

Tipo:

String[]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

IContainerGroupProfile