Update-AzureRmVmss

Ссылка

Модуль:: AzureRM.Compute

Обновляет состояние VMSS.

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

Update-AzureRmVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-ImageReferenceSku <String>]
      [-ManagedDiskStorageAccountType <String>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-Overprovision <Boolean>]
      [-MaxBatchInstancePercent <Int32>]
      [-TimeZone <String>]
      [-BootDiagnosticsStorageUri <String>]
      [-AutomaticOSUpgrade <Boolean>]
      [-DisableAutoRollback <Boolean>]
      [-SinglePlacementGroup <Boolean>]
      [-CustomData <String>]
      [-UpgradePolicyMode <UpgradeMode>]
      [-ImageReferenceId <String>]
      [-DisablePasswordAuthentication <Boolean>]
      [-Tag <Hashtable>]
      [-PlanName <String>]
      [-MaxUnhealthyUpgradedInstancePercent <Int32>]
      [-ImageReferencePublisher <String>]
      [-PlanProduct <String>]
      [-VhdContainer <String[]>]
      [-ImageUri <String>]
      [-SkuTier <String>]
      [-EnableAutomaticUpdate <Boolean>]
      [-LicenseType <String>]
      [-SkuName <String>]
      [-PlanPromotionCode <String>]
      [-MaxUnhealthyInstancePercent <Int32>]
      [-SkuCapacity <Int32>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-ImageReferenceOffer <String>]
      [-PauseTimeBetweenBatches <String>]
      [-OsDiskCaching <CachingTypes>]
      [-ImageReferenceVersion <String>]
      [-UltraSSDEnabled <Boolean>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-ImageReferenceSku <String>]
      [-IdentityId <String[]>]
      [-ManagedDiskStorageAccountType <String>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-Overprovision <Boolean>]
      [-MaxBatchInstancePercent <Int32>]
      [-TimeZone <String>]
      [-BootDiagnosticsStorageUri <String>]
      [-AutomaticOSUpgrade <Boolean>]
      [-DisableAutoRollback <Boolean>]
      [-SinglePlacementGroup <Boolean>]
      [-CustomData <String>]
      [-UpgradePolicyMode <UpgradeMode>]
      [-ImageReferenceId <String>]
      [-DisablePasswordAuthentication <Boolean>]
      [-Tag <Hashtable>]
      [-PlanName <String>]
      [-MaxUnhealthyUpgradedInstancePercent <Int32>]
      [-ImageReferencePublisher <String>]
      [-PlanProduct <String>]
      [-VhdContainer <String[]>]
      [-ImageUri <String>]
      [-SkuTier <String>]
      [-EnableAutomaticUpdate <Boolean>]
      [-LicenseType <String>]
      -IdentityType <ResourceIdentityType>
      [-SkuName <String>]
      [-PlanPromotionCode <String>]
      [-MaxUnhealthyInstancePercent <Int32>]
      [-SkuCapacity <Int32>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-ImageReferenceOffer <String>]
      [-PauseTimeBetweenBatches <String>]
      [-OsDiskCaching <CachingTypes>]
      [-ImageReferenceVersion <String>]
      [-UltraSSDEnabled <Boolean>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Update-AzureRmVmss обновляет состояние масштабируемого набора виртуальных машин (VMSS) до состояния локального объекта VMSS.

Примеры

Пример 1. Обновление состояния VMSS до состояния локального объекта VMSS.

PS C:\> Update-AzureRmVmss -ResourceGroupName "Group001" -Name "VMSS001" -VirtualMachineScaleSet $LocalVMSS

Эта команда обновляет состояние vmSS с именем VMSS001, которая принадлежит группе ресурсов с именем Group001, к состоянию локального объекта VMSS, $LocalVMSS.

Параметры

-AsJob

Запустите командлет в фоновом режиме и верните задание для отслеживания хода выполнения.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AutomaticOSUpgrade

Задает, следует ли автоматически применять обновления ОС к экземплярам масштабируемого набора в последовательном режиме, когда становится доступной более новая версия образа.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BootDiagnosticsEnabled

Следует ли включить диагностика загрузки в масштабируемом наборе виртуальных машин.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-BootDiagnosticsStorageUri

URI учетной записи хранения, используемой для размещения выходных данных консоли и снимка экрана.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CustomData

Задает строку в кодировке base-64 пользовательских данных. Это декодируется в двоичный массив, сохраненный в виде файла на виртуальной машине. Максимальная длина двоичного массива составляет 65535 байтов.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableAutoRollback

Отключение автоматического отката для политики автоматического обновления ОС

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisablePasswordAuthentication

Указывает, что этот командлет отключает проверку подлинности паролей для ОС Linux.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EnableAutomaticUpdate

Указывает, включены ли виртуальные машины Windows в VMSS для автоматического обновления.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IdentityId

Указывает список удостоверений пользователей, связанных с масштабируемым набором виртуальных машин. Ссылки на удостоверения пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identityes/{identityName}"

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IdentityType

Указывает тип удостоверения, используемого для масштабируемого набора виртуальных машин. Тип SystemAssignedUserAssignedAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" приведет к удалению удостоверений из масштабируемого набора виртуальных машин. Допустимые значения для этого параметра:

SystemAssigned
UserAssigned
SystemAssignedUserAssigned
нет

Тип:	Nullable<T>[ResourceIdentityType]
Допустимые значения:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageReferenceId

Указывает идентификатор ссылки на изображение.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageReferenceOffer

Указывает тип предложения образа виртуальной машины (VMImage). Чтобы получить предложение изображения, используйте командлет Get-AzureRmVMImageOffer.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageReferencePublisher

Указывает имя издателя виртуальной машиныImage. Чтобы получить издателя, используйте командлет Get-AzureRmVMImagePublisher.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageReferenceSku

Указывает номер SKU VMImage. Чтобы получить номера SKU, используйте командлет Get-AzureRmVMImageSku.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageReferenceVersion

Указывает версию VMImage. Чтобы использовать последнюю версию, укажите значение последней вместо конкретной версии.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ImageUri

Задает универсальный код ресурса (URI) БОЛЬШОго двоичного объекта для пользовательского образа. VMSS создает диск операционной системы в том же контейнере пользовательского образа.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-LicenseType

Укажите тип лицензии, который предназначен для создания собственного сценария лицензии.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ManagedDiskStorageAccountType

Указывает тип учетной записи хранения для управляемого диска. Допустимые значения для этого параметра:

StandardLRS
PremiumLRS

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaxBatchInstancePercent

Максимальный процент общих экземпляров виртуальных машин, которые будут обновляться одновременно путем последовательного обновления в одном пакете. Так как это максимальный, неработоспособные экземпляры в предыдущих или будущих пакетах могут привести к снижению процента экземпляров в пакете, чтобы обеспечить более высокую надежность. Если значение не указано, оно имеет значение 20.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaxUnhealthyInstancePercent

Максимальный процент всех экземпляров виртуальных машин в масштабируемом наборе, которые могут быть одновременно неработоспособными, либо в результате обновления, либо путем обнаружения в неработоспособном состоянии проверки работоспособности виртуальной машины до завершения последовательного обновления. Это ограничение будет проверено перед запуском любого пакета. Если значение не указано, оно имеет значение 20.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaxUnhealthyUpgradedInstancePercent

Максимальный процент обновленных экземпляров виртуальных машин, которые можно найти в неработоспособном состоянии. Эта проверка произойдет после обновления каждого пакета. Если этот процент когда-либо превышается, последовательное обновление прерывается. Если значение не указано, оно имеет значение 20.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OsDiskCaching

Задает режим кэширования диска операционной системы. Допустимые значения для этого параметра:

нет
ReadOnly
ReadWrite Значение по умолчанию — ReadWrite. При изменении значения кэширования командлет перезагрузит виртуальную машину. Этот параметр влияет на согласованность и производительность диска.

Тип:	CachingTypes
Допустимые значения:	None, ReadOnly, ReadWrite
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OsDiskWriteAccelerator

Указывает, следует ли включить или отключить WriteAccelerator на диске ОС.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Overprovision

Указывает, перепроектирует ли командлет VMSS.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PauseTimeBetweenBatches

Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601. Значение по умолчанию — 0 секунд (PT0S).

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PlanName

Указывает имя плана.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PlanProduct

Указывает продукт плана.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PlanPromotionCode

Задает код продвижения плана.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PlanPublisher

Указывает издателя плана.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProvisionVMAgent

Указывает, следует ли подготовить агент виртуальной машины на виртуальных машинах Windows в VMSS.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ResourceGroupName

Указывает имя группы ресурсов, к которой принадлежит VMSS.

Тип:	String
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SinglePlacementGroup

Указывает одну группу размещения.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkuCapacity

Указывает количество экземпляров в VMSS.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkuName

Задает размер всех экземпляров VMSS.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkuTier

Указывает уровень VMSS. Допустимые значения для этого параметра:

Стандартные
Базовая

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}

