New-AzContainerGroup

Syntaxe

Default (Par défaut)

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

Description

Exemples

Exemple 1 : Créer un groupe de conteneurs avec une instance de conteneur et demander une adresse IP publique avec des ports ouvrants

$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

Exemple 2 : Créez un groupe de conteneurs et exécutez un script personnalisé à l’intérieur du conteneur.

$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

Exemple 3 : Créer un groupe de conteneurs d’exécution à achèvement

$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

Exemple 4 : Créer un groupe de conteneurs avec une instance de conteneur à l’aide de nginx d’image dans 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

Exemple 5 : Créer un groupe de conteneurs avec une instance de conteneur à l’aide d’image nginx dans le Registre d’images conteneur personnalisées

$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

Exemple 6 : Créer un groupe de conteneurs qui monte un volume de fichiers 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

Exemple 7 : Créer un groupe de conteneurs avec l’identité affectée par le système et l’identité affectée par l’utilisateur

$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

Paramètres

-AsJob

Exécuter la commande en tant que travail

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Container

Conteneurs au sein du groupe de conteneurs. Pour construire, consultez la section NOTES pour les propriétés CONTAINER et créer une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-ContainerGroupProfileId

ID de référence du profil de groupe de conteneurs.Il s’agit d’un ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroupProfiles/{containerGroupProfileName} ».

Propriétés du paramètre

Jeux de paramètres

-ContainerGroupProfileRevision

Révision de référence du profil de groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Propriétés du paramètre

Jeux de paramètres

-DnsConfigNameServer

Serveurs DNS pour le groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-DnsConfigOption

Options DNS pour le groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-DnsConfigSearchDomain

Domaines de recherche DNS pour la recherche de nom d’hôte dans le groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-EncryptionPropertyKeyName

Nom de la clé de chiffrement.

Propriétés du paramètre

Jeux de paramètres

-EncryptionPropertyKeyVersion

Version de la clé de chiffrement.

Propriétés du paramètre

Jeux de paramètres

-EncryptionPropertyVaultBaseUrl

URL de base du coffre de clés.

Propriétés du paramètre

Jeux de paramètres

-IdentityType

Type d’identité utilisé pour le groupe de conteneurs. Le type « SystemAssigned, UserAssigned » inclut à la fois une identité créée implicitement et un ensemble d’identités affectées par l’utilisateur. Le type « None » supprime toutes les identités du groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-IdentityUserAssignedIdentity

Liste des identités utilisateur associées au groupe de conteneurs. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ».

Propriétés du paramètre

Jeux de paramètres

-ImageRegistryCredential

Informations d’identification du Registre d’images à partir desquelles le groupe de conteneurs est créé. Pour construire, consultez la section NOTES pour les propriétés IMAGEREGISTRYCREDENTIAL et créez une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-InitContainer

Conteneurs init pour un groupe de conteneurs. Pour construire, consultez la section NOTES pour les propriétés INITCONTAINER et créez une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-IPAddressDnsNameLabel

Étiquette de nom DNS pour l’adresse IP.

Propriétés du paramètre

Jeux de paramètres

-IPAddressIP

Adresse IP exposée à l’Internet public.

Propriétés du paramètre

Jeux de paramètres

-IPAddressPort

Liste des ports exposés sur le groupe de conteneurs. Pour construire, consultez la section NOTES pour les propriétés IPADDRESSPORT et créer une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-IPAddressType

Spécifie si l’adresse IP est exposée à l’Internet public ou au réseau virtuel privé.

Propriétés du paramètre

Jeux de paramètres

-Location

Emplacement de la ressource.

Propriétés du paramètre

Jeux de paramètres

-LogAnalyticLogType

Type de journal à utiliser.

Propriétés du paramètre

Jeux de paramètres

-LogAnalyticMetadata

Métadonnées pour Log Analytics.

Propriétés du paramètre

Jeux de paramètres

-LogAnalyticWorkspaceId

ID d’espace de travail pour Log Analytics

Propriétés du paramètre

Jeux de paramètres

-LogAnalyticWorkspaceKey

Clé d’espace de travail pour Log Analytics

Propriétés du paramètre

Jeux de paramètres

-LogAnalyticWorkspaceResourceId

ID de ressource de l’espace de travail pour Log Analytics

Propriétés du paramètre

Jeux de paramètres

-Name

Nom du groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-NoWait

Exécuter la commande de manière asynchrone

Propriétés du paramètre

Jeux de paramètres

-OSType

Type de système d’exploitation requis par les conteneurs dans le groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-Priority

Priorité du groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-ResourceGroupName

Nom du groupe de ressources.

Propriétés du paramètre

Jeux de paramètres

-RestartPolicy

Redémarrez la stratégie pour tous les conteneurs au sein du groupe de conteneurs.

• Always Toujours redémarrer - OnFailure Redémarrer en cas d’échec - Never Ne jamais redémarrer

Propriétés du paramètre

Jeux de paramètres

-Sku

Référence SKU d’un groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure

Indicateur pour déterminer si ACI doit échouer la demande de création si le groupe de conteneurs ne peut pas être obtenu à partir du pool de secours.

Propriétés du paramètre

Jeux de paramètres

-StandbyPoolProfileId

ID de référence du profil de pool de secours. Il s’agit d’un ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyPoolName} ».

Propriétés du paramètre

Jeux de paramètres

-SubnetId

ID de ressource de sous-réseau pour un groupe de conteneurs. Pour construire, consultez la section NOTES pour les propriétés SUBNETID et créer une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-SubscriptionId

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.

Propriétés du paramètre

Jeux de paramètres

-Tag

Balises de ressource.

Propriétés du paramètre

Jeux de paramètres

-Volume

Liste des volumes pouvant être montés par des conteneurs dans ce groupe de conteneurs. Pour construire, consultez la section NOTES pour les propriétés VOLUME et créez une table de hachage.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

-Zone

Zones du groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Sorties

IContainerGroup