Update-AzVmss

语法

DefaultParameter （默认值）

Update-AzVmss
    [-ResourceGroupName] <String>
    [-VMScaleSetName] <String>
    [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
    [-AutomaticOSUpgrade <Boolean>]
    [-AutomaticRepairGracePeriod <String>]
    [-EnableAutomaticRepair <Boolean>]
    [-AutomaticRepairAction <String>]
    [-BootDiagnosticsEnabled <Boolean>]
    [-BootDiagnosticsStorageUri <String>]
    [-CustomData <String>]
    [-DisableAutoRollback <Boolean>]
    [-DisablePasswordAuthentication <Boolean>]
    [-EnableAutomaticUpdate <Boolean>]
    [-ImageReferenceId <String>]
    [-ImageReferenceOffer <String>]
    [-ImageReferencePublisher <String>]
    [-ImageReferenceSku <String>]
    [-ImageReferenceVersion <String>]
    [-ImageUri <String>]
    [-LicenseType <String>]
    [-ManagedDiskStorageAccountType <String>]
    [-MaxBatchInstancePercent <Int32>]
    [-MaxPrice <Double>]
    [-MaxUnhealthyInstancePercent <Int32>]
    [-MaxUnhealthyUpgradedInstancePercent <Int32>]
    [-OsDiskCaching <CachingTypes>]
    [-OsDiskWriteAccelerator <Boolean>]
    [-Overprovision <Boolean>]
    [-ScaleInPolicyForceDeletion <Boolean>]
    [-PauseTimeBetweenBatches <String>]
    [-PlanName <String>]
    [-PlanProduct <String>]
    [-PlanPromotionCode <String>]
    [-PlanPublisher <String>]
    [-ProvisionVMAgent <Boolean>]
    [-ProximityPlacementGroupId <String>]
    [-ScaleInPolicy <String[]>]
    [-SinglePlacementGroup <Boolean>]
    [-SkipExtensionsOnOverprovisionedVMs <Boolean>]
    [-SkuCapacity <Int32>]
    [-SkuName <String>]
    [-SkuTier <String>]
    [-Tag <Hashtable>]
    [-TerminateScheduledEventNotBeforeTimeoutInMinutes <Int32>]
    [-TerminateScheduledEvents <Boolean>]
    [-TimeZone <String>]
    [-UltraSSDEnabled <Boolean>]
    [-UpgradePolicyMode <UpgradeMode>]
    [-CapacityReservationGroupId <String>]
    [-VhdContainer <String[]>]
    [-AsJob]
    [-EncryptionAtHost <Boolean>]
    [-UserData <String>]
    [-BaseRegularPriorityCount <Int32>]
    [-RegularPriorityPercentage <Int32>]
    [-SharedGalleryImageId <String>]
    [-OSImageScheduledEventEnabled]
    [-OSImageScheduledEventNotBeforeTimeoutInMinutes <String>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-SkuProfileVmSize <String[]>]
    [-SkuProfileAllocationStrategy <String>]
    [-EnableResilientVMCreate <Boolean>]
    [-EnableResilientVMDelete <Boolean>]
    [-EnableAutomaticZoneRebalance <Boolean>]
    [-AutomaticZoneRebalanceStrategy <String>]
    [-AutomaticZoneRebalanceBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExplicitIdentityParameterSet

Update-AzVmss
    [-ResourceGroupName] <String>
    [-VMScaleSetName] <String>
    [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
    -IdentityType <ResourceIdentityType>
    [-AutomaticOSUpgrade <Boolean>]
    [-AutomaticRepairGracePeriod <String>]
    [-EnableAutomaticRepair <Boolean>]
    [-AutomaticRepairAction <String>]
    [-BootDiagnosticsEnabled <Boolean>]
    [-BootDiagnosticsStorageUri <String>]
    [-CustomData <String>]
    [-DisableAutoRollback <Boolean>]
    [-DisablePasswordAuthentication <Boolean>]
    [-EnableAutomaticUpdate <Boolean>]
    [-IdentityId <String[]>]
    [-ImageReferenceId <String>]
    [-ImageReferenceOffer <String>]
    [-ImageReferencePublisher <String>]
    [-ImageReferenceSku <String>]
    [-ImageReferenceVersion <String>]
    [-ImageUri <String>]
    [-LicenseType <String>]
    [-ManagedDiskStorageAccountType <String>]
    [-MaxBatchInstancePercent <Int32>]
    [-MaxPrice <Double>]
    [-MaxUnhealthyInstancePercent <Int32>]
    [-MaxUnhealthyUpgradedInstancePercent <Int32>]
    [-OsDiskCaching <CachingTypes>]
    [-OsDiskWriteAccelerator <Boolean>]
    [-Overprovision <Boolean>]
    [-ScaleInPolicyForceDeletion <Boolean>]
    [-PauseTimeBetweenBatches <String>]
    [-PlanName <String>]
    [-PlanProduct <String>]
    [-PlanPromotionCode <String>]
    [-PlanPublisher <String>]
    [-ProvisionVMAgent <Boolean>]
    [-ProximityPlacementGroupId <String>]
    [-ScaleInPolicy <String[]>]
    [-SinglePlacementGroup <Boolean>]
    [-SkipExtensionsOnOverprovisionedVMs <Boolean>]
    [-SkuCapacity <Int32>]
    [-SkuName <String>]
    [-SkuTier <String>]
    [-Tag <Hashtable>]
    [-TerminateScheduledEventNotBeforeTimeoutInMinutes <Int32>]
    [-TerminateScheduledEvents <Boolean>]
    [-TimeZone <String>]
    [-UltraSSDEnabled <Boolean>]
    [-UpgradePolicyMode <UpgradeMode>]
    [-CapacityReservationGroupId <String>]
    [-VhdContainer <String[]>]
    [-AsJob]
    [-EncryptionAtHost <Boolean>]
    [-UserData <String>]
    [-BaseRegularPriorityCount <Int32>]
    [-RegularPriorityPercentage <Int32>]
    [-SharedGalleryImageId <String>]
    [-OSImageScheduledEventEnabled]
    [-OSImageScheduledEventNotBeforeTimeoutInMinutes <String>]
    [-SecurityType <String>]
    [-EnableVtpm <Boolean>]
    [-EnableSecureBoot <Boolean>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-SkuProfileVmSize <String[]>]
    [-SkuProfileAllocationStrategy <String>]
    [-EnableResilientVMCreate <Boolean>]
    [-EnableResilientVMDelete <Boolean>]
    [-EnableAutomaticZoneRebalance <Boolean>]
    [-AutomaticZoneRebalanceStrategy <String>]
    [-AutomaticZoneRebalanceBehavior <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

示例

示例 1：将 VMSS 的状态更新为本地 VMSS 对象的状态。

Update-AzVmss -ResourceGroupName "Group001" -Name "VMSS001" -VirtualMachineScaleSet $LocalVMSS

示例 2

Update-AzVmss -ResourceGroupName 'Group001' -VMScaleSetName 'VMSS001' -VirtualMachineScaleSet <PSVirtualMachineScaleSet> -IdentityType SystemAssigned

参数

-AsJob

在后台运行 cmdlet 并返回作业以跟踪进度。

参数属性

参数集

-AutomaticOSUpgrade

设置当较新版本的映像可用时，是否应以滚动方式自动将 OS 升级应用于规模集实例。

参数属性

参数集

-AutomaticRepairAction

用于修复规模集中运行不正常的虚拟机的修复操作类型（替换、重启、重置映像）。 默认值将被替换。

参数属性

参数集

-AutomaticRepairGracePeriod

由于 VM 上的状态更改，自动修复暂停的时间。 状态更改完成后的宽限时间开始。 这有助于避免过早或意外修复。 持续时间应采用 ISO 8601 格式指定。 允许的最小宽限期为 30 分钟（PT30M），这也是默认值。 允许的最大宽限期为 90 分钟（PT90M）。

参数属性

参数集

-AutomaticZoneRebalanceBehavior

指定自动区域重新平衡的行为。

参数属性

参数集

-AutomaticZoneRebalanceStrategy

指定自动区域重新平衡的策略。

参数属性

参数集

-BaseRegularPriorityCount

指定 VMSS Flex 实例横向扩展时必须具有常规优先级的最小 VM 数。此参数仅适用于具有灵活 OrchestrationMode 的 VMSS 实例。

参数属性

参数集

-BootDiagnosticsEnabled

是否应在虚拟机规模集上启用启动诊断。

参数属性

参数集

-BootDiagnosticsStorageUri

用于放置控制台输出和屏幕截图的存储帐户的 URI。

参数属性

参数集

-CapacityReservationGroupId

用于分配的容量预留组的 ID。

参数属性

参数集

-Confirm

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

参数属性

参数集

-CustomData

指定自定义数据的 base-64 编码字符串。 这已解码为作为虚拟机上的文件保存的二进制数组。 二进制数组的最大长度为 65535 字节。
有关为 VM 使用 cloud-init，请参阅 使用 cloud-init 在创建期间自定义 Linux VM。

参数属性

参数集

-DefaultProfile

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

参数属性

参数集

-DisableAutoRollback

禁用自动 OS 升级策略的自动回滚

参数属性

参数集

-DisablePasswordAuthentication

指示此 cmdlet 禁用 Linux OS 的密码身份验证。

参数属性

参数集

-EnableAutomaticRepair

启用或禁用虚拟机规模集上的自动修复。

参数属性

参数集

-EnableAutomaticUpdate

指示是否为 VMSS 中的 Windows 虚拟机启用了自动更新。

参数属性

参数集

-EnableAutomaticZoneRebalance

指定是否应在虚拟机规模集上启用自动区域重新平衡。 默认值为 false。

参数属性

参数集

-EnableResilientVMCreate

指定是否应在虚拟机规模集上启用可复原的 VM 创建。 默认值为 false。

参数属性

参数集

-EnableResilientVMDelete

指定是否应在虚拟机规模集上启用可复原的 VM 删除。 默认值为 false。

参数属性

参数集

-EnableSecureBoot

指定是否应在虚拟机上启用安全启动。

参数属性

参数集

-EnableVtpm

指定是否应在虚拟机上启用 vTPM。

参数属性

参数集

-EncryptionAtHost

用户可以在请求中使用此参数来启用或禁用虚拟机规模集的主机加密。

参数属性

参数集

-IdentityId

指定与虚拟机规模集关联的用户标识列表。 用户标识引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}”

参数属性

参数集

-IdentityType

指定用于虚拟机规模集的标识类型。 类型“SystemAssignedUserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将从虚拟机规模集中删除任何标识。 此参数的可接受值为：

• SystemAssigned
• UserAssigned
• SystemAssignedUserAssigned
• 没有

参数属性

参数集

-IfMatch

用于为 PUT 和其他非安全方法发出请求条件。 仅当资源与列出的 ETag 值之一匹配时，服务器才会返回请求的资源。 省略此值以始终覆盖当前资源。 指定最后一次看到的 ETag 值，以防止意外覆盖并发更改。

参数属性

参数集

-IfNoneMatch

用于为 GET 和 HEAD 方法发出请求条件。 仅当列出的 ETag 值与当前实体匹配时，服务器才会返回请求的资源。 用于为 GET 和 HEAD 方法发出请求条件。 仅当列出的 ETag 值与当前实体匹配时，服务器才会返回请求的资源。 设置为“*”以允许创建新记录集，但要防止更新现有记录集。 其他值将导致服务器出错，因为它们不受支持。

参数属性

参数集

-ImageReferenceId

指定图像引用 ID。

参数属性

参数集

-ImageReferenceOffer

指定虚拟机映像（VMImage）产品/服务的类型。 若要获取映像产品/服务，请使用 Get-AzVMImageOffer cmdlet。

参数属性

参数集

-ImageReferencePublisher

指定 VMImage 的发布者的名称。 若要获取发布者，请使用 Get-AzVMImagePublisher cmdlet。

参数属性

参数集

-ImageReferenceSku

指定 VMImage SKU。 若要获取 SKU，请使用 Get-AzVMImageSku cmdlet。

参数属性

参数集

-ImageReferenceVersion

指定 VMImage 的版本。 若要使用最新版本，请指定最新版本而不是特定版本的值。

参数属性

参数集

-ImageUri

指定用户映像的 Blob URI。 VMSS 在用户映像的同一容器中创建操作系统磁盘。

参数属性

参数集

-LicenseType

指定用于自带许可证方案的许可证类型。

参数属性

参数集

-ManagedDiskStorageAccountType

指定托管磁盘的存储帐户类型。 此参数的可接受值为：

• Standard_LRS
• Premium_LRS

参数属性

参数集

-MaxBatchInstancePercent

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

参数属性

参数集

-MaxPrice

指定愿意为低优先级 VM/VMSS 付费的最高价格。 这个价格是美元。 此价格将与 VM 大小的当前低优先级价格进行比较。 此外，在创建/更新低优先级 VM/VMSS 时会比较价格，只有在 maxPrice 大于当前低优先级价格时，该操作才会成功。 如果当前低优先级价格超出创建 VM/VMSS 后 maxPrice，maxPrice 还用于逐出低优先级 VM/VMSS。 可能的值为：任何大于零的十进制值。 示例：0.01538。 -1 表示不应出于价格原因逐出低优先级 VM/VMSS。 此外，如果默认的最大价格不是由你提供，则为 -1。

参数属性

参数集

-MaxUnhealthyInstancePercent

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

参数属性

参数集

-MaxUnhealthyUpgradedInstancePercent

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

参数属性

参数集

-OsDiskCaching

指定操作系统磁盘的缓存模式。 此参数的可接受值为：

• 没有
• ReadOnly
• ReadWrite 默认值为 ReadWrite。 如果更改缓存值，cmdlet 将重启虚拟机。 此设置会影响磁盘的一致性和性能。

参数属性

参数集

-OsDiskWriteAccelerator

指定是否应在 OS 磁盘上启用或禁用 WriteAccelerator。

参数属性

参数集

-OSImageScheduledEventEnabled

指定是启用或禁用 OS 映像计划事件。

参数属性

参数集

-OSImageScheduledEventNotBeforeTimeoutInMinutes

虚拟机重新映像或升级其 OS 的时间长度将不得不在事件自动批准（超时）之前批准 OS 映像计划事件。 配置以 ISO 8601 格式指定，值设置为 15 分钟（PT15M）。

参数属性

参数集

-Overprovision

指示 cmdlet 是否过度预配 VMSS。

参数属性

参数集

-PauseTimeBetweenBatches

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

参数属性

参数集

-PlanName

指定计划名称。

参数属性

参数集

-PlanProduct

指定计划产品。

参数属性

参数集

-PlanPromotionCode

指定计划升级代码。

参数属性

参数集

-PlanPublisher

指定计划发布者。

参数属性

参数集

-ProvisionVMAgent

指示是否应在 VMSS 中的 Windows 虚拟机上预配虚拟机代理。

参数属性

参数集

-ProximityPlacementGroupId

要用于此规模集的邻近放置组的资源 ID。

参数属性

参数集

-RegularPriorityPercentage

指定满足 BaseRegularCount 后所需的 VM 百分比，其优先级为常规优先级，因为 VMSS Flex 实例横向扩展。此属性仅适用于具有灵活 OrchestrationMode 的 VMSS 实例。

参数属性

参数集

-ResourceGroupName

指定 VMSS 所属的资源组的名称。

参数属性

参数集

-ScaleInPolicy

在虚拟机规模集中进行缩放时要遵循的规则。 可能的值为：“Default”、“OldestVM”和“NewestVM”。 如果虚拟机规模集是区域性规模集，则规模集将首先在区域之间均衡。如果规模集是区域性规模集，则规模集将首先均衡。 然后，它将尽可能跨容错域进行均衡。 在每个容错域中，选择删除的虚拟机将是不受横向扩展保护的最新虚拟机。 当虚拟机规模集正在扩展时，将选择不受横向缩减保护的最早虚拟机，以便删除。 对于区域虚拟机规模集，规模集将首先跨区域均衡。 在每个区域中，将选择不受保护的最早虚拟机进行删除。 当虚拟机规模集正在扩展时，将选择不受横向缩减保护的最新虚拟机，以便删除。 对于区域虚拟机规模集，规模集将首先跨区域均衡。 在每个区域中，将选择不受保护的最新虚拟机进行删除。

参数属性

参数集

-ScaleInPolicyForceDeletion

使用 ScaleIn 策略时应用强制删除。

参数属性

参数集

-SecurityType

指定虚拟机的 SecurityType。 必须将其设置为任何指定值才能启用 UefiSettings。 除非设置了此属性，否则不会启用 UefiSettings。

参数属性

参数集

-SharedGalleryImageId

为 vm 部署指定共享库映像唯一 ID。 这可以从共享库映像 GET 调用中提取。

参数属性

参数集

-SinglePlacementGroup

指定单个放置组。

参数属性

参数集

-SkipExtensionsOnOverprovisionedVMs

指定扩展不会在额外的过度预配的 VM 上运行。

参数属性

参数集

-SkuCapacity

指定 VMSS 中的实例数。

参数属性

参数集

-SkuName

指定 VMSS 的所有实例的大小。

参数属性

参数集

-SkuProfileAllocationStrategy

SKU 配置文件的分配策略。

参数属性

参数集

-SkuProfileVmSize

规模集的 VM 大小的数组。

参数属性

参数集

-SkuTier

指定 VMSS 的层。 此参数的可接受值为：

• 标准
• 基本

参数属性

参数集

-Tag

以哈希表的形式进行键值对。 例如：@{key0=“value0”;key1=$null;key2=“value2”}

参数属性

参数集

-TerminateScheduledEventNotBeforeTimeoutInMinutes

要删除的虚拟机的可配置时间长度（以分钟为单位），在自动批准事件（超时）之前，必须批准终止计划事件。

参数属性

参数集

-TerminateScheduledEvents

指定是启用或禁用终止计划事件。

参数属性

参数集

-TimeZone

指定 Windows OS 的时区，例如“太平洋标准时间”。
可能的值可以从 TimeZoneInfo.GetSystemTimeZones返回的时区 TimeZoneInfo.Id 值。

参数属性

参数集

-UltraSSDEnabled

启用或禁用在虚拟机规模集上具有一个或多个具有UltraSSD_LRS存储帐户类型的托管数据磁盘的功能的标志。 仅当启用此属性时，才能将存储帐户类型UltraSSD_LRS的托管磁盘添加到 VMSS。

参数属性

参数集

-UpgradePolicyMode

指定了升级到规模集中虚拟机的模式。 此参数的可接受值为：

• 自动
• 手动
• 滚动

参数属性

参数集

-UserData

Vmss 的 UserData（将进行 base-64 编码）。 客户不应在此处传递任何机密。

参数属性

参数集

-VhdContainer

指定用于存储 VMSS 操作系统磁盘的容器 URL。

参数属性

参数集

-VirtualMachineScaleSet

指定本地 VMSS 对象。 若要获取 VMSS 对象，请使用 Get-AzVmss cmdlet。 此虚拟机对象包含 VMSS 的更新状态。

参数属性

参数集

-VMScaleSetName

指定此 cmdlet 创建的 VMSS 的名称。

参数属性

参数集

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

参数集

CommonParameters

输入

String

PSVirtualMachineScaleSet

Boolean

输出

PSVirtualMachineScaleSet

相关链接

• Get-AzVmss
• New-AzVmss
• Remove-AzVmss
• Restart-AzVmss
• Set-AzVmss
• Start-AzVmss
• Stop-AzVmss