New-AzContainerGroup

  • Referens
Modul:
Az.ContainerInstance

Skapa eller uppdatera containergrupper med angivna konfigurationer.

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

Skapa eller uppdatera containergrupper med angivna konfigurationer.

Exempel

Exempel 1: Skapa en containergrupp med en containerinstans och begär en offentlig IP-adress med öppna portar

$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

De här kommandona skapar en containergrupp med en containerinstans, vars avbildning är den senaste nginxen, och begär en offentlig IP-adress med öppningsporten 8000 och 8001.

Exempel 2: Skapa containergrupp och kör ett anpassat skript i containern.

$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

De här kommandona skapar en containergrupp och kör ett anpassat skript i containern.

Exempel 3: Skapa en containergrupp för körning till slutförande

$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

De här kommandona skapar en containergrupp som skriver ut "hello" och stoppar.

Exempel 4: Skapa en containergrupp med en containerinstans med avbildningen nginx i 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

De här kommandona skapar en containergrupp med en containerinstans, vars avbildning är nginx i Azure Container Registry.

Exempel 5: Skapa en containergrupp med en containerinstans med avbildningen nginx i det anpassade containeravbildningsregistret

$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

De här kommandona skapar en containergrupp med en containerinstans, vars avbildning är en anpassad avbildning från ett anpassat containeravbildningsregister.

Exempel 6: Skapa en containergrupp som monterar Azure File-volymen

$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

De här kommandona skapar en containergrupp med en containerinstans, vars avbildning är en anpassad avbildning från ett anpassat containeravbildningsregister.

Exempel 7: Skapa en containergrupp med systemtilldelad och användartilldelad identitet

$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

De här kommandona skapar en containergrupp med systemtilldelad och användartilldelad identitet.

Parametrar

-AsJob

Kör kommandot som ett jobb

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Container

Containrarna i containergruppen. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för CONTAINER-egenskaper och skapa en hash-tabell.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-DnsConfigNameServer

DNS-servrarna för containergruppen.

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

-DnsConfigOption

DNS-alternativen för containergruppen.

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

-DnsConfigSearchDomain

DNS-sökdomänerna för värdnamnsökning i containergruppen.

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

-EncryptionPropertyKeyName

Krypteringsnyckelns namn.

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

-EncryptionPropertyKeyVersion

Krypteringsnyckelversionen.

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

-EncryptionPropertyVaultBaseUrl

Keyvault-bas-URL:en.

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

-IdentityType

Den typ av identitet som används för containergruppen. Typen "SystemAssigned, UserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen "Ingen" tar bort alla identiteter från containergruppen.

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

-IdentityUserAssignedIdentity

Listan över användaridentiteter som är associerade med containergruppen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/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

Autentiseringsuppgifterna för avbildningsregistret som containergruppen skapas från. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för IMAGEREGISTRYCREDENTIAL-egenskaper och skapa en hash-tabell.

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

-InitContainer

Init-containrarna för en containergrupp. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för INITCONTAINER-egenskaper och skapa en hash-tabell.

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

-IPAddressDnsNameLabel

Dns-namnetiketten för IP-adressen.

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

-IPAddressIP

IP-adressen som exponeras för det offentliga Internet.

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

-IPAddressPort

Listan över portar som exponeras i containergruppen. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för IPADDRESSPORT-egenskaper och skapa en hash-tabell.

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

-IPAddressType

Anger om IP-adressen exponeras för det offentliga internet eller det privata virtuella nätverket.

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

-Location

Resursplatsen.

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

-LogAnalyticLogType

Den loggtyp som ska användas.

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

-LogAnalyticMetadata

Metadata för log analytics.

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

-LogAnalyticWorkspaceId

Arbetsytans ID för log analytics

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

-LogAnalyticWorkspaceKey

Arbetsytenyckeln för log analytics

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

-LogAnalyticWorkspaceResourceId

Arbetsytans resurs-ID för log analytics

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

-Name

Namnet på containergruppen.

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

-NoWait

Kör kommandot asynkront

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

-OSType

Den operativsystemtyp som krävs av containrarna i containergruppen.

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

-Priority

Prioriteten för containergruppen.

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

