Partager via

New-AzContainerInstanceContainerGroupProfile

Module:
Az.ContainerInstance Module

Créez ou mettez à jour des profils de groupe de conteneurs avec des configurations spécifiées.

Syntaxe

Default (Par défaut) 

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

Description

Créez ou mettez à jour des profils de groupe de conteneurs avec des configurations spécifiées.

Exemples

Exemple 1 : Créer un profil de 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)
$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

Cette commande crée un profil de groupe de conteneurs avec une instance de conteneur, dont l’image est la plus récente nginx, et demande une adresse IP publique avec le port d’ouverture 8000 et 8001.

Exemple 2 : Créez un profil de 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) -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

Cette commande crée un profil de groupe de conteneurs et exécute un script personnalisé à l’intérieur du conteneur.

Exemple 3 : Créer un profil de 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 -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

Cette commande crée un profil de groupe de conteneurs avec une instance de conteneur, dont l’image est nginx dans Azure Container Registry.

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

Cette commande crée un profil de groupe de conteneurs avec une priorité spot et une instance de conteneur, dont l’image est nginx.

Paramètres

-ConfidentialComputePropertyCcePolicy

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:

IContainer[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:PSObject
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzureRMContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionPropertyIdentity

Identité managée keyvault.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionPropertyKeyName

Nom de la clé de chiffrement.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionPropertyKeyVersion

Version de la clé de chiffrement.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionPropertyVaultBaseUrl

URL de base du coffre de clés.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Extension

extensions utilisées par virtual kubelet To construct, see NOTES section for EXTENSION properties and create a hash table.

Propriétés du paramètre

Type:

IDeploymentExtensionSpec[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:

IImageRegistryCredential[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:

IInitContainerDefinition[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:DnsNameLabelReusePolicy
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IPAddressDnsNameLabel

Étiquette de nom DNS pour l’adresse IP.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IPAddressIP

Adresse IP exposée à l’Internet public.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:

IPort[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:ContainerGroupIPAddressType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Location

Emplacement de la ressource.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogAnalyticLogType

Type de journal à utiliser.

Propriétés du paramètre

Type:LogAnalyticsLogType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogAnalyticMetadata

Métadonnées pour Log Analytics.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogAnalyticWorkspaceId

ID d’espace de travail pour Log Analytics

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogAnalyticWorkspaceKey

Clé d’espace de travail pour Log Analytics

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LogAnalyticWorkspaceResourceId

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Nom du profil de groupe de conteneurs.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:ContainerGroupProfileName

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OSType

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

Propriétés du paramètre

Type:OperatingSystemTypes
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Priority

Priorité du groupe de conteneurs.

Propriétés du paramètre

Type:ContainerGroupPriority
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Nom du groupe de ressources. Le nom ne respecte pas la casse.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:ContainerGroupRestartPolicy
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Sku

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

Propriétés du paramètre

Type:ContainerGroupSku
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SubscriptionId

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

Propriétés du paramètre

Type:String
Valeur par défaut:(Get-AzContext).Subscription.Id
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Tag

Balises de ressource.

Propriétés du paramètre

Type:Hashtable
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:

IVolume[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Zone

Zones du groupe de conteneurs.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

IContainerGroupProfile