New-AzContainerGroup

  • Referentie
Module:
Az.ContainerInstance

Containergroepen met opgegeven configuraties maken of bijwerken.

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

Containergroepen met opgegeven configuraties maken of bijwerken.

Voorbeelden

Voorbeeld 1: Maak een containergroep met een containerinstantie en vraag een openbaar IP-adres aan met poorten openen

$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

Met deze opdrachten maakt u een containergroep met een containerinstantie waarvan de installatiekopie de meest recente nginx is en vraagt u een openbaar IP-adres aan met poort 8000 en 8001.

Voorbeeld 2: Een containergroep maken en een aangepast script uitvoeren in de container.

$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

Met deze opdrachten maakt u een containergroep en voert u een aangepast script uit in de container.

Voorbeeld 3: Een containergroep voor uitvoeren tot voltooiing maken

$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

Met deze opdrachten maakt u een containergroep die 'hallo' afdrukt en stopt.

Voorbeeld 4: Een containergroep maken met een containerinstantie met behulp van installatiekopieën 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

Met deze opdrachten maakt u een containergroep met een containerinstantie waarvan de installatiekopieën nginx zijn in Azure Container Registry.

Voorbeeld 5: Een containergroep maken met een containerinstantie met behulp van installatiekopieën nginx in aangepast containerinstallatiekopieënregister

$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

Met deze opdrachten maakt u een containergroep met een containerinstantie waarvan de installatiekopieën een aangepaste installatiekopieën zijn uit een aangepast containerinstallatiekopieënregister.

Voorbeeld 6: Een containergroep maken waarmee het Azure File-volume wordt gekoppeld

$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

Met deze opdrachten maakt u een containergroep met een containerinstantie waarvan de installatiekopieën een aangepaste installatiekopieën zijn uit een aangepast containerinstallatiekopieënregister.

Voorbeeld 7: Een containergroep maken met door het systeem toegewezen en door de gebruiker toegewezen identiteit

$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

Met deze opdrachten maakt u een containergroep met door het systeem toegewezen en door de gebruiker toegewezen identiteit.

Parameters

-AsJob

De opdracht uitvoeren als een taak

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Container

De containers binnen de containergroep. Zie de sectie NOTES voor CONTAINER-eigenschappen en maak een hash-tabel om deze samen te stellen.

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

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

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

-DnsConfigNameServer

De DNS-servers voor de containergroep.

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

-DnsConfigOption

De DNS-opties voor de containergroep.

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

-DnsConfigSearchDomain

De DNS-zoekdomeinen voor het opzoeken van hostnamen in de containergroep.

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

-EncryptionPropertyKeyName

De naam van de versleutelingssleutel.

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

-EncryptionPropertyKeyVersion

De versie van de versleutelingssleutel.

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

-EncryptionPropertyVaultBaseUrl

De basis-URL van keyvault.

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

-IdentityType

Het type identiteit dat wordt gebruikt voor de containergroep. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten uit de containergroep verwijderd.

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

-IdentityUserAssignedIdentity

De lijst met gebruikersidentiteiten die zijn gekoppeld aan de containergroep. De sleutelverwijzingen voor de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /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

De registerreferenties van de installatiekopieën waarop de containergroep is gemaakt. Zie de sectie NOTES voor IMAGEREGISTRYCREDENTIAL-eigenschappen en maak een hash-tabel.

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

-InitContainer

De init-containers voor een containergroep. Zie de sectie NOTES voor INITCONTAINER-eigenschappen en maak een hash-tabel om deze samen te stellen.

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

-IPAddressDnsNameLabel

Het DNS-naamlabel voor het IP-adres.

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

-IPAddressIP

Het IP-adres dat beschikbaar is voor het openbare internet.

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

-IPAddressPort

De lijst met poorten die beschikbaar zijn voor de containergroep. Zie de sectie NOTES voor IPADDRESSPORT-eigenschappen en maak een hash-tabel om deze samen te stellen.

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

-IPAddressType

Hiermee geeft u op of het IP-adres beschikbaar is voor het openbare internet of het privé-VNET.

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

-Location

De resourcelocatie.

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

-LogAnalyticLogType

Het logboektype dat moet worden gebruikt.

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

-LogAnalyticMetadata

Metagegevens voor log analytics.

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

-LogAnalyticWorkspaceId

De werkruimte-id voor Log Analytics

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

-LogAnalyticWorkspaceKey

De werkruimtesleutel voor Log Analytics

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

-LogAnalyticWorkspaceResourceId

De resource-id van de werkruimte voor Log Analytics

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

-Name

De naam van de containergroep.

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

-NoWait

De opdracht asynchroon uitvoeren

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

-OSType