-ResourceGroupName

Namnet på resursgruppen.

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

-RestartPolicy

Starta om principen för alla containrar i containergruppen.

  • Always Starta alltid om – OnFailure Starta om vid fel – Never Starta aldrig om
Type:ContainerGroupRestartPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

SKU:n för en containergrupp.

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

-SubnetId

Resurs-ID:t för undernätet för en containergrupp. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för SUBNETID-egenskaper och skapa en hash-tabell.

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

-SubscriptionId

Prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

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

-Tag

Resurstaggar.

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

-Volume

Listan över volymer som kan monteras av containrar i den här containergruppen. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för VOLYMegenskaper och skapa en hash-tabell.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

-Zone

Zonerna för containergruppen.

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

Utdata

IContainerGroup

Kommentarer

ALIAS

EGENSKAPER FÖR KOMPLEXA PARAMETRAR

Skapa parametrarna som beskrivs nedan genom att skapa en hash-tabell som innehåller lämpliga egenskaper. Information om hash-tabeller finns i Get-Help about_Hash_Tables.

CONTAINER <IContainer[]>: Containrarna i containergruppen.

  • Image <String>: Namnet på avbildningen som används för att skapa containerinstansen.
  • Name <String>: Namnet på containerinstansen som tillhandahålls av användaren.
  • RequestCpu <Double>: CPU-begäran för den här containerinstansen.
  • RequestMemoryInGb <Double>: Minnesbegäran i GB för den här containerinstansen.
  • [Command <String[]>]: Kommandona som ska köras i containerinstansen i exec-form.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: Miljövariablerna som ska anges i containerinstansen.
    • Name <String>: Namnet på miljövariabeln.
    • [SecureValue <String>]: Värdet för variabeln för säker miljö.
    • [Value <String>]: Värdet för miljövariabeln.
  • [LimitCpu <Double?>]: CPU-gränsen för den här containerinstansen.
  • [LimitMemoryInGb <Double?>]: Minnesgränsen i GB för den här containerinstansen.
  • [LimitsGpuCount <Int32?>]: Antalet GPU-resursen.
  • [LimitsGpuSku <GpuSku?>]: SKU:n för GPU-resursen.
  • [LivenessProbeExecCommand <String[]>]: Kommandona som ska köras i containern.
  • [LivenessProbeFailureThreshold <Int32?>]: Tröskelvärdet för fel.
  • [LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]: HTTP-huvudena.
    • [Name <String>]: Rubriknamnet.
    • [Value <String>]: Rubrikvärdet.
  • [LivenessProbeHttpGetPath <String>]: Sökvägen till avsökningen.
  • [LivenessProbeHttpGetPort <Int32?>]: Portnumret som ska avsökas.
  • [LivenessProbeHttpGetScheme <Scheme?>]: Schemat.
  • [LivenessProbeInitialDelaySecond <Int32?>]: Den inledande fördröjningen sekunder.
  • [LivenessProbePeriodSecond <Int32?>]: Periodsekunderna.
  • [LivenessProbeSuccessThreshold <Int32?>]: Tröskelvärdet för framgång.
  • [LivenessProbeTimeoutSecond <Int32?>]: Tidsgränsen sekunder.
  • [Port <IContainerPort[]>]: De portar som exponeras på containerinstansen.
    • Port <Int32>: Portnumret som exponeras i containergruppen.
    • [Protocol <ContainerNetworkProtocol?>]: Protokollet som är associerat med porten.
  • [ReadinessProbeExecCommand <String[]>]: Kommandona som ska köras i containern.
  • [ReadinessProbeFailureThreshold <Int32?>]: Tröskelvärdet för fel.
  • [ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]: HTTP-huvudena.
  • [ReadinessProbeHttpGetPath <String>]: Sökvägen till avsökningen.
  • [ReadinessProbeHttpGetPort <Int32?>]: Portnumret som ska avsökas.
  • [ReadinessProbeHttpGetScheme <Scheme?>]: Schemat.
  • [ReadinessProbeInitialDelaySecond <Int32?>]: Den inledande fördröjningen sekunder.
  • [ReadinessProbePeriodSecond <Int32?>]: Periodsekunderna.
  • [ReadinessProbeSuccessThreshold <Int32?>]: Tröskelvärdet för framgång.
  • [ReadinessProbeTimeoutSecond <Int32?>]: Tidsgränsen sekunder.
  • [RequestsGpuCount <Int32?>]: Antalet GPU-resursen.
  • [RequestsGpuSku <GpuSku?>]: SKU:n för GPU-resursen.
  • [VolumeMount <IVolumeMount[]>]: Volymen monteras som är tillgänglig för containerinstansen.
    • MountPath <String>: Sökvägen i containern där volymen ska monteras. Får inte innehålla kolon (:).
    • Name <String>: Namnet på volymmonteringen.
    • [ReadOnly <Boolean?>]: Flaggan som anger om volymmonteringen är skrivskyddad.

