Udostępnij przez

Update-AzNetworkCloudAgentPool

Moduł:
Az.NetworkCloud Module

Popraw właściwości podanej puli agentów klastra Kubernetes lub zaktualizuj tagi skojarzone z pulą agentów klastra Kubernetes. Właściwości i aktualizacja tagów można wykonać niezależnie.

Składnia

UpdateExpanded (Domyślne) 

Update-AzNetworkCloudAgentPool
    -KubernetesClusterName <String>
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-Count <Int64>]
    [-Tag <Hashtable>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaJsonString 

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

UpdateViaJsonFilePath 

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

UpdateViaIdentityKubernetesClusterExpanded 

Update-AzNetworkCloudAgentPool
    -Name <String>
    -KubernetesClusterInputObject <INetworkCloudIdentity>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-Count <Int64>]
    [-Tag <Hashtable>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded 

Update-AzNetworkCloudAgentPool
    -InputObject <INetworkCloudIdentity>
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-AdministratorConfigurationSshPublicKey <ISshPublicKey[]>]
    [-Count <Int64>]
    [-Tag <Hashtable>]
    [-UpgradeSettingDrainTimeout <Int64>]
    [-UpgradeSettingMaxSurge <String>]
    [-UpgradeSettingMaxUnavailable <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Popraw właściwości podanej puli agentów klastra Kubernetes lub zaktualizuj tagi skojarzone z pulą agentów klastra Kubernetes. Właściwości i aktualizacja tagów można wykonać niezależnie.

Przykłady

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

Update-AzNetworkCloudAgentPool -Name agentPoolName -KubernetesClusterName clusterName -ResourceGroupName resourceGroup -Count updatedCount -Tag @{tags = "newTag"} -UpgradeSettingMaxSurge updatedMaxSurge

Location Name           SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy
--------      ----                -------------------               -------------------                  -----------------------                   ------------------------                  --
westus3  agentpool1 07/17/2023 18:14:59 <identity>                           Application                              07/18/2023 17:06:24           <identity>

To polecenie aktualizuje właściwości puli agentów klastra Kubernetes.

Parametry

-AdministratorConfigurationSshPublicKey

SshPublicKey reprezentuje klucz publiczny używany do uwierzytelniania za pomocą zasobu za pośrednictwem protokołu SSH.

Właściwości parametrów

Typ:

ISshPublicKey[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-AsJob

Uruchamianie polecenia jako zadania

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:por

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Count

Liczba maszyn wirtualnych korzystających z tej konfiguracji.

Właściwości parametrów

Typ:Int64
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-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

Typ:PSObject
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzureRMContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-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

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-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

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-InputObject

Parametr tożsamości

Właściwości parametrów

Typ:INetworkCloudIdentity
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-JsonFilePath

Ścieżka pliku Json dostarczonego do operacji aktualizacji

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateViaJsonFilePath
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-JsonString

Ciąg Json dostarczony do operacji aktualizacji

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateViaJsonString
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-KubernetesClusterInputObject

Parametr tożsamości

Właściwości parametrów

Typ:INetworkCloudIdentity
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-KubernetesClusterName

Nazwa klastra Kubernetes.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonString
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonFilePath
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Name

Nazwa puli agentów klastra Kubernetes.

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AgentPoolName

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonString
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonFilePath
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-NoWait

Uruchom polecenie asynchronicznie

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ResourceGroupName

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonString
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonFilePath
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-SubscriptionId

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

Właściwości parametrów

Typ:String
Wartość domyślna:(Get-AzContext).Subscription.Id
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonString
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaJsonFilePath
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Tag

Tagi zasobów platformy Azure, które zastąpią istniejące.

Właściwości parametrów

Typ:Hashtable
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-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

Typ:Int64
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-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

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-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

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

UpdateExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityKubernetesClusterExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
UpdateViaIdentityExpanded
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-WhatIf

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Wi

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

INetworkCloudIdentity

Wyjść

IAgentPool