Update-AzVmss

모듈:: Az.Compute Module

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

구문

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>]

Description

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

예제

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

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

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

예제 2

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

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

매개 변수

-AsJob

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

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AutomaticOSUpgrade

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

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AutomaticRepairAction

확장 집합에서 비정상 가상 머신을 복구하는 데 사용할 복구 작업 유형(바꾸기, 다시 시작, 이미지 다시 이미지)입니다. 기본값은 replace입니다.

매개 변수 속성

형식:	String
Default value:	None
허용되는 값:	Replace, Restart, Reimage
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-AutomaticRepairGracePeriod

VM의 상태 변경으로 인해 자동 복구가 일시 중단되는 시간입니다. 상태 변경이 완료된 후 유예 시간이 시작됩니다. 이렇게 하면 조기 또는 우발적인 수리를 방지할 수 있습니다. 기간은 ISO 8601 형식으로 지정해야 합니다. 허용되는 최소 유예 기간은 기본값이기도 한 30분(PT30M)입니다. 허용되는 최대 유예 기간은 90분(PT90M)입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AutomaticZoneRebalanceBehavior

자동 영역 재균형에 대한 동작을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-AutomaticZoneRebalanceStrategy

자동 영역 재조정 전략을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-BaseRegularPriorityCount

VMSS Flex 인스턴스가 확장될 때 일반 우선 순위여야 하는 최소 VM 수를 지정합니다. 이 매개 변수는 유연한 OrchestrationMode를 사용하는 VMSS 인스턴스에만 유효합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-BootDiagnosticsEnabled

가상 머신 확장 집합에서 부팅 진단을 사용하도록 설정해야 하는지 여부입니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BootDiagnosticsStorageUri

콘솔 출력 및 스크린샷을 배치하는 데 사용할 스토리지 계정의 URI입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CapacityReservationGroupId

할당하는 데 사용되는 용량 예약 그룹의 ID입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Confirm

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CustomData

사용자 지정 데이터의 base-64로 인코딩된 문자열을 지정합니다. 가상 머신에 파일로 저장된 이진 배열로 디코딩됩니다. 이진 배열의 최대 길이는 65535바이트입니다.
VM 에 cloud-init를 사용하려면 cloud-init를 사용하여 만드는 동안 Linux VM을 사용자 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

매개 변수 속성

형식:	IAzureContextContainer
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DisableAutoRollback

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

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DisablePasswordAuthentication

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

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-EnableAutomaticRepair

가상 머신 확장 집합에서 자동 복구를 사용하거나 사용하지 않도록 설정합니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-EnableAutomaticUpdate

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

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-EnableAutomaticZoneRebalance

가상 머신 확장 집합에서 자동 영역 재균형을 사용하도록 설정할지 여부를 지정합니다. 기본값은 false입니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-EnableResilientVMCreate

가상 머신 확장 집합에서 복원력 있는 VM 만들기를 사용하도록 설정할지 여부를 지정합니다. 기본값은 false입니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-EnableResilientVMDelete

가상 머신 확장 집합에서 복원력 있는 VM 삭제를 사용하도록 설정할지 여부를 지정합니다. 기본값은 false입니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-EnableSecureBoot

가상 머신에서 보안 부팅을 사용하도록 설정할지 여부를 지정합니다.

매개 변수 속성

형식:	Nullable<T>[Boolean]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-EnableVtpm

가상 머신에서 vTPM을 사용하도록 설정할지 여부를 지정합니다.

매개 변수 속성

형식:	Nullable<T>[Boolean]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-EncryptionAtHost

이 매개 변수는 요청에서 사용자가 가상 머신 확장 집합에 대한 호스트 암호화를 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IdentityId

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

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ExplicitIdentityParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IdentityType

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

시스템 지정됨
UserAssigned
SystemAssignedUserAssigned
없음

매개 변수 속성

형식:	Nullable<T>[ResourceIdentityType]
Default value:	None
허용되는 값:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ExplicitIdentityParameterSet

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IfMatch

