New-AzContainerGroup

Syntax

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

Beschreibung

Erstellen oder Aktualisieren von Containergruppen mit angegebenen Konfigurationen.

Beispiele

Beispiel 1: Erstellen einer Containergruppe mit einer Containerinstanz und Anfordern einer öffentlichen IP-Adresse mit öffnenden Ports

$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

Mit diesen Befehlen wird eine Containergruppe mit einer Containerinstanz erstellt, deren Image neueste nginx ist, und fordert eine öffentliche IP-Adresse mit dem Öffnen von Port 8000 und 8001 an.

Beispiel 2: Erstellen einer Containergruppe und Ausführen eines benutzerdefinierten Skripts innerhalb des Containers.

$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

Mit diesen Befehlen wird eine Containergruppe erstellt und ein benutzerdefiniertes Skript innerhalb des Containers ausgeführt.

Beispiel 3: Erstellen einer Containergruppe für die Ausführung bis zum Abschluss

$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

Mit diesen Befehlen wird eine Containergruppe erstellt, die "Hello" ausgibt und anhält.

Beispiel 4: Erstellen einer Containergruppe mit einer Containerinstanz mithilfe von Image nginx in 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

Mit diesen Befehlen wird eine Containergruppe mit einer Containerinstanz erstellt, deren Image nginx in azure Container Registry ist.

Beispiel 5: Erstellen einer Containergruppe mit einer Containerinstanz mithilfe von Image-nginx in der benutzerdefinierten Containerimageregistrierung

$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

Mit diesen Befehlen wird eine Containergruppe mit einer Containerinstanz erstellt, deren Image ein benutzerdefiniertes Image aus einer benutzerdefinierten Containerimageregistrierung ist.

Beispiel 6: Erstellen einer Containergruppe, die das Azure File Volume bereitgestellt

$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

Mit diesen Befehlen wird eine Containergruppe mit einer Containerinstanz erstellt, deren Image ein benutzerdefiniertes Image aus einer benutzerdefinierten Containerimageregistrierung ist.

Beispiel 7: Erstellen einer Containergruppe mit zugewiesener System- und Benutzeridentität

$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

Mit diesen Befehlen wird eine Containergruppe mit der vom System zugewiesenen und der Benutzer zugewiesenen Identität erstellt.

Parameter

-AsJob

-Confirm

-Container

-ContainerGroupProfileId

-ContainerGroupProfileRevision

-DefaultProfile

-DnsConfigNameServer

-DnsConfigOption

-DnsConfigSearchDomain

-EncryptionPropertyKeyName

-EncryptionPropertyKeyVersion

-EncryptionPropertyVaultBaseUrl

-IdentityType

-IdentityUserAssignedIdentity

-ImageRegistryCredential

-InitContainer

-IPAddressDnsNameLabel

-IPAddressIP

-IPAddressPort

-IPAddressType

-Location

-LogAnalyticLogType

-LogAnalyticMetadata

-LogAnalyticWorkspaceId

-LogAnalyticWorkspaceKey

-LogAnalyticWorkspaceResourceId

-Name

-NoWait

-OSType

-Priority

-ResourceGroupName

-RestartPolicy

-Sku

-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure

-StandbyPoolProfileId

-SubnetId

-SubscriptionId

-Tag

-Volume

-WhatIf

-Zone

Ausgaben

IContainerGroup