Тип:	Hashtable
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-TimeZone

Указывает часовой пояс для ОС Windows.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UltraSSDEnabled

Флаг, который включает или отключает возможность иметь один или несколько управляемых дисков данных с типом учетной записи хранения UltraSSD_LRS в масштабируемом наборе виртуальных машин. Управляемые диски с типом учетной записи хранения UltraSSD_LRS можно добавить в VMSS только в том случае, если это свойство включено.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-UpgradePolicyMode

Укажите режим обновления до виртуальных машин в масштабируемом наборе. Допустимые значения для этого параметра:

Автоматически
Руководство
Скользящий

Тип:	UpgradeMode
Допустимые значения:	Automatic, Manual, Rolling
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VhdContainer

Указывает URL-адреса контейнера, используемые для хранения дисков операционной системы для VMSS.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VirtualMachineScaleSet

Указывает локальный объект VMSS. Чтобы получить объект VMSS, используйте командлет Get-AzureRmVmss. Этот объект виртуальной машины содержит обновленное состояние для VMSS.

Тип:	PSVirtualMachineScaleSet
Position:	3
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-VMScaleSetName

Указывает имя виртуальной машины, создаваемой этим командлетом.

Тип:	String
Aliases:	Name
Position:	2
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

String

PSVirtualMachineScaleSet

Параметры: VirtualMachineScaleSet (ByValue)

Выходные данные