Udostępnij za pośrednictwem


New-AzContainerInstanceContainerGroupProfile

Utwórz lub zaktualizuj profile grup kontenerów przy użyciu określonych konfiguracji.

Składnia

New-AzContainerInstanceContainerGroupProfile
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Container <IContainer[]>
   -OSType <OperatingSystemTypes>
   [-ConfidentialComputePropertyCcePolicy <String>]
   [-EncryptionPropertyIdentity <String>]
   [-EncryptionPropertyKeyName <String>]
   [-EncryptionPropertyKeyVersion <String>]
   [-EncryptionPropertyVaultBaseUrl <String>]
   [-Extension <IDeploymentExtensionSpec[]>]
   [-IPAddressAutoGeneratedDomainNameLabelScope <DnsNameLabelReusePolicy>]
   [-IPAddressDnsNameLabel <String>]
   [-IPAddressIP <String>]
   [-IPAddressPort <IPort[]>]
   [-IPAddressType <ContainerGroupIPAddressType>]
   [-ImageRegistryCredential <IImageRegistryCredential[]>]
   [-InitContainer <IInitContainerDefinition[]>]
   [-Location <String>]
   [-LogAnalyticLogType <LogAnalyticsLogType>]
   [-LogAnalyticMetadata <Hashtable>]
   [-LogAnalyticWorkspaceId <String>]
   [-LogAnalyticWorkspaceKey <String>]
   [-LogAnalyticWorkspaceResourceId <String>]
   [-Priority <ContainerGroupPriority>]
   [-RestartPolicy <ContainerGroupRestartPolicy>]
   [-Sku <ContainerGroupSku>]
   [-Tag <Hashtable>]
   [-Volume <IVolume[]>]
   [-Zone <String[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Utwórz lub zaktualizuj profile grup kontenerów przy użyciu określonych konfiguracji.

Przykłady

Przykład 1: Tworzenie profilu grupy kontenerów z wystąpieniem kontenera i żądanie publicznego adresu IP przy użyciu otwierania portów

$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)
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux -RestartPolicy "Never" -IpAddressType Public

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

To polecenie tworzy profil grupy kontenerów z wystąpieniem kontenera, którego obraz jest najnowszy nginx, i żąda publicznego adresu IP z otwarciem portu 8000 i 8001.

Przykład 2. Tworzenie profilu grupy kontenerów i uruchamianie niestandardowego skryptu wewnątrz kontenera.

$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) -RequestCpu 1 -RequestMemoryInGb 1.5
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

To polecenie tworzy profil grupy kontenerów i uruchamia skrypt niestandardowy wewnątrz kontenera.

Przykład 3. Tworzenie profilu grupy kontenerów z wystąpieniem kontenera przy użyciu obrazu nginx w usłudze Azure Container Registry

$pwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
$container = New-AzContainerInstanceObject -Name test-container -Image myacr.azurecr.io/nginx:latest -RequestCpu 1 -RequestMemoryInGb 1.5
$imageRegistryCredential = New-AzContainerGroupImageRegistryCredentialObject -Server "myacr.azurecr.io" -Username "username" -Password $pwd
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -ImageRegistryCredential $imageRegistryCredential -OsType Linux

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

To polecenie tworzy profil grupy kontenerów z wystąpieniem kontenera, którego obraz jest nginx w usłudze Azure Container Registry.

Przykład 4. Tworzenie profilu grupy kontenerów z priorytetem typu spot i wystąpieniem kontenera przy użyciu obrazu nginx

$container = New-AzContainerInstanceObject -Name test-container -Image nginx -RequestCpu 1 -RequestMemoryInGb 1.5
$containerGroupProfile = New-AzContainerInstanceContainerGroupProfile -ResourceGroupName test-rg -Name test-cgp -Location eastus -Container $container -OsType Linux -RestartPolicy Never -Priority Spot

Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cgp      test-rg

To polecenie tworzy profil grupy kontenerów z priorytetem typu spot i wystąpieniem kontenera, którego obraz jest nginx.

Parametry

-ConfidentialComputePropertyCcePolicy

Zasady wymuszania poufnego mocy obliczeniowej zakodowane w formacie base64

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Container

Kontenery w grupie kontenerów. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości KONTENERa i utwórz tabelę skrótów.

