Update-AzureRmVmss

모듈:

AzureRM.Compute

VMSS의 상태를 업데이트합니다.

Warning

AzureRM PowerShell 모듈은 2024년 2월 29일부터 공식적으로 사용되지 않습니다. 사용자는 지속적인 지원 및 업데이트를 보장하기 위해 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>]

Description

Update-AzureRmVmss cmdlet은 VMSS(Virtual Machine Scale Set)의 상태를 로컬 VMSS 개체의 상태로 업데이트합니다.

예제

예제 1: VMSS의 상태를 로컬 VMSS 개체의 상태로 업데이트합니다.

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

이 명령은 Group001이라는 리소스 그룹에 속한 VMSS001 명명된 VMSS의 상태를 $LocalVMSS 로컬 VMSS 개체의 상태로 업데이트합니다.

매개 변수

-AsJob

백그라운드에서 cmdlet을 실행하고 작업을 반환하여 진행률을 추적합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-AutomaticOSUpgrade

최신 버전의 이미지를 사용할 수 있게 되면 OS 업그레이드를 확장 집합 인스턴스에 자동으로 적용할지 여부를 롤링 방식으로 설정합니다.

형식:	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

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:	SwitchParameter
별칭:	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
별칭:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableAutoRollback

자동 OS 업그레이드 정책에 대한 자동 롤백 사용 안 함

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisablePasswordAuthentication

이 cmdlet은 Linux OS에 대한 암호 인증을 사용하지 않도록 설정함을 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableAutomaticUpdate

VMSS의 Windows 가상 머신을 자동 업데이트에 사용할 수 있는지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IdentityId

가상 머신 확장 집합과 연결된 사용자 ID 목록을 지정합니다. 사용자 ID 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}' 형식의 ARM 리소스 ID입니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-IdentityType

가상 머신 확장 집합에 사용되는 ID 유형을 지정합니다. 'SystemAssignedUserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신 확장 집합에서 모든 ID를 제거합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• SystemAssigned
• UserAssigned
• SystemAssignedUserAssigned
• None

형식:	Nullable<T>[ResourceIdentityType]
허용되는 값:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageReferenceId

이미지 참조 ID를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageReferenceOffer

VMImage(가상 머신 이미지) 제품의 유형을 지정합니다. 이미지 제품을 가져오려면 Get-AzureRmVMImageOffer cmdlet을 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageReferencePublisher

VMImage 게시자의 이름을 지정합니다. 게시자를 가져오려면 Get-AzureRmVMImagePublisher cmdlet을 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageReferenceSku

VMImage SKU를 지정합니다. SKU를 가져오려면 Get-AzureRmVMImageSku cmdlet을 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageReferenceVersion

VMImage의 버전을 지정합니다. 최신 버전을 사용하려면 특정 버전 대신 최신 값을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ImageUri

사용자 이미지의 Blob 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

운영 체제 디스크의 캐싱 모드를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• None
• ReadOnly
• ReadWrite 기본값은 ReadWrite입니다. 캐싱 값을 변경하면 cmdlet이 가상 머신을 다시 시작합니다. 이 설정은 디스크의 일관성 및 성능에 영향을 줍니다.

형식:	CachingTypes
허용되는 값:	None, ReadOnly, ReadWrite
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OsDiskWriteAccelerator

OS 디스크에서 WriteAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Overprovision

cmdlet이 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

VMSS의 Windows 가상 머신에서 가상 머신 에이전트를 프로비전해야 하는지 여부를 나타냅니다.

형식:	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 계층을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• Standard
• Basic

형식:	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 OS의 표준 시간대를 지정합니다.

형식:	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

VMSS에 대한 운영 체제 디스크를 저장하는 데 사용되는 컨테이너 URL을 지정합니다.

형식:	String[]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-VirtualMachineScaleSet

로컬 VMSS 개체를 지정합니다. VMSS 개체를 가져오려면 Get-AzureRmVmss cmdlet을 사용합니다. 이 가상 머신 개체는 VMSS에 대한 업데이트된 상태를 포함합니다.

형식:	PSVirtualMachineScaleSet
Position:	3
Default value:	None
필수:	False
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-VMScaleSetName

이 cmdlet에서 만드는 VMSS의 이름을 지정합니다.

형식:	String
별칭:	Name
Position:	2
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

PSVirtualMachineScaleSet

매개 변수: VirtualMachineScaleSet(ByValue)

출력

PSVirtualMachineScaleSet

관련 링크

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