PUT 및 기타 안전하지 않은 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 서버는 리소스가 나열된 ETag 값 중 하나와 일치하는 경우에만 요청된 리소스를 반환합니다. 현재 리소스를 항상 덮어쓰려면 이 값을 생략합니다. 실수로 동시 변경 내용을 덮어쓰지 않도록 마지막으로 본 ETag 값을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-IfNoneMatch

GET 및 HEAD 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 나열된 ETag 값이 현재 엔터티와 일치하지 않는 경우에만 서버에서 요청된 리소스를 반환합니다. GET 및 HEAD 메서드에 대한 조건부 요청을 만드는 데 사용됩니다. 나열된 ETag 값이 현재 엔터티와 일치하지 않는 경우에만 서버에서 요청된 리소스를 반환합니다. 새 레코드 집합을 만들 수 있지만 기존 레코드 집합을 업데이트하지 않도록 하려면 '*'로 설정합니다. 다른 값은 지원되지 않으므로 서버에서 오류가 발생합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ImageReferenceId

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ImageReferenceOffer

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ImageReferencePublisher

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ImageReferenceSku

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ImageReferenceVersion

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ImageUri

사용자 이미지의 Blob URI를 지정합니다. VMSS는 사용자 이미지의 동일한 컨테이너에 운영 체제 디스크를 만듭니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-LicenseType

고유한 라이선스 시나리오를 가져오는 라이선스 유형을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ManagedDiskStorageAccountType

관리 디스크의 스토리지 계정 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

스탠다드_LRS
프리미엄_LRS

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxBatchInstancePercent

롤링 업그레이드를 통해 동시에 업그레이드될 총 가상 머신 인스턴스의 최대 백분율입니다. 이는 이전 또는 이후 일괄 처리의 최대 비정상 인스턴스이므로 더 높은 안정성을 보장하기 위해 일괄 처리의 인스턴스 비율이 감소할 수 있습니다. 값을 지정하지 않으면 20으로 설정됩니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxPrice

우선 순위가 낮은 VM/VMSS에 대해 지불할 최대 가격을 지정합니다. 이 가격은 미국 달러입니다. 이 가격은 VM 크기에 대한 현재 낮은 우선 순위 가격과 비교됩니다. 또한 낮은 우선 순위 VM/VMSS를 생성/업데이트할 때 가격을 비교하며 maxPrice가 현재 낮은 우선 순위 가격보다 큰 경우에만 작업이 성공합니다. 현재 낮은 우선 순위 가격이 VM/VMSS를 만든 후 maxPrice를 초과하는 경우 maxPrice는 우선 순위가 낮은 VM/VMSS를 제거하는 데도 사용됩니다. 가능한 값은 0보다 큰 10진수 값입니다. 예: 0.01538. -1은 가격상의 이유로 우선 순위가 낮은 VM/VMSS를 제거해서는 안 됨을 나타냅니다. 또한 기본 최대 가격은 사용자가 제공하지 않은 경우 -1.

매개 변수 속성

형식:	Double
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxUnhealthyInstancePercent

업그레이드의 결과로 또는 롤링 업그레이드가 중단되기 전에 가상 머신 상태 검사에서 비정상 상태로 발견되어 동시에 비정상 상태가 될 수 있는 확장 집합의 총 가상 머신 인스턴스의 최대 비율입니다. 이 제약 조건은 일괄 처리를 시작하기 전에 확인됩니다. 값을 지정하지 않으면 20으로 설정됩니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaxUnhealthyUpgradedInstancePercent

비정상 상태인 것으로 확인될 수 있는 업그레이드된 가상 머신 인스턴스의 최대 비율입니다. 이 검사는 각 일괄 처리가 업그레이드된 후에 수행됩니다. 이 비율을 초과하면 롤링 업데이트가 중단됩니다. 값을 지정하지 않으면 20으로 설정됩니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-OsDiskCaching

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

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

매개 변수 속성