IMAGEREGISTRYCREDENTIAL <IImageRegistryCredential[]>: Autentiseringsuppgifterna för avbildningsregistret som containergruppen skapas från.

  • Server <String>: Docker-avbildningsregisterservern utan protokoll som "http" och "https".
  • [Identity <String>]: Identiteten för det privata registret.
  • [IdentityUrl <String>]: Identitets-URL:en för det privata registret.
  • [Password <String>]: Lösenordet för det privata registret.
  • [Username <String>]: Användarnamnet för det privata registret.

INITCONTAINER <IInitContainerDefinition[]>: Init-containrarna för en containergrupp.

  • Name <String>: Namnet på init-containern.
  • [Command <String[]>]: Kommandot som ska köras i init-containern i exec-form.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: Miljövariablerna som ska anges i init-containern.
    • Name <String>: Namnet på miljövariabeln.
    • [SecureValue <String>]: Värdet för variabeln för säker miljö.
    • [Value <String>]: Värdet för miljövariabeln.
  • [Image <String>]: Avbildningen av init-containern.
  • [VolumeMount <IVolumeMount[]>]: Volymen monteras som är tillgänglig för init-containern.
    • MountPath <String>: Sökvägen i containern där volymen ska monteras. Får inte innehålla kolon (:).
    • Name <String>: Namnet på volymmonteringen.
    • [ReadOnly <Boolean?>]: Flaggan som anger om volymmonteringen är skrivskyddad.

IPADDRESSPORT <IPort[]>: Listan över portar som exponeras i containergruppen.

  • Port1 <Int32>: Portnumret.
  • [Protocol <ContainerGroupNetworkProtocol?>]: Protokollet som är associerat med porten.

SUBNETID <IContainerGroupSubnetId[]>: Resurs-ID:t för undernätet för en containergrupp.

  • Id <String>: Resurs-ID för virtuellt nätverk och undernät.
  • [Name <String>]: Eget namn för undernätet.

VOLUME <IVolume[]>: Listan över volymer som kan monteras av containrar i den här containergruppen.

  • Name <String>: Namnet på volymen.
  • [AzureFileReadOnly <Boolean?>]: Flaggan som anger om Den delade Azure-filen som är monterad som en volym är skrivskyddad.
  • [AzureFileShareName <String>]: Namnet på den Azure-filresurs som ska monteras som en volym.
  • [AzureFileStorageAccountKey <String>]: Åtkomstnyckeln för lagringskontot som används för att komma åt Azure-filresursen.
  • [AzureFileStorageAccountName <String>]: Namnet på lagringskontot som innehåller Azure-filresursen.
  • [EmptyDir <IVolumeEmptyDir>]: Den tomma katalogvolymen.
    • [(Any) <Object>]: Detta anger att alla egenskaper kan läggas till i det här objektet.
  • [GitRepoDirectory <String>]: Namn på målkatalog. Får inte innehålla eller börja med ... Om "." anges blir volymkatalogen git-lagringsplatsen. Om detta anges innehåller volymen git-lagringsplatsen i underkatalogen med det angivna namnet.
  • [GitRepoRepository <String>]: Url för lagringsplats
  • [GitRepoRevision <String>]: Checka in hash för den angivna revisionen.
  • [Secret <ISecretVolume>]: Den hemliga volymen.
    • [(Any) <String>]: Detta anger att alla egenskaper kan läggas till i det här objektet.