New-AzContainerGroup

Syntaxe

CreateExpanded (Par défaut)

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

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 d’image nginx 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 Azure volume de fichiers

$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 -EnableSystemAssignedIdentity -UserAssignedIdentity "/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

-ConfidentialComputePropertyCcePolicy

Stratégie d’application de calcul confidentielle encodée en base64

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.

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

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

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

-EnableSystemAssignedIdentity

Détermine s’il faut activer une identité affectée par le système pour la ressource.

Propriétés du paramètre

Jeux de paramètres

-EncryptionPropertyIdentity

Identité managée keyvault.

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

-Extension

extensions utilisées par kubelet virtuel

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éé.

Propriétés du paramètre

Jeux de paramètres

-InitContainer

Conteneurs init pour un groupe de conteneurs.

Propriétés du paramètre

Jeux de paramètres

-IPAddressAutoGeneratedDomainNameLabelScope

Valeur représentant l’énumération de sécurité. La valeur « Non sécurisé » est la valeur par défaut si elle n’est pas sélectionnée et signifie que l’étiquette de nom de domaine de l’objet n’est pas sécurisée par rapport à la prise de contrôle de sous-domaine. La valeur « TenantReuse » est la valeur par défaut si elle est sélectionnée et signifie que l’étiquette de nom de domaine de l’objet peut être réutilisée dans le même locataire. La valeur « SubscriptionReuse » signifie que l’étiquette de nom de domaine de l’objet peut être réutilisée dans le même abonnement. La valeur « ResourceGroupReuse » signifie que l’étiquette de nom de domaine de l’objet peut être réutilisée dans le même groupe de ressources. La valeur « NoReuse » signifie que l’étiquette de nom de domaine de l’objet ne peut pas être réutilisée dans le même groupe de ressources, abonnement ou locataire.

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.

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

-JsonFilePath

Chemin d’accès du fichier Json fourni à l’opération Créer

Propriétés du paramètre

Jeux de paramètres

-JsonString

Chaîne Json fournie à l’opération Create

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. Le nom ne respecte pas la casse.

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.

Propriétés du paramètre

Jeux de paramètres

-SubscriptionId

ID de l’abonnement cible. La valeur doit être un UUID.

Propriétés du paramètre

Jeux de paramètres

-Tag

Balises de ressource.

Propriétés du paramètre

Jeux de paramètres

-UserAssignedIdentity

Tableau d’identités affectées par l’utilisateur associées à la ressource. Les éléments du tableau 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

-Volume

Liste des volumes pouvant être montés par des conteneurs dans ce groupe de conteneurs.

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

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