你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Update-AzAksArcCluster
Update the provisioned cluster instance
Syntax
Update-AzAksArcCluster
-ClusterName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-AdminGroupObjectID <String[]>]
[-EnableAzureHybridBenefit]
[-ControlPlaneCount <Int32>]
[-NfCsiDriverEnabled]
[-SmbCsiDriverEnabled]
[-AutoScalerProfileBalanceSimilarNodeGroup <String>]
[-AutoScalerProfileExpander <String>]
[-AutoScalerProfileMaxEmptyBulkDelete <String>]
[-AutoScalerProfileMaxGracefulTerminationSec <String>]
[-AutoScalerProfileMaxNodeProvisionTime <String>]
[-AutoScalerProfileMaxTotalUnreadyPercentage <String>]
[-AutoScalerProfileNewPodScaleUpDelay <String>]
[-AutoScalerProfileOkTotalUnreadyCount <String>]
[-AutoScalerProfileScaleDownDelayAfterAdd <String>]
[-AutoScalerProfileScaleDownDelayAfterDelete <String>]
[-AutoScalerProfileScaleDownDelayAfterFailure <String>]
[-AutoScalerProfileScaleDownUnneededTime <String>]
[-AutoScalerProfileScaleDownUnreadyTime <String>]
[-AutoScalerProfileScaleDownUtilizationThreshold <String>]
[-AutoScalerProfileScanInterval <String>]
[-AutoScalerProfileSkipNodesWithLocalStorage <String>]
[-AutoScalerProfileSkipNodesWithSystemPod <String>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzAksArcCluster
-ClusterName <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-MinCount <Int32>
-MaxCount <Int32>
[-AdminGroupObjectID <String[]>]
[-EnableAzureHybridBenefit]
[-ControlPlaneCount <Int32>]
[-NfCsiDriverEnabled]
[-SmbCsiDriverEnabled]
[-AutoScalerProfileBalanceSimilarNodeGroup <String>]
[-AutoScalerProfileExpander <String>]
[-AutoScalerProfileMaxEmptyBulkDelete <String>]
[-AutoScalerProfileMaxGracefulTerminationSec <String>]
[-AutoScalerProfileMaxNodeProvisionTime <String>]
[-AutoScalerProfileMaxTotalUnreadyPercentage <String>]
[-AutoScalerProfileNewPodScaleUpDelay <String>]
[-AutoScalerProfileOkTotalUnreadyCount <String>]
[-AutoScalerProfileScaleDownDelayAfterAdd <String>]
[-AutoScalerProfileScaleDownDelayAfterDelete <String>]
[-AutoScalerProfileScaleDownDelayAfterFailure <String>]
[-AutoScalerProfileScaleDownUnneededTime <String>]
[-AutoScalerProfileScaleDownUnreadyTime <String>]
[-AutoScalerProfileScaleDownUtilizationThreshold <String>]
[-AutoScalerProfileScanInterval <String>]
[-AutoScalerProfileSkipNodesWithLocalStorage <String>]
[-AutoScalerProfileSkipNodesWithSystemPod <String>]
[-EnableAutoScaling]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Update the provisioned cluster instance
Examples
Example 1: Scale up control plane count
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -ControlPlaneCount 3
Increase control plane count to 3 nodes.
Example 2: Enable autoscaling
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAutoScaling -MinCount 1 -MaxCount 5
Enable autoscaling in provisioned cluster.
Example 3: Enable NfCsiDriver
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -NfCsiDriverEnabled
Enable NfCsi driver in provisioned cluster.
Example 4: Enable SmbCsiDriver
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SmbCsiDriverEnabled
Enable SmbCsi driver in provisioned cluster.
Example 5: Enable azure hybrid benefit
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAzureHybridBenefit
Enable Azure Hybrid User Benefits feature for a provisioned cluster.
Example 6: Disable azure hybrid benefit
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAzureHybridBenefit:$false
Disable Azure Hybrid User Benefits feature for a provisioned cluster.
Example 7: Disable autoscaling
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -EnableAutoScaling:$false
Disable autoscaling in provisioned cluster.
Example 8: Disable NfCsiDriver
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -NfCsiDriverEnabled:$false
Disable NfCsi driver in provisioned cluster.
Example 9: Disable SmbCsiDriver
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -SmbCsiDriverEnabled:$false
Disable SmbCsi driver in provisioned cluster.
Example 10: Update aad admin GUIDS
Update-AzAksArcCluster -ClusterName azps_test_cluster -ResourceGroupName azps_test_group -AdminGroupObjectID @("00001111-aaaa-2222-bbbb-3333cccc4444", "1b28ff4f-f7c5-4aaa-aa79-ba8b775ab443")
Update aad admin GUIDS.
Parameters
-AdminGroupObjectID
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AsJob
Run the command as a job
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileBalanceSimilarNodeGroup
Valid values are 'true' and 'false'
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileExpander
If not specified, the default is 'random'. See expanders for more information.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileMaxEmptyBulkDelete
The default is 10.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileMaxGracefulTerminationSec
The default is 600.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileMaxNodeProvisionTime
The default is '15m'. Values must be an integer followed by an 'm'. No unit of time other than minutes (m) is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileMaxTotalUnreadyPercentage
The default is 45. The maximum is 100 and the minimum is 0.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileNewPodScaleUpDelay
For scenarios like burst/batch scale where you don't want CA to act before the kubernetes scheduler could schedule all the pods, you can tell CA to ignore unscheduled pods before they're a certain age. The default is '0s'. Values must be an integer followed by a unit ('s' for seconds, 'm' for minutes, 'h' for hours, etc).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileOkTotalUnreadyCount
This must be an integer. The default is 3.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScaleDownDelayAfterAdd
The default is '10m'. Values must be an integer followed by an 'm'. No unit of time other than minutes (m) is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScaleDownDelayAfterDelete
The default is the scan-interval. Values must be an integer followed by an 'm'. No unit of time other than minutes (m) is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScaleDownDelayAfterFailure
The default is '3m'. Values must be an integer followed by an 'm'. No unit of time other than minutes (m) is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScaleDownUnneededTime
The default is '10m'. Values must be an integer followed by an 'm'. No unit of time other than minutes (m) is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScaleDownUnreadyTime
The default is '20m'. Values must be an integer followed by an 'm'. No unit of time other than minutes (m) is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScaleDownUtilizationThreshold
The default is '0.5'.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileScanInterval
The default is '10'. Values must be an integer number of seconds.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileSkipNodesWithLocalStorage
The default is true.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScalerProfileSkipNodesWithSystemPod
The default is true.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClusterName
The name of the Kubernetes cluster on which get is called.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ControlPlaneCount
Number of control plane nodes. The default value is 1, and the count should be an odd number
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutoScaling
Indicates whether to enable autoscalar. The default value is true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAzureHybridBenefit
Indicates whether Azure Hybrid Benefit is opted in. Default value is false
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxCount
Max nodes in autoscalar
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinCount
Min nodes in autoscalar
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NfCsiDriverEnabled
Indicates whether to enable NFS CSI Driver. The default value is true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Run the command asynchronously
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
The name of the resource group. The name is case insensitive.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SmbCsiDriverEnabled
Indicates whether to enable SMB CSI Driver. The default value is true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
The ID of the target subscription.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |