New-AzContainerGroup

Modul:

Az.ContainerInstance

Vytvořte nebo aktualizujte skupiny kontejnerů se zadanými konfiguracemi.

Syntaxe

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

Description

Vytvořte nebo aktualizujte skupiny kontejnerů se zadanými konfiguracemi.

Příklady

Příklad 1: Vytvoření skupiny kontejnerů s instancí kontejneru a vyžádání veřejné IP adresy s otevřením portů

$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

Tyto příkazy vytvoří skupinu kontejnerů s instancí kontejneru, jejíž image je nejnovější nginx, a požádá o veřejnou IP adresu s otevřením portu 8000 a 8001.

Příklad 2: Vytvoření skupiny kontejnerů a spuštění vlastního skriptu uvnitř kontejneru

$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

Tyto příkazy vytvoří skupinu kontejnerů a spustí v kontejneru vlastní skript.

Příklad 3: Vytvoření skupiny kontejnerů typu 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

Tyto příkazy vytvoří skupinu kontejnerů, která vytiskne "hello" a zastaví se.

Příklad 4: Vytvoření skupiny kontejnerů s instancí kontejneru pomocí image nginx ve službě 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

Tyto příkazy vytvoří skupinu kontejnerů s instancí kontejneru, jejíž image je nginx ve službě Azure Container Registry.

Příklad 5: Vytvoření skupiny kontejnerů s instancí kontejneru pomocí image nginx ve vlastním registru imagí kontejneru

$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

Tyto příkazy vytvoří skupinu kontejnerů s instancí kontejneru, jejíž image je vlastní image z vlastního registru imagí kontejneru.

Příklad 6: Vytvoření skupiny kontejnerů, která připojí svazek Azure 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

Tyto příkazy vytvoří skupinu kontejnerů s instancí kontejneru, jejíž image je vlastní image z vlastního registru imagí kontejneru.

Příklad 7: Vytvoření skupiny kontejnerů s přiřazenou systémem a identitou přiřazenou uživatelem

$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

Tyto příkazy vytvoří skupinu kontejnerů s přiřazenou systémem a identitou přiřazenou uživatelem.

Parametry

-AsJob

Spuštění příkazu jako úlohy

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Container

Kontejnery ve skupině kontejnerů. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti KONTEJNERu a vytvořte tabulku hash.

Typ:	IContainer[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ContainerGroupProfileId

Referenční id profilu skupiny kontejnerů.Toto bude ID prostředku ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroupProfiles/{containerGroupProfileName}.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ContainerGroupProfileRevision

Referenční revize profilu skupiny kontejnerů.

Typ:	Int32
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DnsConfigNameServer

Servery DNS pro skupinu kontejnerů.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DnsConfigOption

Možnosti DNS pro skupinu kontejnerů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DnsConfigSearchDomain

Domény hledání DNS pro vyhledávání názvů hostitelů ve skupině kontejnerů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EncryptionPropertyKeyName

Název šifrovacího klíče.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EncryptionPropertyKeyVersion

Verze šifrovacího klíče.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-EncryptionPropertyVaultBaseUrl

Základní adresa URL služby keyvault.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IdentityType

Typ identity, který se používá pro skupinu kontejnerů. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity ze skupiny kontejnerů.

Typ:	ResourceIdentityType
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IdentityUserAssignedIdentity

Seznam identit uživatelů přidružených ke skupině kontejnerů. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ImageRegistryCredential

Přihlašovací údaje registru image, ze kterých je skupina kontejnerů vytvořena. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti IMAGEREGISTRYCREDENTIAL a vytvořte tabulku hash.

Typ:	IImageRegistryCredential[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InitContainer

Inicializační kontejnery pro skupinu kontejnerů. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti INITCONTAINER a vytvořte tabulku hash.

Typ:	IInitContainerDefinition[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IPAddressDnsNameLabel

Popisek názvu DNS pro IP adresu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IPAddressIP

IP adresa vystavená veřejnému internetu.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IPAddressPort

Seznam portů vystavených ve skupině kontejnerů. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti IPADDRESSPORT a vytvořte tabulku hash.

Typ:	IPort[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IPAddressType

Určuje, jestli je IP adresa zpřístupněná veřejnému internetu nebo privátní virtuální síti.

Typ:	ContainerGroupIPAddressType
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Location

Umístění prostředku.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LogAnalyticLogType

Typ protokolu, který se má použít.

Typ:	LogAnalyticsLogType
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LogAnalyticMetadata

Metadata pro log analytics

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LogAnalyticWorkspaceId

ID pracovního prostoru pro Log Analytics

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LogAnalyticWorkspaceKey

Klíč pracovního prostoru pro Log Analytics

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-LogAnalyticWorkspaceResourceId

ID prostředku pracovního prostoru pro Log Analytics

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Název skupiny kontejnerů.

Typ:	String
Aliasy:	ContainerGroupName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoWait

Asynchronní spuštění příkazu

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-OSType

Typ operačního systému vyžadovaný kontejnery ve skupině kontejnerů.

Typ:	OperatingSystemTypes
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Priority

Priorita skupiny kontejnerů.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RestartPolicy

Restartujte zásadu pro všechny kontejnery ve skupině kontejnerů.

• Always Vždy restartovat – při selhání OnFailure restartování – Never Nikdy restartovat

Typ:	ContainerGroupRestartPolicy
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Sku

Skladová položka pro skupinu kontejnerů.

Typ:	ContainerGroupSku
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StandbyPoolProfileFailContainerGroupCreateOnReuseFailure

Příznak určující, jestli má ACI selhat požadavek na vytvoření, pokud skupinu kontejnerů nelze získat z pohotovostního fondu.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-StandbyPoolProfileId

Referenční id profilu pohotovostního fondu.Toto bude ID prostředku ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyPoolName}.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubnetId

ID prostředků podsítě pro skupinu kontejnerů. Pokud chcete vytvořit, přečtěte si část NOTES pro vlastnosti SUBNETID a vytvořte tabulku hash.

Typ:	IContainerGroupSubnetId[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SubscriptionId

Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.

Typ:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Tag

Značky prostředků.

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Volume

Seznam svazků, které lze připojit kontejnery v této skupině kontejnerů. Pokud chcete vytvořit, přečtěte si část POZNÁMKY o vlastnostech SVAZKu a vytvořte tabulku hash.

Typ:	IVolume[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Zone

Zóny pro skupinu kontejnerů.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Výstupy

IContainerGroup