Typ:IContainer[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EncryptionPropertyIdentity

Tożsamość zarządzana usługi Keyvault.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EncryptionPropertyKeyName

Nazwa klucza szyfrowania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EncryptionPropertyKeyVersion

Wersja klucza szyfrowania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EncryptionPropertyVaultBaseUrl

Podstawowy adres URL usługi Keyvault.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Extension

Rozszerzenia używane przez wirtualny kubelet Do konstruowania, zobacz sekcję UWAGI dla właściwości ROZSZERZENIA i utwórz tabelę skrótów.

Typ:IDeploymentExtensionSpec[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ImageRegistryCredential

Poświadczenia rejestru obrazów, na podstawie których jest tworzona grupa kontenerów. Aby utworzyć, zobacz sekcję UWAGI dla właściwości IMAGEREGISTRYCREDENTIAL i utwórz tabelę skrótów.

Typ:IImageRegistryCredential[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InitContainer

Kontenery inicjowania dla grupy kontenerów. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości INITCONTAINER i utwórz tabelę skrótów.

Typ:IInitContainerDefinition[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IPAddressAutoGeneratedDomainNameLabelScope

Wartość reprezentująca wyliczenie zabezpieczeń. Wartość "Niezabezpieczone" jest wartością domyślną, jeśli nie została wybrana i oznacza, że etykieta nazwy domeny obiektu nie jest zabezpieczona przed przejęciem poddomeny. Wartość "TenantReuse" jest wartością domyślną, jeśli została wybrana i oznacza, że etykieta nazwy domeny obiektu może być ponownie używana w ramach tej samej dzierżawy. Wartość "SubscriptionReuse" oznacza, że etykieta nazwy domeny obiektu może zostać ponownie użyta w ramach tej samej subskrypcji. Wartość "ResourceGroupReuse" oznacza, że etykieta nazwy domeny obiektu może być ponownie używana w ramach tej samej grupy zasobów. Wartość "NoReuse" oznacza, że etykieta nazwy domeny obiektu nie może być ponownie używana w tej samej grupie zasobów, subskrypcji lub dzierżawie.

Typ:DnsNameLabelReusePolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IPAddressDnsNameLabel

Etykieta nazwy DNS dla adresu IP.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IPAddressIP

Adres IP uwidoczniony w publicznym Internecie.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IPAddressPort

Lista portów uwidocznionych w grupie kontenerów. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości IPADDRESSPORT i utwórz tabelę skrótów.

Typ:IPort[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IPAddressType

Określa, czy adres IP jest uwidoczniony w publicznej sieci internetowej lub prywatnej sieci wirtualnej.

Typ:ContainerGroupIPAddressType
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Lokalizacja zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogAnalyticLogType

Typ dziennika do użycia.

Typ:LogAnalyticsLogType
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogAnalyticMetadata

Metadane analizy dzienników.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogAnalyticWorkspaceId

Identyfikator obszaru roboczego dla usługi Log Analytics

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogAnalyticWorkspaceKey

Klucz obszaru roboczego na potrzeby analizy dzienników

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LogAnalyticWorkspaceResourceId

Identyfikator zasobu obszaru roboczego dla usługi Log Analytics

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa profilu grupy kontenerów.

Typ:String
Aliasy:ContainerGroupProfileName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OSType

Typ systemu operacyjnego wymagany przez kontenery w grupie kontenerów.

Typ:OperatingSystemTypes
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Priority

Priorytet grupy kontenerów.

Typ:ContainerGroupPriority
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestartPolicy

Uruchom ponownie zasady dla wszystkich kontenerów w grupie kontenerów.

  • Always Zawsze uruchamiaj ponownie — ponowne uruchamianie OnFailure po awarii — Never Nigdy nie uruchamiaj ponownie
Typ:ContainerGroupRestartPolicy
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Sku

Jednostka SKU dla grupy kontenerów.

Typ:ContainerGroupSku
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubscriptionId

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

Typ:String
Position:Named
Domyślna wartość:(Get-AzContext).Subscription.Id
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tag

Tagi zasobów.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Volume

Lista woluminów, które mogą być instalowane przez kontenery w tej grupie kontenerów. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości woluminu i utwórz tabelę skrótów.

Typ:IVolume[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Zone

Strefy dla grupy kontenerów.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

IContainerGroupProfile