你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzureRmVmssRollingUpgradePolicy

设置 VMSS 滚动升级策略属性。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Set-AzureRmVmssRollingUpgradePolicy
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-MaxBatchInstancePercent] <Int32>]
   [[-MaxUnhealthyInstancePercent] <Int32>]
   [[-MaxUnhealthyUpgradedInstancePercent] <Int32>]
   [-PauseTimeBetweenBatches <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

设置 VMSS 滚动升级策略属性。

示例

示例 1

PS C:\> Set-AzureRmVmssRollingUpgradePolicy -VirtualMachineScaleSet $vmss -VirtualMachineScaleSet $vmss -MaxBatchInstancePercent 40 -MaxUnhealthyInstancePercent 35 -MaxUnhealthyUpgradedInstancePercent 30 -PauseTimeBetweenBatches "PT30S"

此命令为 MaxBatchInstance 设置 40%,MaxUnhealthyInstance 为 35%,MaxUnhealthyUpgradedInstance 为 30%,VMSS 本地对象$vmss的批处理之间的暂停时间为 30%。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MaxBatchInstancePercent

一批滚动升级同时升级的总虚拟机实例的最大百分比。 由于这是一个最大值,因此以前的或将来的批中的不正常实例可能会导致批处理中的实例百分比降低,以确保更高的可靠性。 如果未指定该值,则该值设置为 20。

类型:Int32
Position:1
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-MaxUnhealthyInstancePercent

规模集中虚拟机实例总数的最大百分比,这些实例可能是由于升级而同时运行不正常的,或者在滚动升级中止之前,虚拟机运行状况检查处于不正常状态。 在启动任何批处理之前,将检查此约束。 如果未指定该值,则该值设置为 20。

类型:Int32
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-MaxUnhealthyUpgradedInstancePercent

可发现处于不正常状态的已升级虚拟机实例的最大百分比。 升级每个批处理后,将发生此检查。 如果超过此百分比,滚动更新将中止。 如果未指定该值,则该值设置为 20。

类型:Int32
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PauseTimeBetweenBatches

完成一批中所有虚拟机的更新和开始下一批之间的等待时间。 持续时间应采用 ISO 8601 格式指定。 默认值为 0 秒(PT0S)。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-VirtualMachineScaleSet

指定 VMSS 对象。 可以使用 New-AzureRmVmssConfig cmdlet 创建对象。

类型:PSVirtualMachineScaleSet
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

PSVirtualMachineScaleSet

Int32

String

输出

PSVirtualMachineScaleSet