Update-AzNetworkCloudAgentPool
Korrigera egenskaperna för den angivna Kubernetes-klusteragentpoolen eller uppdatera taggarna som är associerade med Kubernetes-klusteragentpoolen.
Egenskaper och tagguppdatering kan göras oberoende av varandra.
Syntax
UpdateExpanded (Standard)
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>]
Description
Korrigera egenskaperna för den angivna Kubernetes-klusteragentpoolen eller uppdatera taggarna som är associerade med Kubernetes-klusteragentpoolen.
Egenskaper och tagguppdatering kan göras oberoende av varandra.
Exempel
Exempel 1: Uppdatera Kubernetes-klustrets agentpool
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>
Det här kommandot uppdaterar egenskaperna för en Kubernetes-klusteragentpool.
Parametrar
-AdministratorConfigurationSshPublicKey
SshPublicKey representerar den offentliga nyckel som används för att autentisera med en resurs via SSH.
Parameteregenskaper
Typ: ISshPublicKey [ ]
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-AsJob
Kör kommandot som ett jobb
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: jfr
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Count
Antalet virtuella datorer som använder den här konfigurationen.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-DefaultProfile
Parametern DefaultProfile fungerar inte.
Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.
Parameteregenskaper
Typ: PSObject
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: AzureRMContext, AzureCredential
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-IfMatch
ETag för omvandlingen.
Utelämna det här värdet för att alltid skriva över den aktuella resursen.
Ange det senast synliga ETag-värdet för att förhindra att samtidiga ändringar skrivs över av misstag.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-IfNoneMatch
Ange till *för att tillåta att en ny postuppsättning skapas, men för att förhindra uppdatering av en befintlig resurs.
Andra värden resulterar i fel från servern eftersom de inte stöds.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
Identitetsparameter
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: True
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-JsonFilePath
Sökvägen till Json-filen som har angetts för uppdateringsåtgärden
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateViaJsonFilePath
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-JsonString
Json-sträng som har angetts för uppdateringsåtgärden
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateViaJsonString
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
Identitetsparameter
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: True
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-KubernetesClusterName
Namnet på Kubernetes-klustret.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonString
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonFilePath
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Name
Namnet på Kubernetes-klusteragentpoolen.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: AgentPoolName
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonString
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonFilePath
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-NoWait
Kör kommandot asynkront
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-ResourceGroupName
Namnet på resursgruppen.
Namnet är skiftlägesokänsligt.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonString
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonFilePath
Position: Named
Obligatorisk: True
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-SubscriptionId
ID för målprenumerationen.
Värdet måste vara ett UUID.
Parameteregenskaper
Typ: String
Standardvärde: (Get-AzContext).Subscription.Id
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonString
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaJsonFilePath
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-Tag
De Azure resurstaggar som ersätter de befintliga.
Parameteregenskaper
Typ: Hashtable
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-UpgradeSettingDrainTimeout
Den maximala tiden i sekunder som tillåts för att en nodavlopp ska slutföras innan du fortsätter med uppgraderingen av agentpoolen.
Om det inte anges under skapandet används ett värde på 1 800 sekunder.
Parameteregenskaper
Typ: Int64
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-UpgradeSettingMaxSurge
Det maximala antalet eller procentandelen noder som ökar under uppgraderingen.
Detta kan antingen anges till ett heltal (t.ex. "5") eller en procentandel (t.ex. "50%").
Om en procentandel anges är det procentandelen av den totala agentpoolens storlek vid tidpunkten för uppgraderingen.
För procentandelar avrundas bråknoder uppåt.
Om det inte anges under skapandet används värdet 1.
En av MaxSurge och MaxUnavailable måste vara större än 0.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-UpgradeSettingMaxUnavailable
Det maximala antalet eller procentandelen noder som kan vara otillgängliga under uppgraderingen.
Detta kan antingen anges till ett heltal (t.ex. "5") eller en procentandel (t.ex. "50%").
Om en procentandel anges är det procentandelen av den totala agentpoolens storlek vid tidpunkten för uppgraderingen.
För procentandelar avrundas bråknoder uppåt.
Om det inte anges under skapandet används värdet 0.
En av MaxSurge och MaxUnavailable måste vara större än 0.
Parameteregenskaper
Typ: String
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Parameteruppsättningar
UpdateExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityKubernetesClusterExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
UpdateViaIdentityExpanded
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
-WhatIf
Visar vad som skulle hända om kommandot körs.
Cmdleten körs inte.
Parameteregenskaper
Typ: SwitchParameter
Standardvärde: None
Stöder jokertecken: False
DontShow: False
Alias: Wi
Parameteruppsättningar
(All)
Position: Named
Obligatorisk: False
Värde från pipeline: False
Värde från pipeline efter egenskapsnamn: False
Värde från återstående argument: False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters .
Utdata