New-AzNetworkCloudAgentPool

Składnia

CreateExpanded (Domyślne)

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-AvailabilityZone <String[]>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-Label <IKubernetesLabel[]>]
    [-Tag <Hashtable>]
    [-Taint <IKubernetesLabel[]>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterName <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityKubernetesClusterExpanded

New-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterInputObject <INetworkCloudIdentity>
    -Count <Int64>
    -Location <String>
    -Mode <String>
    -VMSkuName <String>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationAdminUsername <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-AgentOptionHugepagesCount <Int64>]
    [-AgentOptionHugepagesSize <String>]
    [-AttachedNetworkConfigurationL2Network <IL2NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationL3Network <IL3NetworkAttachmentConfiguration[]>]
    [-AttachedNetworkConfigurationTrunkedNetwork <ITrunkedNetworkAttachmentConfiguration[]>]
    [-AvailabilityZone <String[]>]
    [-ExtendedLocationName <String>]
    [-ExtendedLocationType <String>]
    [-Label <IKubernetesLabel[]>]
    [-Tag <Hashtable>]
    [-Taint <IKubernetesLabel[]>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Przykłady

Przykład 1. Tworzenie puli agentów klastra Kubernetes

$networkAttachment = @{
        AttachedNetworkId = "l3NetworkId"
    }
    $labels = @{
        Key = "key"
        Value = "value"
    }
    $taints = @{
        Key = "key"
        Value = "value"
    }
    $sshPublicKey = @{
        KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
    }

    New-AzNetworkCloudAgentPool -KubernetesClusterName clusterName -Name agentPoolName -ResourceGroupName resourceGroup -Count count -Location location -Mode agentPoolMode -VMSkuName vmSkuName -SubscriptionId subscriptionId -AdministratorConfigurationAdminUsername adminUsername -AdministratorConfigurationSshPublicKey $sshPublicKey -AgentOptionHugepagesCount hugepagesCount -AgentOptionHugepagesSize hugepagesSize -AttachedNetworkConfigurationL3Network $networkAttachment -AvailabilityZone availabilityZones -ExtendedLocationName clusterExtendedLocation -ExtendedLocationType "CustomLocation " -Tag @{tags = "tag"} -Label $labels -Taint $taints -UpgradeSettingMaxSurge maxSurge

Location  Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------       ----                -------------------              -------------------                   -----------------------                    ------------------------                ------------
westus3  agentpool1 07/18/2023 17:44:02 <identity>                            User                                            07/18/2023 17:46:45         <identity>

Parametry

-AdministratorConfigurationAdminUsername

Nazwa użytkownika administratora, który zostanie zastosowany do systemów operacyjnych z uruchomionymi węzłami Kubernetes. Jeśli nie zostanie podana, nazwa użytkownika zostanie wybrana przez usługę.

Właściwości parametrów

Zbiory parametrów

-AdministratorConfigurationSshPublicKey

Konfiguracja SSH dla systemów operacyjnych, które uruchamiają węzły w klastrze Kubernetes. W niektórych przypadkach do utworzenia środowiska roboczego może być wymagana specyfikacja kluczy publicznych.

Właściwości parametrów

Zbiory parametrów

-AgentOptionHugepagesCount

Liczba ogromnych stron do przydzielenia.

Właściwości parametrów

Zbiory parametrów

-AgentOptionHugepagesSize

Rozmiar ogromnych stron do przydzielenia.

Właściwości parametrów

Zbiory parametrów

-AsJob

Uruchamianie polecenia jako zadania

Właściwości parametrów

Zbiory parametrów

-AttachedNetworkConfigurationL2Network

Lista sieci warstwy 2 i powiązanej konfiguracji załącznika.

Właściwości parametrów

Zbiory parametrów

-AttachedNetworkConfigurationL3Network

Lista sieci warstwy 3 i powiązana konfiguracja załącznika.

Właściwości parametrów

Zbiory parametrów

-AttachedNetworkConfigurationTrunkedNetwork

Lista sieci magistrali i powiązanej konfiguracji załącznika.

Właściwości parametrów

Zbiory parametrów

-AvailabilityZone

Lista stref dostępności klastra chmury sieciowej używanej do aprowizacji węzłów w tej puli agentów. Jeśli nie zostanie określony, zostaną użyte wszystkie strefy dostępności.

Właściwości parametrów

Zbiory parametrów

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Zbiory parametrów

-Count

Liczba maszyn wirtualnych korzystających z tej konfiguracji.

Właściwości parametrów

Zbiory parametrów

-DefaultProfile

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

Właściwości parametrów

Zbiory parametrów

-ExtendedLocationName

Identyfikator zasobu lokalizacji rozszerzonej, w której zostanie utworzony zasób.

Właściwości parametrów

Zbiory parametrów

-ExtendedLocationType

Typ lokalizacji rozszerzonej, na przykład CustomLocation.

Właściwości parametrów

Zbiory parametrów

-IfMatch

Element ETag przekształcenia. Pomiń tę wartość, aby zawsze zastąpić bieżący zasób. Określ ostatnio widzianą wartość elementu ETag, aby zapobiec przypadkowemu zastępowaniu współbieżnych zmian.

Właściwości parametrów

Zbiory parametrów

-IfNoneMatch

Ustaw wartość "*", aby zezwolić na utworzenie nowego zestawu rekordów, ale aby zapobiec aktualizowaniu istniejącego zasobu. Inne wartości spowodują błąd z serwera, ponieważ nie są one obsługiwane.

Właściwości parametrów

Zbiory parametrów

-JsonFilePath

Ścieżka pliku Json dostarczonego do operacji Tworzenia

Właściwości parametrów

Zbiory parametrów

-JsonString

Ciąg Json dostarczony do operacji Tworzenia

Właściwości parametrów

Zbiory parametrów

-KubernetesClusterInputObject

Parametr tożsamości

Właściwości parametrów

Zbiory parametrów

-KubernetesClusterName

Nazwa klastra Kubernetes.

Właściwości parametrów

Zbiory parametrów

-Label

Etykiety zastosowane do węzłów w tej puli agentów.

Właściwości parametrów

Zbiory parametrów

-Location

Lokalizacja geograficzna, w której znajduje się zasób

Właściwości parametrów

Zbiory parametrów

-Mode

Wybór sposobu wykorzystania tej puli agentów jako puli systemowej lub puli użytkowników. Pule systemu uruchamiają funkcje i usługi krytyczne dla klastra Kubernetes, a pule użytkowników są przeznaczone dla obciążeń użytkowników. Każdy klaster Kubernetes musi zawierać co najmniej jedną pulę węzłów systemowych z co najmniej jednym węzłem.

Właściwości parametrów

Zbiory parametrów

-Name

Nazwa puli agentów klastra Kubernetes.

Właściwości parametrów

Zbiory parametrów

-NoWait

Uruchom polecenie asynchronicznie

Właściwości parametrów

Zbiory parametrów

-ResourceGroupName

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

Właściwości parametrów

Zbiory parametrów

-SubscriptionId

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

Właściwości parametrów

Zbiory parametrów

-Tag

Tagi zasobów.

Właściwości parametrów

Zbiory parametrów

-Taint

Defekty zastosowane do węzłów w tej puli agentów.

Właściwości parametrów

Zbiory parametrów

-UpgradeSettingDrainTimeout

Maksymalny czas w sekundach dozwolony na zakończenie opróżniania węzła przed kontynuowaniem uaktualniania puli agentów. Jeśli nie zostanie określona podczas tworzenia, zostanie użyta wartość 1800 sekund.

Właściwości parametrów

Zbiory parametrów

-UpgradeSettingMaxSurge

Maksymalna liczba lub procent węzłów, które są przesiąknięci podczas uaktualniania. Można to ustawić na liczbę całkowitą (np. "5") lub wartość procentową (np. "50%"). Jeśli określono wartość procentową, jest to procent całkowitego rozmiaru puli agentów w momencie uaktualnienia. W przypadku wartości procentowych węzły ułamkowe są zaokrąglane w górę. Jeśli nie zostanie określona podczas tworzenia, zostanie użyta wartość 1. Jedna z wartości MaxSurge i MaxUnavailable musi być większa niż 0.

Właściwości parametrów

Zbiory parametrów

-UpgradeSettingMaxUnavailable

Maksymalna liczba lub procent węzłów, które mogą być niedostępne podczas uaktualniania. Można to ustawić na liczbę całkowitą (np. "5") lub wartość procentową (np. "50%"). Jeśli określono wartość procentową, jest to procent całkowitego rozmiaru puli agentów w momencie uaktualnienia. W przypadku wartości procentowych węzły ułamkowe są zaokrąglane w górę. Jeśli nie zostanie określona podczas tworzenia, zostanie użyta wartość 0. Jedna z wartości MaxSurge i MaxUnavailable musi być większa niż 0.

Właściwości parametrów

Zbiory parametrów

-VMSkuName

Nazwa jednostki SKU maszyny wirtualnej, która określa rozmiar zasobów przydzielonych dla maszyn wirtualnych węzła.

Właściwości parametrów

Zbiory parametrów

-WhatIf

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

Właściwości parametrów

Zbiory parametrów

CommonParameters

Wejścia

INetworkCloudIdentity

Wyjść

IAgentPool