Het type besturingssysteem dat is vereist voor de containers in de containergroep.

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

-Priority

De prioriteit van de containergroep.

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

-ResourceGroupName

De naam van de resourcegroep.

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

-RestartPolicy

Start het beleid opnieuw op voor alle containers in de containergroep.

  • Always Altijd opnieuw opstarten- OnFailure Mislukt opnieuw opstarten- Never Nooit opnieuw opstarten
Type:ContainerGroupRestartPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Sku

De SKU voor een containergroep.

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

-SubnetId

De subnetresource-id's voor een containergroep. Zie de sectie NOTES voor SUBNETID-eigenschappen en maak een hash-tabel om deze samen te stellen.

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

-SubscriptionId

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

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

-Tag

De resourcetags.

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

-Volume

De lijst met volumes die kunnen worden gekoppeld door containers in deze containergroep. Zie de sectie NOTES voor VOLUME-eigenschappen en maak een hash-tabel om deze samen te stellen.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

-Zone

De zones voor de containergroep.

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

Uitvoerwaarden

IContainerGroup

Notities

ALIASSEN

EIGENSCHAPPEN VAN COMPLEXE PARAMETERS

Als u de hieronder beschreven parameters wilt maken, maakt u een hash-tabel met de juiste eigenschappen. Voer Get-Help-about_Hash_Tables uit voor informatie over hashtabellen.

CONTAINER <IContainer[]>: De containers binnen de containergroep.

  • Image <String>: De naam van de installatiekopieën die worden gebruikt om de containerinstantie te maken.
  • Name <String>: De door de gebruiker opgegeven naam van het containerexemplaren.
  • RequestCpu <Double>: De CPU-aanvraag van deze containerinstantie.
  • RequestMemoryInGb <Double>: De geheugenaanvraag in GB van deze containerinstantie.
  • [Command <String[]>]: De opdrachten die moeten worden uitgevoerd binnen de containerinstantie in exec-formulier.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: de omgevingsvariabelen die moeten worden ingesteld in de containerinstantie.
    • Name <String>: De naam van de omgevingsvariabele.
    • [SecureValue <String>]: De waarde van de beveiligde omgevingsvariabele.
    • [Value <String>]: De waarde van de omgevingsvariabele.
  • [LimitCpu <Double?>]: De CPU-limiet van deze containerinstantie.
  • [LimitMemoryInGb <Double?>]: De geheugenlimiet in GB van deze containerinstantie.
  • [LimitsGpuCount <Int32?>]: Het aantal GPU-resources.
  • [LimitsGpuSku <GpuSku?>]: De SKU van de GPU-resource.
  • [LivenessProbeExecCommand <String[]>]: de opdrachten die in de container moeten worden uitgevoerd.
  • [LivenessProbeFailureThreshold <Int32?>]: de drempelwaarde voor fouten.
  • [LivenessProbeHttpGetHttpHeader <IHttpHeader[]>]: de HTTP-headers.
    • [Name <String>]: de naam van de header.
    • [Value <String>]: de headerwaarde.
  • [LivenessProbeHttpGetPath <String>]: het pad om te testen.
  • [LivenessProbeHttpGetPort <Int32?>]: het poortnummer dat moet worden uitgevoerd.
  • [LivenessProbeHttpGetScheme <Scheme?>]: Het schema.
  • [LivenessProbeInitialDelaySecond <Int32?>]: De eerste vertraging seconden.
  • [LivenessProbePeriodSecond <Int32?>]: De periode seconden.
  • [LivenessProbeSuccessThreshold <Int32?>]: De drempelwaarde voor geslaagde geslaagde bewerkingen.
  • [LivenessProbeTimeoutSecond <Int32?>]: De time-out seconden.
  • [Port <IContainerPort[]>]: De weergegeven poorten op het containerexemplaren.
    • Port <Int32>: het poortnummer dat wordt weergegeven in de containergroep.
    • [Protocol <ContainerNetworkProtocol?>]: het protocol dat is gekoppeld aan de poort.
  • [ReadinessProbeExecCommand <String[]>]: de opdrachten die in de container moeten worden uitgevoerd.
  • [ReadinessProbeFailureThreshold <Int32?>]: de drempelwaarde voor fouten.
  • [ReadinessProbeHttpGetHttpHeader <IHttpHeader[]>]: de HTTP-headers.
  • [ReadinessProbeHttpGetPath <String>]: het pad om te testen.
  • [ReadinessProbeHttpGetPort <Int32?>]: het poortnummer dat moet worden uitgevoerd.
  • [ReadinessProbeHttpGetScheme <Scheme?>]: Het schema.
  • [ReadinessProbeInitialDelaySecond <Int32?>]: De eerste vertraging seconden.
  • [ReadinessProbePeriodSecond <Int32?>]: De periode seconden.
  • [ReadinessProbeSuccessThreshold <Int32?>]: De drempelwaarde voor geslaagde geslaagde bewerkingen.
  • [ReadinessProbeTimeoutSecond <Int32?>]: De time-out seconden.
  • [RequestsGpuCount <Int32?>]: Het aantal GPU-resources.
  • [RequestsGpuSku <GpuSku?>]: De SKU van de GPU-resource.
  • [VolumeMount <IVolumeMount[]>]: Het volume wordt gekoppeld aan de containerinstantie.
    • MountPath <String>: Het pad in de container waar het volume moet worden gekoppeld. Mag geen dubbele punt (:)) bevatten.
    • Name <String>: De naam van de volumekoppeling.
    • [ReadOnly <Boolean?>]: De vlag die aangeeft of de volumekoppeling alleen-lezen is.

