New-AzContainerGroup

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

Syntax

New-AzContainerGroup
   -Name <String>
   -ResourceGroupName <String>
   -Container <IContainer[]>
   -Location <String>
   [-SubscriptionId <String>]
   [-DnsConfigNameServer <String[]>]
   [-DnsConfigOption <String>]
   [-DnsConfigSearchDomain <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-IdentityType <ResourceIdentityType>]
   [-IdentityUserAssignedIdentity <Hashtable>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-OSType <OperatingSystemTypes>]
   [-Priority <String>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-SubnetId <IContainerGroupSubnetId[]>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<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

$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

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

$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

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

$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

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

$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

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-DefaultProfile

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

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

-DnsConfigNameServer

Servery DNS pro skupinu kontejnerů.

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

-DnsConfigOption

Možnosti DNS pro skupinu kontejnerů.

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

-DnsConfigSearchDomain

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

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

-EncryptionPropertyKeyName

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

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

-EncryptionPropertyKeyVersion

Verze šifrovacího klíče.

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

-EncryptionPropertyVaultBaseUrl

Základní adresa URL služby keyvault.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ů.

Type:ResourceIdentityType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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}.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IImageRegistryCredential[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-IPAddressDnsNameLabel

Popisek názvu DNS pro IP adresu.

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

-IPAddressIP

IP adresa vystavená veřejnému internetu.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-IPAddressType

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

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

-Location

Umístění prostředku.

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

-LogAnalyticLogType

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

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

-LogAnalyticMetadata

Metadata pro log analytics

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

-LogAnalyticWorkspaceId

ID pracovního prostoru pro Log Analytics

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

-LogAnalyticWorkspaceKey

Klíč pracovního prostoru pro Log Analytics

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

-LogAnalyticWorkspaceResourceId

ID prostředku pracovního prostoru pro Log Analytics

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

-Name

Název skupiny kontejnerů.

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

-NoWait

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

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

-OSType

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

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

-Priority

Priorita skupiny kontejnerů.

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

-ResourceGroupName

Název skupiny zdrojů.

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

-RestartPolicy

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

  • Always Vždy restartovat – OnFailure Při selhání restartování – Never Nikdy se nerestartuje
Type:ContainerGroupRestartPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

Skladová položka pro skupinu kontejnerů.

Type:ContainerGroupSku
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IContainerGroupSubnetId[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Tag

Značky prostředků.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

-Zone

Zóny pro skupinu kontejnerů.

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

Výstupy

IContainerGroup

Poznámky

ALIASY

KOMPLEXNÍ VLASTNOSTI PARAMETRU

Chcete-li vytvořit parametry popsané níže, vytvořte tabulku hash obsahující příslušné vlastnosti. Informace o tabulkách hash získáte spuštěním rutiny Get-Help about_Hash_Tables.

CONTAINER <IContainer[]>: Kontejnery ve skupině kontejnerů.

  • Image <String>: Název image použité k vytvoření instance kontejneru.
  • Name <String>: Uživatelem zadaný název instance kontejneru.
  • RequestCpu <Double>: Požadavek na procesor této instance kontejneru.
  • RequestMemoryInGb <Double>: Požadavek na paměť v GB této instance kontejneru.
  • [Command <String[]>]: Příkazy, které se mají spustit v instanci kontejneru ve formuláři exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: Proměnné prostředí, které se mají nastavit v instanci kontejneru.
    • Name <String>: Název proměnné prostředí.
    • [SecureValue <String>]: Hodnota proměnné zabezpečeného prostředí.
    • [Value <String>]: Hodnota proměnné prostředí.
  • [LimitCpu <Double?>]: Omezení procesoru této instance kontejneru.
  • [LimitMemoryInGb <Double?>]: Limit paměti v GB této instance kontejneru.
  • [LimitsGpuCount <Int32?>]: Počet prostředků GPU.
  • [LimitsGpuSku <GpuSku?>]: Skladová položka prostředku GPU.
  • [LivenessProbeExecCommand <String[]>]: Příkazy, které se mají spustit v rámci kontejneru.
  • [LivenessProbeFailureThreshold <Int32?>]: Prahová hodnota selhání.
  • [LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]: Hlavičky HTTP.
    • [Name <String>]: Název záhlaví.
    • [Value <String>]: Hodnota záhlaví.
  • [LivenessProbeHttpGetPath <String>]: Cesta k sondě.
  • [LivenessProbeHttpGetPort <Int32?>]: Číslo portu, které se má testovat.
  • [LivenessProbeHttpGetScheme <Scheme?>]: Schéma.
  • [LivenessProbeInitialDelaySecond <Int32?>]: Počáteční prodleva sekund.
  • [LivenessProbePeriodSecond <Int32?>]: Interval sekund.
  • [LivenessProbeSuccessThreshold <Int32?>]: Prahová hodnota úspěchu.
  • [LivenessProbeTimeoutSecond <Int32?>]: Časový limit sekund.
  • [Port <IContainerPort[]>]: Vystavené porty v instanci kontejneru.
    • Port <Int32>: Číslo portu vystavené ve skupině kontejnerů.
    • [Protocol <ContainerNetworkProtocol?>]: Protokol přidružený k portu.
  • [ReadinessProbeExecCommand <String[]>]: Příkazy, které se mají spustit v rámci kontejneru.
  • [ReadinessProbeFailureThreshold <Int32?>]: Prahová hodnota selhání.
  • [ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]: Hlavičky HTTP.
  • [ReadinessProbeHttpGetPath <String>]: Cesta k sondě.
  • [ReadinessProbeHttpGetPort <Int32?>]: Číslo portu, které se má testovat.
  • [ReadinessProbeHttpGetScheme <Scheme?>]: Schéma.
  • [ReadinessProbeInitialDelaySecond <Int32?>]: Počáteční prodleva sekund.
  • [ReadinessProbePeriodSecond <Int32?>]: Interval sekund.
  • [ReadinessProbeSuccessThreshold <Int32?>]: Prahová hodnota úspěchu.
  • [ReadinessProbeTimeoutSecond <Int32?>]: Časový limit sekund.
  • [RequestsGpuCount <Int32?>]: Počet prostředků GPU.
  • [RequestsGpuSku <GpuSku?>]: Skladová položka prostředku GPU.
  • [VolumeMount <IVolumeMount[]>]: Svazek se připojí k instanci kontejneru.
    • MountPath <String>: Cesta v kontejneru, kde se má svazek připojit. Nesmí obsahovat dvojtečku (:).
    • Name <String>: Název připojení svazku.
    • [ReadOnly <Boolean?>]: Příznak označující, jestli je připojení svazku jen pro čtení.

IMAGEREGISTRYCREDENTIAL <IImageRegistryCredential[]>: Přihlašovací údaje registru image, ze kterých je skupina kontejnerů vytvořena.

  • Server <String>: Server registru imagí Dockeru bez protokolu, jako je http a https.
  • [Identity <String>]: Identita privátního registru.
  • [IdentityUrl <String>]: Adresa URL identity pro privátní registr.
  • [Password <String>]: Heslo pro privátní registr.
  • [Username <String>]: Uživatelské jméno pro privátní registr.

INITCONTAINER <IInitContainerDefinition[]>: Inicializační kontejnery pro skupinu kontejnerů.

  • Name <String>: Název inicializačního kontejneru.
  • [Command <String[]>]: Příkaz pro spuštění v inicializačním kontejneru ve formuláři exec.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: Proměnné prostředí, které se mají nastavit v inicializačním kontejneru.
    • Name <String>: Název proměnné prostředí.
    • [SecureValue <String>]: Hodnota proměnné zabezpečeného prostředí.
    • [Value <String>]: Hodnota proměnné prostředí.
  • [Image <String>]: Obrázek inicializačního kontejneru.
  • [VolumeMount <IVolumeMount[]>]: Svazek se připojí k inicializačnímu kontejneru.
    • MountPath <String>: Cesta v kontejneru, kde se má svazek připojit. Nesmí obsahovat dvojtečku (:).
    • Name <String>: Název připojení svazku.
    • [ReadOnly <Boolean?>]: Příznak označující, jestli je připojení svazku jen pro čtení.

IPADDRESSPORT <IPort[]>: Seznam portů vystavených ve skupině kontejnerů.

  • Port1 <Int32>: Číslo portu.
  • [Protocol <ContainerGroupNetworkProtocol?>]: Protokol přidružený k portu.

SUBNETID <IContainerGroupSubnetId[]>: ID prostředků podsítě pro skupinu kontejnerů.

  • Id <String>: ID prostředku virtuální sítě a podsítě.
  • [Name <String>]: Popisný název podsítě.

VOLUME <IVolume[]>: Seznam svazků, které lze připojit kontejnery v této skupině kontejnerů.

  • Name <String>: Název svazku.
  • [AzureFileReadOnly <Boolean?>]: Příznak označující, jestli je sdílený soubor Azure připojený jako svazek jen pro čtení.
  • [AzureFileShareName <String>]: Název sdílené složky Azure, která se má připojit jako svazek.
  • [AzureFileStorageAccountKey <String>]: Přístupový klíč účtu úložiště použitý pro přístup ke sdílené složce Azure.
  • [AzureFileStorageAccountName <String>]: Název účtu úložiště, který obsahuje sdílenou složku Azure.
  • [EmptyDir <IVolumeEmptyDir>]: Prázdný svazek adresáře.
    • [(Any) <Object>]: Označuje, že do tohoto objektu lze přidat libovolnou vlastnost.
  • [GitRepoDirectory <String>]: Název cílového adresáře. Nesmí obsahovat ani začínat na ".". Pokud se zadá ".", adresář svazku bude úložištěm Git. V opačném případě bude svazek obsahovat úložiště Git v podadresáři s daným názvem.
  • [GitRepoRepository <String>]: Adresa URL úložiště
  • [GitRepoRevision <String>]: Hodnota hash potvrzení pro zadanou revizi.
  • [Secret <ISecretVolume>]: Tajný svazek.
    • [(Any) <String>]: Označuje, že do tohoto objektu lze přidat libovolnou vlastnost.