New-AzContainerGroup

Sintassi

CreateExpanded (Impostazione predefinita)

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

Descrizione

Esempio

Esempio 1: Creare un gruppo di contenitori con un'istanza del contenitore e richiedere un indirizzo IP pubblico con porte di apertura

$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

Esempio 2: Creare un gruppo di contenitori ed eseguire uno script personalizzato all'interno del contenitore.

$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

Esempio 3: Creare un gruppo di contenitori run-to-completion

$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

Esempio 4: Creare un gruppo di contenitori con un'istanza del contenitore usando image nginx in Registro Azure Container

$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

Esempio 5: Creare un gruppo di contenitori con un'istanza del contenitore usando image nginx nel Registro immagini del contenitore personalizzato

$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

Esempio 6: Creare un gruppo di contenitori che monta Azure volume file

$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

Esempio 7: Creare un gruppo di contenitori con identità assegnata dal sistema e assegnata dall'utente

$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

Parametri

-AsJob

Eseguire il comando come processo

Proprietà dei parametri

Set di parametri

-ConfidentialComputePropertyCcePolicy

Criteri di imposizione del confidential compute codificati in base64

Proprietà dei parametri

Set di parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Set di parametri

-Container

Contenitori all'interno del gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-ContainerGroupProfileId

ID di riferimento del profilo del gruppo di contenitori. Questo sarà un ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroupProfiles/{containerGroupProfileName}'.

Proprietà dei parametri

Set di parametri

-ContainerGroupProfileRevision

Revisione di riferimento del profilo del gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Proprietà dei parametri

Set di parametri

-DnsConfigNameServer

Server DNS per il gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-DnsConfigOption

Opzioni DNS per il gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-DnsConfigSearchDomain

Domini di ricerca DNS per la ricerca del nome host nel gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-EnableSystemAssignedIdentity

Determina se abilitare un'identità assegnata dal sistema per la risorsa.

Proprietà dei parametri

Set di parametri

-EncryptionPropertyIdentity

Identità gestita dell'insieme di credenziali delle chiavi.

Proprietà dei parametri

Set di parametri

-EncryptionPropertyKeyName

Nome della chiave di crittografia.

Proprietà dei parametri

Set di parametri

-EncryptionPropertyKeyVersion

Versione della chiave di crittografia.

Proprietà dei parametri

Set di parametri

-EncryptionPropertyVaultBaseUrl

URL di base dell'insieme di credenziali delle chiavi.

Proprietà dei parametri

Set di parametri

-Extension

estensioni usate da kubelet virtuale

Proprietà dei parametri

Set di parametri

-ImageRegistryCredential

Credenziali del Registro immagini da cui viene creato il gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-InitContainer

Contenitori init per un gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-IPAddressAutoGeneratedDomainNameLabelScope

Valore che rappresenta l'enumerazione di sicurezza. Il valore "Non protetto" è il valore predefinito se non è selezionato e indica che l'etichetta del nome di dominio dell'oggetto non è protetta dall'acquisizione del sottodominio. Il valore "TenantReuse" è il valore predefinito se selezionato e indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso tenant. Il valore "SubscriptionReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno della stessa sottoscrizione. Il valore "ResourceGroupReuse" indica che l'etichetta del nome di dominio dell'oggetto può essere riutilizzata all'interno dello stesso gruppo di risorse. Il valore 'NoReuse' indica che l'etichetta del nome di dominio dell'oggetto non può essere riutilizzata all'interno dello stesso gruppo di risorse, sottoscrizione o tenant.

Proprietà dei parametri

Set di parametri

-IPAddressDnsNameLabel

Etichetta del nome DNS per l'INDIRIZZO IP.

Proprietà dei parametri

Set di parametri

-IPAddressIP

Ip esposto alla rete Internet pubblica.

Proprietà dei parametri

Set di parametri

-IPAddressPort

Elenco di porte esposte nel gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-IPAddressType

Specifica se l'indirizzo IP è esposto alla rete Internet pubblica o alla rete virtuale privata.

Proprietà dei parametri

Set di parametri

-JsonFilePath

Percorso del file JSON fornito all'operazione di creazione

Proprietà dei parametri

Set di parametri

-JsonString

Stringa JSON fornita all'operazione di creazione

Proprietà dei parametri

Set di parametri

-Location

Percorso della risorsa.

Proprietà dei parametri

Set di parametri

-LogAnalyticLogType

Tipo di log da utilizzare.

Proprietà dei parametri

Set di parametri

-LogAnalyticMetadata

Metadati per Log Analytics.

Proprietà dei parametri

Set di parametri

-LogAnalyticWorkspaceId

ID dell'area di lavoro per Log Analytics

Proprietà dei parametri

Set di parametri

-LogAnalyticWorkspaceKey

Chiave dell'area di lavoro per Log Analytics

Proprietà dei parametri

Set di parametri

-LogAnalyticWorkspaceResourceId

ID risorsa dell'area di lavoro per Log Analytics

Proprietà dei parametri

Set di parametri

-Name

Nome del gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-NoWait

Eseguire il comando in modo asincrono

Proprietà dei parametri

Set di parametri

-OSType

Tipo di sistema operativo richiesto dai contenitori nel gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-Priority

Priorità del gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-ResourceGroupName

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

Proprietà dei parametri

Set di parametri

-RestartPolicy

Criteri di riavvio per tutti i contenitori all'interno del gruppo di contenitori.

• Always Riavvio sempre- OnFailure Riavvio in caso di errore- Never Non riavviare mai

Proprietà dei parametri

Set di parametri

-Sku

SKU per un gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure

Flag per determinare se ACI deve non riuscire la richiesta di creazione se il gruppo di contenitori non può essere ottenuto dal pool di standby.

Proprietà dei parametri

Set di parametri

-StandbyPoolProfileId

ID di riferimento del profilo del pool di standby. Questo sarà un ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyPoolName}'.

Proprietà dei parametri

Set di parametri

-SubnetId

ID risorsa subnet per un gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-SubscriptionId

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

Proprietà dei parametri

Set di parametri

-Tag

Tag di risorsa.

Proprietà dei parametri

Set di parametri

-UserAssignedIdentity

Matrice di identità assegnate dall'utente associate alla risorsa. Gli elementi nella matrice saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'

Proprietà dei parametri

Set di parametri

-Volume

Elenco di volumi che possono essere montati da contenitori in questo gruppo di contenitori.

Proprietà dei parametri

Set di parametri

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Set di parametri

-Zone

Zone per il gruppo di contenitori.

Proprietà dei parametri

Set di parametri

CommonParameters

Output

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