IMAGEREGISTRYCREDENTIAL <IImageRegistryCredential[]>: de registerreferenties van de installatiekopieën waarmee de containergroep wordt gemaakt.

  • Server <String>: De Docker-installatiekopieënregisterserver zonder protocol zoals http en https.
  • [Identity <String>]: De identiteit voor het privéregister.
  • [IdentityUrl <String>]: de identiteits-URL voor het privéregister.
  • [Password <String>]: het wachtwoord voor het privéregister.
  • [Username <String>]: De gebruikersnaam voor het privéregister.

INITCONTAINER <IInitContainerDefinition[]>: De init-containers voor een containergroep.

  • Name <String>: De naam voor de init-container.
  • [Command <String[]>]: De opdracht die moet worden uitgevoerd in de init-container in exec-formulier.
  • [EnvironmentVariable <IEnvironmentVariable[]>]: De omgevingsvariabelen die moeten worden ingesteld in de init-container.
    • Name <String>: De naam van de omgevingsvariabele.
    • [SecureValue <String>]: De waarde van de beveiligde omgevingsvariabele.
    • [Value <String>]: De waarde van de omgevingsvariabele.
  • [Image <String>]: De installatiekopieën van de init-container.
  • [VolumeMount <IVolumeMount[]>]: Het volume wordt gekoppeld aan de init-container.
    • MountPath <String>: Het pad in de container waar het volume moet worden gekoppeld. Mag geen dubbele punt (:)) bevatten.
    • Name <String>: De naam van de volumekoppeling.
    • [ReadOnly <Boolean?>]: De vlag die aangeeft of de volumekoppeling alleen-lezen is.

IPADDRESSPORT <IPort[]>: De lijst met poorten die worden weergegeven in de containergroep.

  • Port1 <Int32>: het poortnummer.
  • [Protocol <ContainerGroupNetworkProtocol?>]: het protocol dat is gekoppeld aan de poort.

SUBNETID <IContainerGroupSubnetId[]>: de resource-id's van het subnet voor een containergroep.

  • Id <String>: Resource-id van virtueel netwerk en subnet.
  • [Name <String>]: Beschrijvende naam voor het subnet.

VOLUME <IVolume[]>: De lijst met volumes die kunnen worden gekoppeld door containers in deze containergroep.

  • Name <String>: De naam van het volume.
  • [AzureFileReadOnly <Boolean?>]: De vlag die aangeeft of het Gedeelde Azure-bestand als een volume alleen-lezen is.
  • [AzureFileShareName <String>]: De naam van de Azure-bestandsshare die moet worden gekoppeld als een volume.
  • [AzureFileStorageAccountKey <String>]: De toegangssleutel voor het opslagaccount die wordt gebruikt voor toegang tot de Azure-bestandsshare.
  • [AzureFileStorageAccountName <String>]: De naam van het opslagaccount dat de Azure-bestandsshare bevat.
  • [EmptyDir <IVolumeEmptyDir>]: het lege mapvolume.
    • [(Any) <Object>]: Hiermee wordt aangegeven dat een eigenschap aan dit object kan worden toegevoegd.
  • [GitRepoDirectory <String>]: doelmapnaam. Mag niet bevatten of beginnen met ... Als '.' wordt opgegeven, is de volumemap de Git-opslagplaats. Als dit niet het opgegeven is, bevat het volume de Git-opslagplaats in de submap met de opgegeven naam.
  • [GitRepoRepository <String>]: URL van opslagplaats
  • [GitRepoRevision <String>]: Hash doorvoeren voor de opgegeven revisie.
  • [Secret <ISecretVolume>]: het geheime volume.
    • [(Any) <String>]: Hiermee wordt aangegeven dat een eigenschap aan dit object kan worden toegevoegd.