New-AzContainerGroup

Riferimento

Modulo:: Az.ContainerInstance

Creare o aggiornare gruppi di contenitori con configurazioni specificate.

Sintassi

New-AzContainerGroup
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Container <IContainer[]>
   -Location <String>
   [-OSType <OperatingSystemTypes>]
   [-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>]
   [-SubnetId <IContainerGroupSubnetId[]>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-Priority <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Creare o aggiornare gruppi di contenitori con configurazioni specificate.

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

Questo comando crea un gruppo di contenitori con un'istanza del contenitore, la cui immagine è la più recente nginx e richiede un indirizzo IP pubblico con la porta 8000 e 8001.

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

$env1 = New-AzContainerInstanceEnvironmentVariableObject -Name "env1" -Value "value1"
$env2 = New-AzContainerInstanceEnvironmentVariableObject -Name "env2" -SecureValue (ConvertTo-SecureString -String "value2" -AsPlainText -Force)
$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

Questo comando crea un gruppo di contenitori ed esegue uno script personalizzato all'interno del contenitore.

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

Questo comando crea un gruppo di contenitori che stampa "hello" e si arresta.

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

$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force) 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

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

Questo comando crea un gruppo di contenitori con un'istanza del contenitore, la cui immagine è nginx in Registro Azure Container.

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

$container = New-AzContainerInstanceObject -Name test-container -Image myserver.com/nginx:latest
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myserver.com" -Username "username" -Password (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force) 
$containerGroup = New-AzContainerGroup -ResourceGroupName test-rg -Name test-cg -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential

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

Questo comando crea un gruppo di contenitori con un'istanza del contenitore, la cui immagine è un'immagine personalizzata da un registro immagini del contenitore personalizzato.

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

$volume = New-AzContainerGroupVolumeObject -Name "myvolume" -AzureFileShareName "myshare" -AzureFileStorageAccountName "username" -AzureFileStorageAccountKey (ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force)
$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

Questo comando crea un gruppo di contenitori con un'istanza del contenitore, la cui immagine è un'immagine personalizzata da un registro immagini del contenitore personalizzato.

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 -IdentityType "SystemAssigned, UserAssigned" -IdentityUserAssignedIdentity @{"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}" = @{}}

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

Questo comando crea un gruppo di contenitori con identità assegnata dal sistema e assegnata dall'utente.

Parametri

-AsJob

Eseguire il comando come processo

Tipo:	SwitchParameter
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

Contenitori all'interno del gruppo di contenitori. Per costruire, vedere la sezione NOTES per le proprietà CONTAINER e creare una tabella hash.

Tipo:	IContainer[]
Position:	Named
valore predefinito:	None
Necessario:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigNameServer

Server DNS per il gruppo di contenitori.

Tipo:	String[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigOption

Opzioni DNS per il gruppo di contenitori.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigSearchDomain

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

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyKeyName

Nome della chiave di crittografia.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyKeyVersion

Versione della chiave di crittografia.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyVaultBaseUrl

URL di base dell'insieme di credenziali delle chiavi.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

Tipo di identità usato per il gruppo di contenitori. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal gruppo di contenitori.

Tipo:	ResourceIdentityType
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

Elenco di identità utente associate al gruppo di contenitori. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Tipo:	Hashtable
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageRegistryCredential

Credenziali del Registro immagini da cui viene creato il gruppo di contenitori. Per costruire, vedere la sezione NOTES per le proprietà IMAGEREGISTRYCREDENTIAL e creare una tabella hash.

Tipo:	IImageRegistryCredential[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InitContainer

Contenitori init per un gruppo di contenitori. Per costruire, vedere la sezione NOTES per le proprietà INITCONTAINER e creare una tabella hash.

Tipo:	IInitContainerDefinition[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressDnsNameLabel

Etichetta del nome DNS per l'INDIRIZZO IP.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressIP

Ip esposto alla rete Internet pubblica.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressPort

Elenco di porte esposte nel gruppo di contenitori. Per costruire, vedere la sezione NOTES per le proprietà IPADDRESSPORT e creare una tabella hash.

Tipo:	IPort[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressType

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

Tipo:	ContainerGroupIPAddressType
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Posizione della risorsa.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticLogType

Tipo di log da utilizzare.

Tipo:	LogAnalyticsLogType
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticMetadata

Metadati per Log Analytics.

Tipo:	Hashtable
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceId

ID dell'area di lavoro per Log Analytics

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceKey

Chiave dell'area di lavoro per Log Analytics

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceResourceId

ID risorsa dell'area di lavoro per Log Analytics

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Nome del gruppo di contenitori.

Tipo:	String
Aliases:	ContainerGroupName
Position:	Named
valore predefinito:	None
Necessario:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Eseguire il comando in modo asincrono

Tipo:	SwitchParameter
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSType

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

Tipo:	OperatingSystemTypes
Position:	Named
valore predefinito:	"Linux"
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Priorità del gruppo di contenitori.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Nome del gruppo di risorse.

Tipo:	String
Position:	Named
valore predefinito:	None
Necessario:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-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

Tipo:	ContainerGroupRestartPolicy
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

SKU per un gruppo di contenitori.

Tipo:	ContainerGroupSku
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

ID risorsa subnet per un gruppo di contenitori. Per costruire, vedere la sezione NOTES per le proprietà SUBNETID e creare una tabella hash.

Tipo:	IContainerGroupSubnetId[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

Tipo:	String
Position:	Named
valore predefinito:	(Get-AzContext).Subscription.Id
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Tag di risorsa.

Tipo:	Hashtable
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Volume

Elenco di volumi che possono essere montati da contenitori in questo gruppo di contenitori. Per costruire, vedere la sezione NOTES per le proprietà volume e creare una tabella hash.

Tipo:	IVolume[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

Zone per il gruppo di contenitori.

Tipo:	String[]
Position:	Named
valore predefinito:	None
Necessario:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Output

IContainerGroup

Condividi tramite