형식:	CachingTypes
Default value:	None
허용되는 값:	None, ReadOnly, ReadWrite
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-OsDiskWriteAccelerator

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

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-OSImageScheduledEventEnabled

OS Image Scheduled 이벤트를 사용할지 여부를 지정합니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-OSImageScheduledEventNotBeforeTimeoutInMinutes

가상 머신이 이미지로 다시 설치되거나 OS를 업그레이드하는 기간은 이벤트가 자동으로 승인되기 전에 OS 이미지 예약 이벤트를 승인해야 합니다(시간 초과). 구성은 ISO 8601 형식으로 지정되며 값은 15분(PT15M)으로 설정됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Overprovision

cmdlet이 VMSS를 과도하게 프로비전하는지 여부를 나타냅니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PauseTimeBetweenBatches

모든 가상 머신에 대한 업데이트를 한 일괄 처리로 완료하고 다음 일괄 처리를 시작하는 것 사이의 대기 시간입니다. 기간은 ISO 8601 형식으로 지정해야 합니다. 기본값은 0초(PT0S)입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PlanName

계획 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PlanProduct

계획 제품을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PlanPromotionCode

계획 승격 코드를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PlanPublisher

계획 게시자를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ProvisionVMAgent

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

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ProximityPlacementGroupId

이 확장 집합에 사용할 근접 배치 그룹의 리소스 ID입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RegularPriorityPercentage

VMSS Flex 인스턴스가 확장될 때 기본 우선 순위인 BaseRegularCount가 충족된 후 원하는 VM 백분율을 지정합니다. 이 속성은 유연한 OrchestrationMode를 사용하는 VMSS 인스턴스에만 유효합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ResourceGroupName

VMSS가 속한 리소스 그룹의 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ScaleInPolicy

가상 머신 확장 집합을 스케일 인할 때 따라야 할 규칙입니다. 가능한 값은 'Default', 'OldestVM' 및 'NewestVM'입니다. 가상 머신 확장 집합이 확장되면 '기본값'은 영역 확장 집합인 경우 먼저 영역 간에 분산됩니다. 그런 다음 가능한 한 장애 도메인 간에 균형이 조정됩니다. 각 장애 도메인 내에서 제거를 위해 선택한 가상 머신은 규모 감축으로부터 보호되지 않는 최신 컴퓨터가 됩니다. 가상 머신 확장 집합이 확장될 때 'OldestVM'은 확장으로부터 보호되지 않는 가장 오래된 가상 머신을 제거하도록 선택됩니다. 영역 가상 머신 확장 집합의 경우 확장 집합은 먼저 영역 간에 균형을 이루게 됩니다. 각 영역 내에서 보호되지 않는 가장 오래된 가상 머신이 제거되도록 선택됩니다. 'NewestVM'은 가상 머신 확장 집합을 스케일 인할 때 확장으로부터 보호되지 않는 최신 가상 머신을 제거하도록 선택됩니다. 영역 가상 머신 확장 집합의 경우 확장 집합은 먼저 영역 간에 균형을 이루게 됩니다. 각 영역 내에서 보호되지 않는 최신 가상 머신이 제거를 위해 선택됩니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ScaleInPolicyForceDeletion

ScaleIn 정책을 사용할 때 강제 삭제 적용

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SecurityType

가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 이 속성을 설정하지 않으면 UefiSettings를 사용할 수 없습니다.

매개 변수 속성

형식:	String
Default value:	None
허용되는 값:	TrustedLaunch, ConfidentialVM, Standard
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-SharedGalleryImageId

vm 배포에 대한 공유 갤러리 이미지 고유 ID를 지정했습니다. 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SinglePlacementGroup

단일 배치 그룹을 지정합니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SkipExtensionsOnOverprovisionedVMs

확장이 과도하게 프로비전된 추가 VM에서 실행되지 않도록 지정합니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SkuCapacity

VMSS의 인스턴스 수를 지정합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SkuName

VMSS의 모든 인스턴스 크기를 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SkuProfileAllocationStrategy

SKU 프로필에 대한 할당 전략입니다.

매개 변수 속성

