New-AzContainerGroup

Referenz

Modul:: Az.ContainerInstance

Erstellen oder Aktualisieren von Containergruppen mit angegebenen Konfigurationen.

Syntax

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

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.

$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

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

$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

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

$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

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

$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

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

Ausführen des Befehls als Auftrag

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

Die Container innerhalb der Containergruppe. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für CONTAINER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IContainer[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigNameServer

Die DNS-Server für die Containergruppe.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigOption

Die DNS-Optionen für die Containergruppe.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsConfigSearchDomain

Die DNS-Suchdomänen für das Nachschlagen von Hostnamen in der Containergruppe.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyKeyName

Der Name des Verschlüsselungsschlüssels

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyKeyVersion

Die Version des Verschlüsselungsschlüssels

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionPropertyVaultBaseUrl

Die Basis-URL für den Schlüsseltresor.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

Der für die Containergruppe verwendete Identitätstyp. Der Typ „SystemAssigned, UserAssigned“ umfasst sowohl eine implizit erstellte Identität als auch einen Satz von Benutzern zugewiesener Identitäten. Der Typ „None“ entfernt alle Identitäten aus der Containergruppe.

Type:	ResourceIdentityType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityUserAssignedIdentity

Die Liste der der Containergruppe zugeordneten Benutzeridentitäten. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageRegistryCredential

Die Anmeldeinformationen für die Imageregistrierung, mit denen die Containergruppe erstellt wird. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für IMAGEREGISTRYCREDENTIAL-Eigenschaften und erstellen eine Hashtabelle.

Type:	IImageRegistryCredential[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InitContainer

Die Init-Container für eine Containergruppe Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für INITCONTAINER-Eigenschaften und erstellen eine Hashtabelle.

Type:	IInitContainerDefinition[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressDnsNameLabel

Die DNS-Namensbezeichnung für die IP-Adresse.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressIP

Die dem öffentlichen Internet verfügbar gemachte IP-Adresse.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressPort

Die Liste der in der Containergruppe verfügbar gemachten Ports. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für IPADDRESSPORT-Eigenschaften und erstellen eine Hashtabelle.

Type:	IPort[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPAddressType

Gibt an, ob die IP dem öffentlichen Internet oder dem privaten VNET verfügbar gemacht ist.

Type:	ContainerGroupIPAddressType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Den Ressourcenstandort.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticLogType

Der zu verwendende Protokolltyp.

Type:	LogAnalyticsLogType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticMetadata

Metadaten für Log Analytics.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceId

Die Arbeitsbereichs-ID für Log Analytics.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceKey

Der Arbeitsbereichsschlüssel für Log Analytics.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogAnalyticWorkspaceResourceId

Die Arbeitsbereichsressourcen-ID für die Protokollanalyse

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Der Name der Containergruppe.

Type:	String
Aliases:	ContainerGroupName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Asynchrones Ausführen des Befehls

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSType

Der für die Container in der Containergruppe erforderliche Betriebssystemtyp.

Type:	OperatingSystemTypes
Position:	Named
Default value:	"Linux"
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Die Priorität der Containergruppe.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RestartPolicy

Neustartrichtlinie für alle Container innerhalb der Containergruppe.

Always Always restart- Restart on failure- OnFailureNever Never restart

Type:	ContainerGroupRestartPolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Sku

Die SKU für eine Containergruppe.

Type:	ContainerGroupSku
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

Die Subnetzressourcen-IDs für eine Containergruppe. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für SUBNETZID-Eigenschaften und erstellen eine Hashtabelle.

Type:	IContainerGroupSubnetId[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Die Ressourcentags.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Volume

Die Liste der Volumes, die von Containern in dieser Containergruppe eingebunden werden können. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für VOLUME-Eigenschaften und erstellen eine Hashtabelle.

Type:	IVolume[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Zone

Die Zonen für die Containergruppe.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Ausgaben

IContainerGroup

Share via