New-AzContainerGroup

  • Referência
Módulo:
Az.ContainerInstance

Crie ou atualize grupos de contêineres com configurações 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

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

Exemplos

Exemplo 1: Criar um 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)
$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

Esse comando cria um 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 a abertura das portas 8000 e 8001.

Exemplo 2: Criar grupo de contêineres e executar um script personalizado dentro do contêiner.

$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

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

Exemplo 3: Criar um grupo de contêineres de execução até a conclusão

$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

Esse comando cria um grupo de contêineres que imprime 'olá' e para.

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

$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

Esses comandos criam um grupo de contêiner com uma instância de contêiner, cuja imagem é nginx no Registro de Contêiner do Azure.

Exemplo 5: Criar um grupo de contêineres com uma instância de contêiner usando nginx de imagem no Registro de imagem de contêiner personalizado

$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

Esse comando cria um grupo de contêineres com uma instância de contêiner, cuja imagem é uma imagem personalizada de um registro de imagem de contêiner personalizado.

Exemplo 6: Criar um grupo de contêineres que monta o volume de arquivos do 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

Esse comando cria um grupo de contêineres com uma instância de contêiner, cuja imagem é uma imagem personalizada de um registro de imagem de contêiner personalizado.

Exemplo 7: Criar um grupo de contêineres com o sistema atribuído e a identidade atribuída pelo usuário

$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

Esse comando cria um grupo de contêineres com o sistema atribuído e a identidade atribuída pelo usuário.

Parâmetros

-AsJob

Executar o comando como um trabalho

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

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

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

-DnsConfigNameServer

Os servidores DNS do grupo de contêineres.

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

-DnsConfigOption

As opções de DNS do grupo de contêineres.

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

-DnsConfigSearchDomain

Os domínios de pesquisa de DNS para a pesquisa de nome do host no grupo de contêineres.

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

-EncryptionPropertyKeyName

O nome da chave de criptografia.

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

-EncryptionPropertyKeyVersion

A versão da chave de criptografia.

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

-EncryptionPropertyVaultBaseUrl

A URL base do cofre de chaves.

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

-IdentityType

O tipo de identidade usado para o grupo de contêineres. O tipo "SystemAssigned, UserAssigned" inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo "None" remove todas as identidades do grupo de contêineres.

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

-IdentityUserAssignedIdentity

A lista de identidades de usuário associadas ao grupo de contêineres. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no 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

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

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

-InitContainer

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

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

-IPAddressDnsNameLabel

A etiqueta de nome DNS do IP.

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

-IPAddressIP

O IP exposto à Internet pública.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-IPAddressType

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

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

-Location

A localização do recurso.

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

-LogAnalyticLogType

O tipo de log a ser usado.

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

-LogAnalyticMetadata

Metadados da análise de logs.

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

-LogAnalyticWorkspaceId

A ID do workspace da análise de logs

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

-LogAnalyticWorkspaceKey

A chave do workspace da análise de logs

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

-LogAnalyticWorkspaceResourceId

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

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

-Name

O nome do grupo de contêineres.

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

-NoWait

Execute o comando de forma assíncrona

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

-OSType

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

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

-Priority

A prioridade do Grupo de Contêineres.

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

-ResourceGroupName

O nome do grupo de recursos.

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

-RestartPolicy

A política de reinicialização para todos os contêineres no grupo.

  • Always Sempre reiniciar- OnFailure Reiniciar em caso de falha- Never Nunca reiniciar
Type:ContainerGroupRestartPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

A SKU de um grupo de contêineres.

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

-SubnetId

As IDs de recurso de sub-rede para um grupo de contêineres. Para construir, consulte a seção NOTAS para propriedades SUBNETID e crie uma tabela de hash.

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

-SubscriptionId

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

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

-Tag

As marcas do recurso.

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

-Volume

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

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

-WhatIf

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

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

-Zone

As zonas para o grupo de contêineres.

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

Saídas

IContainerGroup

Observações

ALIASES

PROPRIEDADES DE PARÂMETROS COMPLEXOS

Para criar os parâmetros descritos abaixo, construa uma tabela de hash contendo as propriedades apropriadas. Para obter informações sobre tabelas de hash, execute Get-Help about_Hash_Tables.