형식:	String
Default value:	None
허용되는 값:	LowestPrice, CapacityOptimized
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-SkuProfileVmSize

확장 집합에 대한 VM 크기의 배열입니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-SkuTier

VMSS 계층을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

스탠다드
기초

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Tag

해시 테이블 형식의 키-값 쌍입니다. 예: @{key0="value0"; key1=$null; key2="value2"}

매개 변수 속성

형식:	Hashtable
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-TerminateScheduledEventNotBeforeTimeoutInMinutes

가상 머신이 삭제되는 구성 가능한 시간(분)은 이벤트가 자동 승인(시간 초과)되기 전에 잠재적으로 Terminate Scheduled Event를 승인해야 합니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-TerminateScheduledEvents

Terminate Scheduled 이벤트를 사용할지 여부를 지정합니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-TimeZone

Windows OS의 표준 시간대(예: "태평양 표준시")를 지정합니다.
가능한 값은 TimeZoneInfo.GetSystemTimeZones반환된 표준 시간대의 값을 TimeZoneInfo.Id 수 있습니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UltraSSDEnabled

가상 머신 확장 집합에 UltraSSD_LRS 스토리지 계정 유형이 있는 하나 이상의 관리되는 데이터 디스크가 있는 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다. 스토리지 계정 유형이 UltraSSD_LRS 관리 디스크는 이 속성을 사용하는 경우에만 VMSS에 추가할 수 있습니다.

매개 변수 속성

형식:	Boolean
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-UpgradePolicyMode

확장 집합에서 가상 머신으로 업그레이드하는 모드를 지정했습니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

자동
설명서
롤링

매개 변수 속성

형식:	UpgradeMode
Default value:	None
허용되는 값:	Automatic, Manual, Rolling
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-UserData

Base-64로 인코딩되는 VM에 대한 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-VhdContainer

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

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-VirtualMachineScaleSet

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

매개 변수 속성

형식:	PSVirtualMachineScaleSet
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	2
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-VMScaleSetName

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	이름

매개 변수 집합

(All)

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

다음을 통해 공유

Update-AzVmss

구문

DefaultParameter (기본값)

ExplicitIdentityParameterSet

Description

예제

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

예제 2

매개 변수

-AsJob

매개 변수 속성

매개 변수 집합

-AutomaticOSUpgrade

매개 변수 속성

매개 변수 집합

-AutomaticRepairAction

매개 변수 속성

매개 변수 집합

-AutomaticRepairGracePeriod

매개 변수 속성

매개 변수 집합

-AutomaticZoneRebalanceBehavior

매개 변수 속성

매개 변수 집합

-AutomaticZoneRebalanceStrategy

매개 변수 속성

매개 변수 집합

-BaseRegularPriorityCount

매개 변수 속성

매개 변수 집합

-BootDiagnosticsEnabled

매개 변수 속성

매개 변수 집합

-BootDiagnosticsStorageUri

매개 변수 속성

매개 변수 집합

-CapacityReservationGroupId

매개 변수 속성

매개 변수 집합

-Confirm

매개 변수 속성

매개 변수 집합

-CustomData

매개 변수 속성

매개 변수 집합

-DefaultProfile

매개 변수 속성

매개 변수 집합

-DisableAutoRollback

매개 변수 속성

매개 변수 집합

-DisablePasswordAuthentication

매개 변수 속성

매개 변수 집합

-EnableAutomaticRepair

매개 변수 속성

매개 변수 집합

-EnableAutomaticUpdate

매개 변수 속성

매개 변수 집합

-EnableAutomaticZoneRebalance

매개 변수 속성

매개 변수 집합

-EnableResilientVMCreate

매개 변수 속성

매개 변수 집합

-EnableResilientVMDelete

매개 변수 속성

매개 변수 집합

-EnableSecureBoot

매개 변수 속성

매개 변수 집합

-EnableVtpm

매개 변수 속성

매개 변수 집합

-EncryptionAtHost

매개 변수 속성

매개 변수 집합

-IdentityId