New-AzContainerInstanceContainerGroupProfile

Referenz

Modul:: Az.ContainerInstance

Erstellen oder Aktualisieren von Containergruppenprofilen mit angegebenen Konfigurationen.

Syntax

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

Beschreibung

Erstellen oder Aktualisieren von Containergruppenprofilen mit angegebenen Konfigurationen.

Beispiele

Beispiel 1: Erstellen eines Containergruppenprofils 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)
$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

Mit diesen Befehlen wird ein Containergruppenprofil 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 eines Containergruppenprofils 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) -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

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

Beispiel 3: Erstellen eines Containergruppenprofils 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 -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

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

Beispiel 4: Erstellen eines Containergruppenprofils mit Spotpriorität und einer Containerinstanz mit nginx-Image

$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

Mit diesen Befehlen wird ein Containergruppenprofil mit Spotpriorität und einer Containerinstanz erstellt, deren Image nginx ist.

Parameter

-ConfidentialComputePropertyCcePolicy

Die base64-codierte Richtlinie für die Erzwingung vertraulicher Berechnungen

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Container

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

Typ:	IContainer[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:	PSObject
Aliase:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionPropertyIdentity

Die vom Keyvault verwaltete Identität.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionPropertyKeyName

Der Name des Verschlüsselungsschlüssels.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionPropertyKeyVersion

Die Verschlüsselungsschlüsselversion.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionPropertyVaultBaseUrl

Die keyvault-Basis-URL.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Extension

Erweiterungen, die von virtual kubelet To construct verwendet werden, finden Sie im ABSCHNITT NOTES für EXTENSION-Eigenschaften und Erstellen einer Hashtabelle.

Typ:	IDeploymentExtensionSpec[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ImageRegistryCredential

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

Typ:	IImageRegistryCredential[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	IInitContainerDefinition[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IPAddressAutoGeneratedDomainNameLabelScope

Der Wert, der die Sicherheitsenume darstellt. Der Wert "Unsecure" ist der Standardwert, wenn er nicht ausgewählt ist und bedeutet, dass die Domänennamenbezeichnung des Objekts nicht gegen die Unterdomänenübernahme gesichert ist. Der Wert "TenantReuse" ist der Standardwert, wenn er ausgewählt ist und bedeutet, dass die Domänennamenbezeichnung des Objekts innerhalb desselben Mandanten wiederverwendet werden kann. Der Wert "SubscriptionReuse" bedeutet, dass die Domänennamenbezeichnung des Objekts innerhalb desselben Abonnements wiederverwendet werden kann. Der Wert "ResourceGroupReuse" bedeutet, dass die Domänennamenbezeichnung des Objekts innerhalb derselben Ressourcengruppe wiederverwendet werden kann. Der Wert "NoReuse" bedeutet, dass die Domänennamenbezeichnung des Objekts nicht innerhalb derselben Ressourcengruppe, eines Abonnements oder eines Mandanten wiederverwendet werden kann.

Typ:	DnsNameLabelReusePolicy
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IPAddressDnsNameLabel

Die Dns-Namensbezeichnung für die IP.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IPAddressIP

Die IP,die für das öffentliche Internet verfügbar gemacht wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IPAddressPort

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

Typ:	IPort[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-IPAddressType

Gibt an, ob die IP für das öffentliche Internet oder das private VNET verfügbar gemacht wird.

Typ:	ContainerGroupIPAddressType
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Location

Der Ressourcenspeicherort.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LogAnalyticLogType

Der zu verwendende Protokolltyp.

Typ:	LogAnalyticsLogType
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LogAnalyticMetadata

Metadaten für die Protokollanalyse.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LogAnalyticWorkspaceId

Die Arbeitsbereichs-ID für die Protokollanalyse

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LogAnalyticWorkspaceKey

Der Arbeitsbereichsschlüssel für die Protokollanalyse

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-LogAnalyticWorkspaceResourceId

Die Arbeitsbereichsressourcen-ID für die Protokollanalyse

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Der Name des Containergruppenprofils.

Typ:	String
Aliase:	ContainerGroupProfileName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-OSType

Der Betriebssystemtyp, der von den Containern in der Containergruppe benötigt wird.

Typ:	OperatingSystemTypes
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Priority

Die Priorität der Containergruppe.

Typ:	ContainerGroupPriority
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RestartPolicy

Starten Sie die Richtlinie für alle Container innerhalb der Containergruppe neu.

Always Always restart- OnFailure Restart on failure- Never Never restart

Typ:	ContainerGroupRestartPolicy
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Sku

Die SKU für eine Containergruppe.

Typ:	ContainerGroupSku
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SubscriptionId

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

Typ:	String
Position:	Named
Standardwert:	(Get-AzContext).Subscription.Id
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Tag

Die Ressourcentags.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Volume

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

Typ:	IVolume[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

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

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Zone

Die Zonen für die Containergruppe.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Ausgaben

IContainerGroupProfile

Freigeben über