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

Update-AzVmss

模块:

Az.Compute

汇报 VMSS 的状态。

语法

Update-AzVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-AutomaticOSUpgrade <Boolean>]
      [-AutomaticRepairGracePeriod <String>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-BootDiagnosticsStorageUri <String>]
      [-CustomData <String>]
      [-DisableAutoRollback <Boolean>]
      [-DisablePasswordAuthentication <Boolean>]
      [-EnableAutomaticRepair <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>]
      [-AutomaticRepairAction <String>]
      [-BaseRegularPriorityCount <Int32>]
      [-RegularPriorityPercentage <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-AutomaticOSUpgrade <Boolean>]
      [-AutomaticRepairGracePeriod <String>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-BootDiagnosticsStorageUri <String>]
      [-CustomData <String>]
      [-DisableAutoRollback <Boolean>]
      [-DisablePasswordAuthentication <Boolean>]
      [-EnableAutomaticRepair <Boolean>]
      [-EnableAutomaticUpdate <Boolean>]
      [-IdentityId <String[]>]
      -IdentityType <ResourceIdentityType>
      [-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>]
      [-AutomaticRepairAction <String>]
      [-BaseRegularPriorityCount <Int32>]
      [-RegularPriorityPercentage <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Update-AzVmss cmdlet 将虚拟机规模集 (VMSS) 的状态更新为本地 VMSS 对象的状态。

示例

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

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

此命令将属于 Group001 资源组的名为 VMSS001 的 VMSS 的状态更新为本地 VMSS 对象的状态，$LocalVMSS。

示例 2

汇报 VMSS 的状态。 (自动生成的)

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

参数

-AsJob

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AutomaticOSUpgrade

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AutomaticRepairAction

修复操作的类型 (替换、重启、重置映像) ，这些操作将用于修复规模集中不正常的虚拟机。 默认值为 replace。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-AutomaticRepairGracePeriod

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BaseRegularPriorityCount

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-BootDiagnosticsEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BootDiagnosticsStorageUri

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CapacityReservationGroupId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomData

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAutoRollback

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisablePasswordAuthentication

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticRepair

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpdate

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionAtHost

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityId

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

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

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

• SystemAssigned
• UserAssigned
• SystemAssignedUserAssigned
• 无

Type:	Nullable<T>[ResourceIdentityType]
Accepted values:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceId

指定映像引用 ID。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceOffer

指定 vmImage) 套餐 (虚拟机映像的类型。 若要获取映像产品/服务，请使用 Get-AzVMImageOffer cmdlet。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferencePublisher

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceSku

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceVersion

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageUri

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseType

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ManagedDiskStorageAccountType

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

• Standard_LRS
• Premium_LRS

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxBatchInstancePercent

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxPrice

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

Type:	Double
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxUnhealthyInstancePercent

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxUnhealthyUpgradedInstancePercent

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OsDiskCaching

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

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

Type:	CachingTypes
Accepted values:	None, ReadOnly, ReadWrite
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OsDiskWriteAccelerator

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Overprovision

指示 cmdlet 是否过度预配 VMSS。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PauseTimeBetweenBatches

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanName

指定计划名称。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanProduct

指定计划产品。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanPromotionCode

指定计划升级代码。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanPublisher

指定计划发布者。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProvisionVMAgent

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProximityPlacementGroupId

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RegularPriorityPercentage

指定在满足 BaseRegularCount 后，在 VMSS Flex 实例横向扩展时具有常规优先级的 VM 的所需百分比。此属性仅对具有灵活 OrchestrationMode 的 VMSS 实例有效。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

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

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ScaleInPolicy

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

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScaleInPolicyForceDeletion

使用 ScaleIn Policy 时应用强制删除。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SinglePlacementGroup

指定单个放置组。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipExtensionsOnOverprovisionedVMs

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuCapacity

指定 VMSS 中的实例数。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuTier

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

• 标准
• 基本

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

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

Type:	Hashtable
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-TerminateScheduledEventNotBeforeTimeoutInMinutes

) 删除虚拟机的可配置 (时间长度（以分钟为单位）可能需要批准“终止计划事件”，然后才能自动批准该事件 () 超时。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-TerminateScheduledEvents

指定是启用或禁用 Terminate Scheduled 事件。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-TimeZone

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UltraSSDEnabled

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UpgradePolicyMode

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

• 自动
• 手动
• 滚动

Type:	UpgradeMode
Accepted values:	Automatic, Manual, Rolling
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserData

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VhdContainer

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

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VirtualMachineScaleSet

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

Type:	PSVirtualMachineScaleSet
Position:	2
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMScaleSetName

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

Type:	String
Aliases:	Name
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

String

PSVirtualMachineScaleSet

Boolean

输出

PSVirtualMachineScaleSet

相关链接

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