New-AzureRmContainerGroup
Skapar en containergrupp.
Varning
AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.
Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.
Syntax
New-AzureRmContainerGroup
[-ResourceGroupName] <String>
[-Name] <String>
[-Image] <String>
[-RegistryCredential <PSCredential>]
[-Location <String>]
[-OsType <String>]
[-RestartPolicy <String>]
[-Cpu <Int32>]
[-MemoryInGB <Double>]
[-IpAddressType <String>]
[-DnsNameLabel <String>]
[-Port <Int32[]>]
[-Command <String>]
[-EnvironmentVariable <Hashtable>]
[-RegistryServerDomain <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzureRmContainerGroup
[-ResourceGroupName] <String>
[-Name] <String>
[-Image] <String>
[-RegistryCredential <PSCredential>]
-AzureFileVolumeShareName <String>
-AzureFileVolumeAccountCredential <PSCredential>
-AzureFileVolumeMountPath <String>
[-Location <String>]
[-OsType <String>]
[-RestartPolicy <String>]
[-Cpu <Int32>]
[-MemoryInGB <Double>]
[-IpAddressType <String>]
[-DnsNameLabel <String>]
[-Port <Int32[]>]
[-Command <String>]
[-EnvironmentVariable <Hashtable>]
[-RegistryServerDomain <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdletarna New-AzureRmContainerGroup skapar en containergrupp.
Exempel
Exempel 1
PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image nginx -OsType Linux -IpAddressType Public -Port @(8000)
ResourceGroupName : demo
Id : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name : mycontainer
Type : Microsoft.ContainerInstance/containerGroups
Location : westus
Tags :
ProvisioningState : Creating
Containers : {mycontainer}
ImageRegistryCredentials :
RestartPolicy :
IpAddress : 13.88.10.240
Ports : {8000}
OsType : Linux
Volumes :
State : Running
Events : {}
De här kommandona skapar en containergrupp med den senaste nginx-avbildningen och begär en offentlig IP-adress med öppningsport 8000.
Exempel 2
PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image alpine -OsType Linux -Command "/bin/sh -c myscript.sh" -EnvironmentVariable @{"env1"="value1";"env2"="value2"}
ResourceGroupName : demo
Id : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name : mycontainer
Type : Microsoft.ContainerInstance/containerGroups
Location : westus
Tags :
ProvisioningState : Creating
Containers : {mycontainer}
ImageRegistryCredentials :
RestartPolicy :
IpAddress :
Ports :
OsType : Linux
Volumes :
State : Running
Events : {}
De här kommandona skapar en containergrupp och kör ett anpassat skript i containern.
Exempel 3: Skapar en containergrupp för körning till slutförande.
PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image alpine -OsType Linux -Command "echo hello" -RestartPolicy Never
ResourceGroupName : demo
Id : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name : mycontainer
Type : Microsoft.ContainerInstance/containerGroups
Location : westus
Tags :
ProvisioningState : Creating
Containers : {mycontainer}
ImageRegistryCredentials :
RestartPolicy :
IpAddress :
Ports :
OsType : Linux
Volumes :
State : Running
Events : {}
De här kommandona skapar en containergrupp som skriver ut "hello" och stoppar.
Exempel 4: Skapar en containergrupp med avbildning i Azure Container Registry
PS C:\> $secpasswd = ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force
PS C:\> $mycred = New-Object System.Management.Automation.PSCredential ("myacr", $secpasswd)
PS C:\> New-AzureRmContainerGroup -ResourceGroupName demo -Name mycontainer -Image myacr.azurecr.io/nginx:latest -IpAddressType Public -RegistryCredential $mycred
ResourceGroupName : demo
Id : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name : mycontainer
Type : Microsoft.ContainerInstance/containerGroups
Location : westus
Tags :
ProvisioningState : Creating
Containers : {mycontainer}
ImageRegistryCredentials : {myacr}
RestartPolicy :
IpAddress : 13.88.10.240
Ports : {80}
OsType : Linux
Volumes :
State : Running
Events : {}
De här kommandona skapar en containergrupp med en nginx-avbildning i Azure Container Registry.
Exempel 5: Skapar en containergrupp med avbildning i det anpassade containeravbildningsregistret
PS C:\> $secpasswd = ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force
PS C:\> $mycred = New-Object System.Management.Automation.PSCredential ("username", $secpasswd)
PS C:\> New-AzureRmContainerGroup -ResourceGroupName MyResourceGroup -Name MyContainer -Image myserver.com/myimage:latest -RegistryServer myserver.com -RegistryCredential $mycred
ResourceGroupName : demo
Id : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name : mycontainer
Type : Microsoft.ContainerInstance/containerGroups
Location : westus
Tags :
ProvisioningState : Creating
Containers : {mycontainer}
ImageRegistryCredentials : {myserver.com}
RestartPolicy :
IpAddress : 13.88.10.240
Ports : {80}
OsType : Linux
Volumes :
State : Running
Events : {}
De här kommandona skapar en containergrupp med en anpassad avbildning från ett anpassat containeravbildningsregister.
Exempel 6: Skapar en containergrupp som monterar Azure File-volymen
PS C:\> $secpasswd = ConvertTo-SecureString "PlainTextPassword" -AsPlainText -Force
PS C:\> $mycred = New-Object System.Management.Automation.PSCredential ("username", $secpasswd)
PS C:\> New-AzureRmContainerGroup -ResourceGroupName MyResourceGroup -Name MyContainer -Image alpine -AzureFileVolumeShareName myshare -AzureFileVolumeAccountKey $mycred -AzureFileVolumeMountPath /mnt/azfile
ResourceGroupName : demo
Id : /subscriptions/ae43b1e3-c35d-4c8c-bc0d-f148b4c52b78/resourceGroups/demo/providers/Microsoft.ContainerInstance/containerGroups/mycontainer
Name : mycontainer
Type : Microsoft.ContainerInstance/containerGroups
Location : westus
Tags :
ProvisioningState : Creating
Containers : {mycontainer}
ImageRegistryCredentials : {myserver.com}
RestartPolicy :
IpAddress : 13.88.10.240
Ports : {80}
OsType : Linux
Volumes : {AzureFile}
State : Running
Events : {}
De här kommandona skapar en containergrupp som monterar den angivna Azure-filresursen till /mnt/azfile
.
Parametrar
-AzureFileVolumeAccountCredential
Lagringskontots autentiseringsuppgifter för Azure-filresursen som ska monteras där användarnamnet är lagringskontots namn och nyckeln är lagringskontonyckeln.
Typ: | PSCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AzureFileVolumeMountPath
Monteringssökvägen för Azure File-volymen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AzureFileVolumeShareName
Namnet på den Azure-filresurs som ska monteras.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Command
Kommandot som ska köras i containern.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Cpu
De processorkärnor som krävs. Standard: 1
Typ: | Nullable<T>[Int32] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.
Typ: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DnsNameLabel
DNS-namnetiketten för IP-adressen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnvironmentVariable
Miljövariablerna för containrar.
Typ: | Hashtable |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Image
Containeravbildningen.
Typ: | String |
Position: | 2 |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpAddressType
IP-adresstypen.
Typ: | String |
accepterade värden: | Public |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Containergruppen Plats. Standardvärdet är platsen för resursgruppen.
Typ: | String |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MemoryInGB
Det minne som krävs i GB. Standard: 1,5
Typ: | Nullable<T>[Double] |
Aliases: | Memory |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Namnet på containergruppen.
Typ: | String |
Position: | 1 |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OsType
Typ av containeroperativsystem. Standard: Linux
Typ: | String |
accepterade värden: | Linux, Windows |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Portarna som ska öppnas. Standard: [80]
Typ: | Int32[] |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryCredential
Autentiseringsuppgifterna för det anpassade containerregistret.
Typ: | PSCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegistryServerDomain
Inloggningsservern för det anpassade containerregistret.
Typ: | String |
Aliases: | RegistryServer |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Resursgruppens namn.
Typ: | String |
Position: | 0 |
standardvärde: | None |
Obligatorisk: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RestartPolicy
Principen för omstart av container. Standard: Alltid
Typ: | String |
accepterade värden: | Always, Never, OnFailure |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
{{Beskrivning av fyllningstagg}}
Typ: | Hashtable |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |