New-AzContainerGroup

Sintaxe

CreateExpanded (Predefinição)

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

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

Exemplo 2: Criar grupo de contêineres e executar 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)
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -OsType Linux

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

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

Exemplo 4: Criar um grupo de contentores com uma instância de contentor usando image nginx no 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

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

$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

Exemplo 6: Crie um grupo de contentores que monte o volume de ficheiros do Azure

$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

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 -EnableSystemAssignedIdentity -UserAssignedIdentity "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}"

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

Parâmetros

-AsJob

Executar o comando como um trabalho

Propriedades dos parâmetros

Conjuntos de parâmetros

-ConfidentialComputePropertyCcePolicy

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Container

Os contêineres dentro do grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ContainerGroupProfileId

A id de referência do perfil do grupo de contêineres.Esta será uma id de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroupProfiles/{containerGroupProfileName}'.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ContainerGroupProfileRevision

A revisão de referência de perfil de grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-DnsConfigNameServer

Os servidores DNS para o grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DnsConfigOption

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-DnsConfigSearchDomain

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-EnableSystemAssignedIdentity

Determina se uma identidade atribuída pelo sistema deve ser habilitada para o recurso.

Propriedades dos parâmetros

Conjuntos de parâmetros

-EncryptionPropertyIdentity

A identidade gerenciada do keyvault.

Propriedades dos parâmetros

Conjuntos de parâmetros

-EncryptionPropertyKeyName

O nome da chave de criptografia.

Propriedades dos parâmetros

Conjuntos de parâmetros

-EncryptionPropertyKeyVersion

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-EncryptionPropertyVaultBaseUrl

A url base do keyvault.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Extension

Extensões usadas por Virtual Kubelet

Propriedades dos parâmetros

Conjuntos de parâmetros

-ImageRegistryCredential

As credenciais do registro de imagem a partir das quais o grupo de contêineres é criado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-InitContainer

Os contêineres init para um grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-IPAddressDnsNameLabel

O rótulo de nome Dns para o IP.

Propriedades dos parâmetros

Conjuntos de parâmetros

-IPAddressIP

O IP exposto à internet pública.

Propriedades dos parâmetros

Conjuntos de parâmetros

-IPAddressPort

A lista de portas expostas no grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-IPAddressType

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Propriedades dos parâmetros

Conjuntos de parâmetros

-JsonString

Cadeia de caracteres Json fornecida para a operação Create

Propriedades dos parâmetros

Conjuntos de parâmetros

-Location

A localização do recurso.

Propriedades dos parâmetros

Conjuntos de parâmetros

-LogAnalyticLogType

O tipo de log a ser usado.

Propriedades dos parâmetros

Conjuntos de parâmetros

-LogAnalyticMetadata

Metadados para análise de logs.

Propriedades dos parâmetros

Conjuntos de parâmetros

-LogAnalyticWorkspaceId

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-LogAnalyticWorkspaceKey

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-LogAnalyticWorkspaceResourceId

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

O nome do grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-NoWait

Execute o comando de forma assíncrona

Propriedades dos parâmetros

Conjuntos de parâmetros

-OSType

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Priority

A prioridade do grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ResourceGroupName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Conjuntos de parâmetros

-Sku

A SKU para um grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure

O sinalizador para determinar se o ACI deve falhar na solicitação create se o grupo de contêineres não puder ser obtido do pool em espera.

Propriedades dos parâmetros

Conjuntos de parâmetros

-StandbyPoolProfileId

O id de referência do perfil do pool em espera.Este será um ID de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyPoolName}'.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SubnetId

As IDs de recurso de sub-rede para um grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-SubscriptionId

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Tag

As tags de recurso.

Propriedades dos parâmetros

Conjuntos de parâmetros

-UserAssignedIdentity

A matriz de identidades atribuídas pelo usuário associadas ao recurso. Os elementos no array serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'

Propriedades dos parâmetros

Conjuntos de parâmetros

-Volume

A lista de volumes que podem ser montados por contêineres neste grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Zone

As zonas para o grupo de contêineres.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Saídas

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