CONTAINER <IContainer[]>: Os contêineres dentro do grupo de contêineres.

  • Image <String>: O nome da imagem usada para criar a instância do contêiner.
  • Name <String>: O nome fornecido pelo usuário da instância do contêiner.
  • RequestCpu <Double>: A solicitação de CPU desta instância de contêiner.
  • RequestMemoryInGb <Double>: A solicitação de memória em GB desta instância de contêiner.
  • [Command <String[]>]: Os comandos a serem executados na instância do contêiner no formato exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: As variáveis de ambiente a serem definidas na instância do contêiner.
    • Name <String>: o nome da variável de ambiente.
    • [SecureValue <String>]: O valor da variável de ambiente seguro.
    • [Value <String>]: o valor da variável de ambiente.
  • [LimitCpu <Double?>]: O limite de CPU desta instância de contêiner.
  • [LimitMemoryInGb <Double?>]: O limite de memória em GB desta instância de contêiner.
  • [LimitsGpuCount <Int32?>]: A contagem do recurso GPU.
  • [LimitsGpuSku <GpuSku?>]: A SKU do recurso GPU.
  • [LivenessProbeExecCommand <String[]>]: Os comandos a serem executados dentro do contêiner.
  • [LivenessProbeFailureThreshold <Int32?>]: O limite de falha.
  • [LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]: Os cabeçalhos HTTP.
    • [Name <String>]: O nome do cabeçalho.
    • [Value <String>]: O valor do cabeçalho.
  • [LivenessProbeHttpGetPath <String>]: O caminho para a sondagem.
  • [LivenessProbeHttpGetPort <Int32?>]: O número da porta a ser sondada.
  • [LivenessProbeHttpGetScheme <Scheme?>]: O esquema.
  • [LivenessProbeInitialDelaySecond <Int32?>]: Os segundos de atraso inicial.
  • [LivenessProbePeriodSecond <Int32?>]: O período segundos.
  • [LivenessProbeSuccessThreshold <Int32?>]: O limiar de sucesso.
  • [LivenessProbeTimeoutSecond <Int32?>]: Os segundos de tempo limite.
  • [Port <IContainerPort[]>]: As portas expostas na instância do contêiner.
    • Port <Int32>: O número da porta exposto no grupo de contêineres.
    • [Protocol <ContainerNetworkProtocol?>]: O protocolo associado à porta.
  • [ReadinessProbeExecCommand <String[]>]: Os comandos a serem executados dentro do contêiner.
  • [ReadinessProbeFailureThreshold <Int32?>]: O limite de falha.
  • [ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]: Os cabeçalhos HTTP.
  • [ReadinessProbeHttpGetPath <String>]: O caminho para a sondagem.
  • [ReadinessProbeHttpGetPort <Int32?>]: O número da porta a ser sondada.
  • [ReadinessProbeHttpGetScheme <Scheme?>]: O esquema.
  • [ReadinessProbeInitialDelaySecond <Int32?>]: Os segundos de atraso inicial.
  • [ReadinessProbePeriodSecond <Int32?>]: O período segundos.
  • [ReadinessProbeSuccessThreshold <Int32?>]: O limiar de sucesso.
  • [ReadinessProbeTimeoutSecond <Int32?>]: Os segundos de tempo limite.
  • [RequestsGpuCount <Int32?>]: A contagem do recurso GPU.
  • [RequestsGpuSku <GpuSku?>]: A SKU do recurso GPU.
  • [VolumeMount <IVolumeMount[]>]: O volume é montado disponível para a instância do contêiner.
    • MountPath <String>: O caminho dentro do contêiner onde o volume deve ser montado. Não pode conter dois-pontos (:).
    • Name <String>: O nome da montagem de volume.
    • [ReadOnly <Boolean?>]: O sinalizador que indica se a montagem do volume é somente leitura.

IMAGEREGISTRYCREDENTIAL <IImageRegistryCredential[]>: As credenciais do Registro de imagem pelas quais o grupo de contêineres é criado.

  • Server <String>: O servidor de registro de imagem do Docker sem um protocolo como "http" e "https".
  • [Identity <String>]: A identidade do registro privado.
  • [IdentityUrl <String>]: A URL de identidade do registro privado.
  • [Password <String>]: A senha para o registro privado.
  • [Username <String>]: O nome de usuário do registro privado.

INITCONTAINER <IInitContainerDefinition[]>: Os contêineres de inicialização para um grupo de contêineres.

  • Name <String>: O nome do contêiner init.
  • [Command <String[]>]: O comando a ser executado dentro do contêiner init no formato exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: As variáveis de ambiente a serem definidas no contêiner init.
    • Name <String>: o nome da variável de ambiente.
    • [SecureValue <String>]: O valor da variável de ambiente seguro.
    • [Value <String>]: o valor da variável de ambiente.
  • [Image <String>]: A imagem do contêiner init.
  • [VolumeMount <IVolumeMount[]>]: O volume é montado disponível para o contêiner init.
    • MountPath <String>: O caminho dentro do contêiner onde o volume deve ser montado. Não pode conter dois-pontos (:).
    • Name <String>: O nome da montagem de volume.
    • [ReadOnly <Boolean?>]: O sinalizador que indica se a montagem do volume é somente leitura.

IPADDRESSPORT <IPort[]>: A lista de portas expostas no grupo de contêineres.

  • Port1 <Int32>: O número da porta.
  • [Protocol <ContainerGroupNetworkProtocol?>]: O protocolo associado à porta.

SUBNETID <IContainerGroupSubnetId[]>: As IDs de recurso de sub-rede para um grupo de contêineres.

  • Id <String>: ID do recurso da rede virtual e da sub-rede.
  • [Name <String>]: Nome amigável para a sub-rede.

VOLUME <IVolume[]>: A lista de volumes que podem ser montados por contêineres neste grupo de contêineres.

  • Name <String>: O nome do volume.
  • [AzureFileReadOnly <Boolean?>]: O sinalizador que indica se o Arquivo do Azure compartilhado montado como um volume é somente leitura.
  • [AzureFileShareName <String>]: O nome do compartilhamento de arquivos do Azure a ser montado como um volume.
  • [AzureFileStorageAccountKey <String>]: A chave de acesso da conta de armazenamento usada para acessar o compartilhamento de arquivos do Azure.
  • [AzureFileStorageAccountName <String>]: O nome da conta de armazenamento que contém o compartilhamento de arquivos do Azure.
  • [EmptyDir <IVolumeEmptyDir>]: O volume de diretório vazio.
    • [(Any) <Object>]: Isso indica que qualquer propriedade pode ser adicionada a este objeto.
  • [GitRepoDirectory <String>]: Nome do diretório de destino. Não deve conter ".." nem começar com isso. Se "." for usado, o diretório de volume será o repositório git. Caso contrário, se especificado, o volume conterá o repositório git no subdiretório com o nome indicado.
  • [GitRepoRepository <String>]: URL do repositório
  • [GitRepoRevision <String>]: Confirme o hash para a revisão especificada.
  • [Secret <ISecretVolume>]: O volume secreto.
    • [(Any) <String>]: Isso indica que qualquer propriedade pode ser adicionada a este objeto.